PostgreSQL 提供這些輔助函式來從事件觸發器中檢索資訊。
有關事件觸發器的更多資訊,請參閱 第 38 章。
pg_event_trigger_ddl_commands() →setof record
pg_event_trigger_ddl_commands 返回一個由使用者操作執行的DDL命令列表,當在附加到 ddl_command_end 事件觸發器的函式中呼叫時。如果在此其他上下文中呼叫,將引發錯誤。pg_event_trigger_ddl_commands 為執行的每個基本命令返回一行;某些作為單個 SQL 語句的命令可能會返回多行。此函式返回以下列
| 名稱 | 型別 | 描述 |
|---|---|---|
classid |
oid |
物件所屬的目錄的 OID |
objid |
oid |
物件本身的 OID |
objsubid |
integer |
子物件 ID(例如,列的屬性編號) |
command_tag |
text |
命令標籤 |
object_type |
text |
物件的型別 |
schema_name |
text |
物件所屬的模式的名稱(如果存在);否則為 NULL。不應用引號。 |
object_identity |
text |
物件識別符號的文字表示,帶模式限定。識別符號中包含的每個識別符號都已根據需要進行引用。 |
in_extension |
boolean |
如果命令是擴充套件指令碼的一部分,則為 True |
command |
pg_ddl_command |
命令的完整表示,採用內部格式。此項無法直接輸出,但可以傳遞給其他函式以獲取關於命令的不同資訊。 |
pg_event_trigger_dropped_objects() →setof record
pg_event_trigger_dropped_objects 返回在其呼叫的 sql_drop 事件中由該命令刪除的所有物件的列表。如果在此其他上下文中呼叫,將引發錯誤。此函式返回以下列
| 名稱 | 型別 | 描述 |
|---|---|---|
classid |
oid |
物件所屬的目錄的 OID |
objid |
oid |
物件本身的 OID |
objsubid |
integer |
子物件 ID(例如,列的屬性編號) |
original |
boolean |
如果這是刪除的根物件之一,則為 True |
normal |
boolean |
如果依賴圖中通向此物件的依賴關係是正常的,則為 True |
is_temporary |
boolean |
如果是臨時物件,則為 True |
object_type |
text |
物件的型別 |
schema_name |
text |
物件所屬的模式的名稱(如果存在);否則為 NULL。不應用引號。 |
object_name |
text |
物件的名稱,如果模式和名稱的組合可用作物件的唯一識別符號;否則為 NULL。不應用引號,並且名稱從不帶模式限定。 |
object_identity |
text |
物件識別符號的文字表示,帶模式限定。識別符號中包含的每個識別符號都已根據需要進行引用。 |
address_names |
text[] |
一個數組,與 object_type 和 address_args 一起,可以由 pg_get_object_address 函式用於重新建立遠端伺服器中具有相同名稱的相同型別物件的地址。 |
address_args |
text[] |
作為 address_names 的補充 |
可以使用 pg_event_trigger_dropped_objects 函式在事件觸發器中,如下所示
CREATE FUNCTION test_event_trigger_for_drops()
RETURNS event_trigger LANGUAGE plpgsql AS $$
DECLARE
obj record;
BEGIN
FOR obj IN SELECT * FROM pg_event_trigger_dropped_objects()
LOOP
RAISE NOTICE '% dropped object: % %.% %',
tg_tag,
obj.object_type,
obj.schema_name,
obj.object_name,
obj.object_identity;
END LOOP;
END;
$$;
CREATE EVENT TRIGGER test_event_trigger_for_drops
ON sql_drop
EXECUTE FUNCTION test_event_trigger_for_drops();
在 表 9.111 中顯示的函式提供了一個剛呼叫了 table_rewrite 事件的表的有關資訊。如果在此其他上下文中呼叫,將引發錯誤。
表 9.111. 表重寫資訊函式
可以使用這些函式在事件觸發器中,如下所示
CREATE FUNCTION test_event_trigger_table_rewrite_oid()
RETURNS event_trigger
LANGUAGE plpgsql AS
$$
BEGIN
RAISE NOTICE 'rewriting table % for reason %',
pg_event_trigger_table_rewrite_oid()::regclass,
pg_event_trigger_table_rewrite_reason();
END;
$$;
CREATE EVENT TRIGGER test_table_rewrite_oid
ON table_rewrite
EXECUTE FUNCTION test_event_trigger_table_rewrite_oid();
如果您在文件中發現任何不正確、與您對特定功能的體驗不符或需要進一步澄清的內容,請使用 此表單 報告文件問題。