PostgreSQLはイベントトリガについての情報を取得するために以下のヘルパ関数を提供しています。
イベントトリガについての詳細は37章イベントトリガを参照して下さい。
pg_event_trigger_ddl_commandsがddl_command_endイベントトリガーに付与された関数から起動されると、各ユーザの操作によって実行されたDDLコマンドの一覧を返します。
それ以外の環境から呼び出された場合はエラーが発生します。
pg_event_trigger_ddl_commandsは、実行された基となるコマンドのそれぞれについて1行を返します。
1つの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 | bool | コマンドが拡張のスクリプトの一部かどうか |
command | pg_ddl_command | コマンドを内部形式で完全に表現したもの。 これを直接出力することはできないが、コマンドについて他の情報を得るために、他の関数に渡すことができる。 |
関数pg_event_trigger_dropped_objectsは、それが呼ばれたsql_dropイベントのコマンドにより削除された全てのオブジェクトのリストを返します。
その他いかなる状況で呼ばれた場合、pg_event_trigger_dropped_objectsはエラーを生じさせます。
pg_event_trigger_dropped_objectsは以下の列を返します。
| 名前 | 型 | 説明 |
|---|---|---|
classid | Oid | オブジェクトが所属するカタログのOID |
objid | Oid | カタログ内に所有するオブジェクトのOID |
objsubid | int32 | (列の属性番号のような)オブジェクトの副id |
original | bool | 削除のルートオブジェクトを特定するために使われるフラグ |
normal | bool | このオブジェクトへと至る依存関係グラフで、通常の依存があることを示すフラグ |
is_temporary | bool | オブジェクトが一時オブジェクトであったことを示すフラグ |
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 PROCEDURE test_event_trigger_for_drops();
表9.78「テーブル書き換え情報」に示す関数は、table_rewriteイベントが呼び出されたばかりのテーブルについての情報を提供します。
それ以外の状況で呼び出された場合はエラーが発生します。
表9.78 テーブル書き換え情報
pg_event_trigger_table_rewrite_oid関数はイベントトリガ内で以下のように使うことができます。
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 PROCEDURE test_event_trigger_table_rewrite_oid();