PostgreSQL コネクタのメール通知の設定

注釈

Snowflake Connector for PostgreSQL は コネクタ規約 に従います。

コネクタのメール通知を有効にできます。コネクタは、 通知システムストアドプロシージャ を使用してメール通知を送信します。メール通知の設定はオプションですが、推奨されるアクションです。

メール通知を構成する

エラーが発生したときに、メール通知を送信するようにコネクタを構成できます。

指定されたスケジュールで、コネクタは新しいエラーが発生したかどうかを確認します。エラーがある場合、指定した受信者にエラー数を含むメールが送信されます。メール通知は増分ベースで送信されるため、新しいエラーが発生した場合にのみ通知がトリガーされます。セキュリティ上の理由から、メールにはエラー数に関する情報のみが含まれます(エラーの内容は含まれない)。

エラーに関するメール通知を受信するには、アカウントのイベントテーブルをすでに作成して設定し(ログに記録されたエラーをキャプチャするため)、そのイベントテーブルで CHANGE_TRACKING を TRUE に設定しておく必要があります。

メール通知を構成するには、次を実行します。

  1. 通知統合を作成する

  2. コネクタのログビューを作成する

  3. メール通知を有効にする

通知統合を作成する

メール通知を送信するために、コネクタは通知統合オブジェクトを使用します。これは、Snowflakeとメールサービス間のインターフェイスを提供するSnowflakeオブジェクトです。

通知統合を作成するには、次のコマンドを実行します。

CREATE NOTIFICATION INTEGRATION <integration_name>
    TYPE=EMAIL
    ENABLED=TRUE
    ALLOWED_RECIPIENTS=('first.last@example.com','first2.last2@example.com');
Copy

条件:

integration_name

通知統合の名前を指定します。

コネクタには、メールの送信に使用される通知統合に対する USAGE 権限が必要です。この権限を付与するには、次のコマンドを実行します。

GRANT USAGE ON INTEGRATION <integration_name> TO APPLICATION <app_db_name>;
Copy

条件:

integration_name

通知統合の名前を指定します。

app_db_name

コネクタデータベースの名前を指定します。

通知統合の作成に関する詳細については、 こちら をご参照ください。

コネクタのログビューを作成する

メール通知を構成するには、コネクタからのログメッセージを保存するイベントテーブルのログビューを作成する必要があります。コネクタインスタンスとして機能するデータベースを除く、任意のデータベースとスキーマでログビューを作成できます。

次のコマンドを実行して、イベントテーブルにログビューを作成します。

CREATE SECURE VIEW <logs_view> CHANGE_TRACKING = TRUE AS
  SELECT *
  FROM <fully_qualified_event_table_name>
  WHERE RECORD_TYPE = 'LOG' AND
  RESOURCE_ATTRIBUTES:"snow.database.name" = '<app_db_name>';
Copy

条件:

logs_view

作成するビューの名前を指定します。

fully_qualified_event_table_name

イベントテーブルの完全修飾名を指定します。

app_db_name

コネクタデータベースの名前を指定します。

コネクタにはビューに対する SELECT 権限が必要です。データベースとビューを含むスキーマの両方に対する USAGE 権限も必要です。これらの権限を付与するには、次のコマンドを実行します。

GRANT USAGE ON DATABASE <logs_db> TO APPLICATION <app_db_name>;
GRANT USAGE ON SCHEMA <logs_db>.<logs_schema> TO APPLICATION <app_db_name>;
GRANT SELECT ON VIEW <logs_db>.<logs_schema>.<logs_view> TO APPLICATION <app_db_name>;
Copy

条件:

logs_db

先ほど作成したビューを含むデータベースの名前を指定します。

logs_schema

先ほど作成したビューを含むスキーマの名前を指定します。

logs_view

先ほど作成したビューの名前を指定します。

app_db_name

コネクタデータベースの名前を指定します。

メール通知を有効にする

メール通知統合とログビューを作成したら、次のコマンドを実行してコネクタからのメール通知を有効にします。

CALL PUBLIC.CONFIGURE_ALERTS('<integration_name>', '<logs_db>.<logs_schema>.<logs_view>', '<schedule>', ['<email_address_1>' [, ... '<email_address_2>']]);
Copy

条件:

integration_name

通知統合の名前を指定します。

logs_db

前のステップで作成したビューを含むデータベースの名前を指定します。

logs_schema

前のステップで作成したビューを含むスキーマの名前を指定します。

logs_view

前のステップで作成したビューの名前を指定します。

schedule

コネクタがエラーをチェックして通知を送信するスケジュールまたは頻度を指定します。スケジュールまたは頻度の指定の詳細については、 SCHEDULE パラメーター をご参照ください。

['email_address_1' [, ... 'email_address_2']]

コネクタからメール通知を受信できる1つ以上の引用符で囲まれたメールアドレスの配列を指定します。この配列のメールアドレスは、 メール通知統合 で指定された ALLOWED_RECIPIENTS パラメーターに含まれている必要があります。

メール通知の設定を変更するには、修正されたパラメーターを指定して上記のコマンドを使用します。

メール通知を無効にする

メール通知を無効にするには、次のコマンドを実行します。

CALL PUBLIC.DISABLE_ALERTS();
Copy

このコマンドは、初期構成時に追加されたすべてのメールアドレスを削除します。

次のステップ

これらの手順を完了したら、 Snowflake Connector for PostgreSQL エージェントコンテナの設定 のステップに従います。