【入門編】pgAdmin 4のイベントトリガーとアラート通知設定でPostgreSQLの変更検知を自動化する – データベース・API管理活用バイブル

こんにちは！データベースの裏側で何が起きているのか、気になったことはありませんか？
「テーブルのデータが書き換わった瞬間を検知したい」「誰が勝手にテーブル構造（DDL）を変えたのか追跡したい」——そんな現場の切実な悩みを解決するのが、PostgreSQLのイベントトリガーと通知機能（LISTEN/NOTIFY）です。

そして今回は、この強力な機能を、黒い画面（CUI）だけでなく、PostgreSQL公式の強力なGUIクライアントであるpgAdmin 4を使って安全かつ視覚的に設定する方法を徹底解説します。

これをマスターすれば、毎日のDB監視や外部連携の仕組みづくりが劇的に楽になりますよ。さあ、一緒にデータベースの自動化の世界へ飛び込みましょう！

—

1. そもそも「pgAdmin 4」と「イベントトリガー」って何をするもの？

まずは、今回使う道具の役割を整理しておきましょう。

pgAdmin 4とは： PostgreSQLをブラウザやデスクトップアプリから操作できる、いわば「コックピット」です。SQLを書くだけでなく、ツリービューからポチポチ操作するだけで高度なオブジェクトを作れる優れものです。
イベントトリガーとは： 通常のトリガーは「特定のテーブルのデータ（行）が更新されたとき」に動きますが、イベントトリガーは「データベース全体でテーブルが作られた（`CREATE TABLE`）、削除された（`DROP TABLE`）などの構造変更（DDL）」が発生した瞬間に発火する、データベースの番人のような存在です。
通知機能（NOTIFY）： データベース内で何かが起きたとき、外の世界（アプリケーションや外部スクリプト）へ「おーい、事件だよ！」と叫ぶ機能です。

この2つを組み合わせると、「誰かが勝手にテーブル構造を変えたら、即座にログに残し、チャットに飛ばす」といった自動化が実現できます。

—

2. 【基礎セットアップ】pgAdmin 4で安全につながる

まずはpgAdmin 4を起動し、対象のPostgreSQLサーバーに接続しましょう。

接続の手順

1. pgAdmin 4を開き、左側のツリービューにある 「Servers」 を右クリック。
2. 「Create」＞「Server…」 を選択。
3. 「General」タブで任意の名前（例: `MyLocalDB`）を入力。
4. 「Connection」タブで、接続先ホスト（通常は `localhost`）、ポート（`5432`）、データベース名、ユーザー名、パスワードを入力して 「Save」。

これで準備完了です。緑色のアイコンが点灯すれば、コックピットの計器は正常に動いています。

—

3. 【実践】DDL変更を検知してログを出力する「Hello World」

それでは、最初のステップとして「誰かがテーブルやビューを作ったり消したりしたとき（DDL変更）」を検知し、PostgreSQLのサーバーログに足跡を残す仕組みを作りましょう。

pgAdmin 4の「Query Tool（クエリツール）」を開き、以下のSQLスクリプトを実行します。

ステップ1: 検知したときに働く「関数」を作る

イベントトリガーが発火したときに「何をするか」の中身をPL/pgSQLという言語で定義します。

— 既存の関数があれば削除
DROP FUNCTION IF EXISTS log_ddl_changes() CASCADE;

— DDL変更を検知してログに出力する関数
CREATE OR REPLACE FUNCTION log_ddl_changes()
RETURNS event_trigger AS $$
DECLARE
r RECORD;
BEGIN
— pg_event_trigger_ddl_commands() を使って、何が起きたかを取得する
FOR r IN SELECT FROM pg_event_trigger_ddl_commands()
LOOP
— PostgreSQLのサーバーログに警告レベルで出力する
RAISE NOTICE ‘【DDL検知】象徴操作: %, オブジェクト名: %, 種類: %’,
r.command_tag,
r.object_identity,
r.object_type;
END LOOP;
END;
$$ LANGUAGE plpgsql;

ステップ2: イベントトリガーを登録する

先ほど作った関数を、「DDL（`dcl_command_start` または `ddl_command_end`）が完了した瞬間」に結びつけます。

— 既存のイベントトリガーがあれば削除
DROP EVENT TRIGGER IF EXISTS trg_log_ddl_changes;

— DDL終了時にイベントトリガーを発火させる
CREATE EVENT TRIGGER trg_log_ddl_changes
ON ddl_command_end
EXECUTE FUNCTION log_ddl_changes();

—

4. 動作確認：本当に検知できるか試してみよう！

設定がうまくいったか、実際にテスト用のテーブルを作って確認してみましょう。同じくpgAdminのQuery Toolで以下を実行します。

— テスト用のテーブルを作ってみる
CREATE TABLE test_audit_table (
id SERIAL PRIMARY KEY,
memo TEXT
);

— テスト用のテーブルを消してみる
DROP TABLE test_audit_table;

🔍 ログの確認方法（pgAdminの機能を使おう）

pgAdmin 4では、サーバーのログを簡単に確認できます。
1. 左側ツリーから接続しているサーバーを選択。
2. メニューの 「Tools」＞「Server Log」 を開く。
3. もしくは、PostgreSQLのログ出力先を確認すると、以下のようなメッセージが記録されているはずです。

> `NOTICE: 【DDL検知】象徴操作: CREATE TABLE, オブジェクト名: public.test_audit_table, table`
> `NOTICE: 【DDL検知】象徴操作: DROP TABLE, オブジェクト名: public.test_audit_table, table`

おめでとうございます！これで「データベースの構造変化を監視する自動検知システム」の第一歩が完了しました。

—

5. 発展：外部へ通知を飛ばす「NOTIFY」の活用

さらに実用的なテクニックとして、PostgreSQLの `NOTIFY` を使ってみましょう。これを使うと、データベース内部で起きた変更を、外側で待機しているPythonプログラムやNode.jsなどの外部アプリにリアルタイムで伝えることができます。

以下のスクリプトをpgAdminで実行してみてください。今度は通常のトリガー（テーブルのデータ更新を検知するもの）と組み合わせる例です。

— 1. 通知を送る関数を作る
CREATE OR REPLACE FUNCTION notify_table_update()
RETURNS TRIGGER AS $$
DECLARE
payload TEXT;
BEGIN
— 通知するペイロード（データ）をJSON形式で組み立てる
— TG_OP は ‘INSERT’, ‘UPDATE’, ‘DELETE’ のいずれかが入る
payload := json_build_object(
‘table’, TG_TABLE_NAME,
‘operation’, TG_OP,
‘time’, clock_timestamp()
)::text;

— ‘table_update_channel’ というチャンネルに向かって叫ぶ（通知する）
PERFORM pg_notify(‘table_update_channel’, payload);

RETURN NEW;
END;
$$ LANGUAGE plpgsql;

— 2. サンプルテーブルにトリガーを紐付ける
— ※あらかじめ適当なテーブル（例: users）が存在する前提です
— CREATE TABLE users (id serial, name text);
—
— CREATE TRIGGER trg_users_notify
— AFTER INSERT OR UPDATE ON users
— FOR EACH ROW
— EXECUTE FUNCTION notify_table_update();

外側からの受け取り方（イメージ）

外部のアプリケーションからは、SQLで以下のように待機（LISTEN）するだけで、データが更新された瞬間にイベントを受け取ることができます。

LISTEN table_update_channel;

（※Pythonの `psycopg2` などのライブラリを使えば、この非同期通知をトリガーにしてSlackに通知を送るボットなどを簡単に作ることができます）

—

まとめ

今回は、pgAdmin 4を使ってPostgreSQLのイベントトリガーと通知機能を設定し、データベースの変更検知を自動化する方法を解説しました。

イベントトリガーでデータベースの構造変更（DDL）を監視する
pgAdmin 4のQuery Toolを使って安全にスクリプトを適用する
NOTIFYを使って外部アプリへリアルタイムに変化を伝える

データベースは単にデータを貯めておく箱ではなく、それ自体が「今何が起きたか」を雄弁に語ってくれるスマートなエンジンです。この仕組みをマスターすれば、運用の安全性やシステムの拡張性が飛躍的に向上します。

日々のデータベース管理が、少しでもワクワクする楽しいものになりますように。それでは、次の技術でお会いしましょう！