Menu

Trigger trong PostgreSQL: CREATE TRIGGER và ví dụ

Trigger tự động chạy một hàm khi các hàng được chèn, cập nhật hoặc xóa. Trong PostgreSQL, bạn viết một hàm trigger trả về trigger, rồi gắn nó vào bảng bằng CREATE TRIGGER.

Trang này có trình soạn thảo chạy trực tiếp. Sửa, chạy và xem đầu ra ngay lập tức.

Trigger khiến PostgreSQL tự động gọi một hàm khi một bảng thay đổi. Hãy viết hàm trigger trước, khai báo RETURNS trigger, rồi gắn nó vào: CREATE TRIGGER name BEFORE UPDATE ON table FOR EACH ROW EXECUTE FUNCTION fn();. Cách dùng kinh điển là giữ cho cột updated_at luôn mới nhất:

Chỉ bài viết 1 được cập nhật, nên chỉ nó có timestamp. NEW là hàng sắp được ghi; một trigger BEFORE có thể thay đổi nó và phải trả nó về. Bạn có thể gắn cùng một hàm vào mọi bảng có cột updated_at.

BEFORE, AFTER và INSTEAD OF

Thời điểmChạy khi nàoCách dùng điển hình
BEFOREtrước khi hàng được ghithay đổi hoặc kiểm tra NEW, hoặc bỏ qua hàng
AFTERsau khi hàng được ghighi vào bảng khác: audit log, bộ đếm
INSTEAD OFthay cho thay đổi, chỉ trên viewcho phép ghi vào view

FOR EACH ROW chạy hàm một lần cho mỗi hàng bị ảnh hưởng. FOR EACH STATEMENT (mặc định) chạy một lần cho mỗi câu lệnh, kể cả khi không hàng nào thay đổi. Trong trigger cấp hàng, NEW chứa hàng mới (INSERT, UPDATE) và OLD chứa hàng trước đó (UPDATE, DELETE). TG_OP cho biết thao tác đã kích hoạt nó và TG_TABLE_NAME cho biết bảng.

Giá trị trả về của một trigger BEFORE cấp hàng quyết định điều gì xảy ra: trả về NEW (đã đổi hay chưa) để tiếp tục, hoặc NULL để bỏ qua hàng mà không báo lỗi. Giá trị trả về của trigger AFTER bị bỏ qua, nên theo quy ước nó trả về NULL.

Ghi audit log bằng trigger AFTER

Bảng audit ghi lại hai lần INSERT, một lần UPDATE từ 10 lên 12 và một lần DELETE sản phẩm có giá 20. OLD là NULL khi chèn và NEW là NULL khi xóa, vì vậy mới cần coalesce. Để lưu nguyên hàng, hãy đưa to_jsonb(OLD) và to_jsonb(NEW) vào một cột jsonb.

Chặn hoặc bỏ qua một thay đổi

Một trigger BEFORE có thể từ chối thay đổi bằng RAISE EXCEPTION, việc này hủy câu lệnh, hoặc bỏ qua một hàng bằng cách trả về NULL:

Lệnh DELETE đã xóa bản nháp và lặng lẽ giữ lại hóa đơn đã thanh toán. Một trigger BEFORE DELETE trả về OLD để cho phép việc xóa tiếp tục. Để cả câu lệnh thất bại thay vào đó, hãy thay RETURN NULL bằng RAISE EXCEPTION 'invoice % is paid', OLD.id;. Một lỗi dễ gỡ hơn nhiều so với một hàng lặng lẽ ở lại.

Chỉ kích hoạt khi một cột thay đổi

UPDATE OF column giới hạn trigger vào những lệnh cập nhật có đặt cột đó. Một điều kiện WHEN bỏ qua lời gọi hàm khi nó sai. IS DISTINCT FROM coi NULL là một giá trị, nên nó cũng bắt được thay đổi thành hoặc từ NULL:

Lần cập nhật đầu đặt cùng một giá, nên WHEN sai và bộ đếm vẫn là 0. Lần thứ hai đổi giá, và price_changed kết thúc ở 1.

Liệt kê, tắt và xóa trigger

-- triggers you created (excludes the ones behind foreign keys)
SELECT tgrelid::regclass AS table_name, tgname
FROM pg_trigger WHERE NOT tgisinternal;

ALTER TABLE products DISABLE TRIGGER products_price;
ALTER TABLE products ENABLE TRIGGER products_price;
DROP TRIGGER products_price ON products;

Trong psql, \d products liệt kê các trigger của bảng. CREATE OR REPLACE TRIGGER có từ PostgreSQL 14, và EXECUTE FUNCTION từ PostgreSQL 11; code cũ hơn viết EXECUTE PROCEDURE, cách này vẫn chạy. Một trigger ghi vào chính bảng của nó có thể tự kích hoạt lại chính nó, nên hãy đề phòng vòng lặp (pg_trigger_depth() trả về mức lồng nhau). Chương hàm trigger liệt kê mọi biến TG_, còn hàm và procedure nói về chính PL/pgSQL.

Câu hỏi thường gặp

Trigger trong PostgreSQL có chạy được mà không cần hàm không?

Không. CREATE TRIGGER luôn gọi một hàm được khai báo RETURNS trigger. Hãy viết hàm trước, thường bằng PL/pgSQL, rồi gắn nó vào.

Các trigger trên cùng một bảng chạy theo thứ tự nào?

Các trigger cùng loại trên cùng một sự kiện chạy theo thứ tự bảng chữ cái của tên. Hãy thêm tiền tố số hoặc chữ cái vào tên nếu thứ tự quan trọng.

Lỗi trong trigger có rollback câu lệnh không?

Có. Một lỗi được ném ra trong trigger, ví dụ bằng RAISE EXCEPTION, sẽ hủy câu lệnh đã kích hoạt nó, và cả transaction, trừ khi bạn bắt lỗi bằng một savepoint.

Trigger có chạy khi TRUNCATE không?

Trigger DELETE cấp hàng thì không. Hãy tạo một trigger cấp câu lệnh với BEFORE TRUNCATE hoặc AFTER TRUNCATE để phản ứng với nó.

Hình minh họa các ngôn ngữ lập trình của Coddy

Học lập trình cùng Coddy

Bắt đầu