MySQL コネクタのメール通知の設定¶
注釈
Snowflake Connector for MySQL は コネクタ規約 に従います。
コネクタのメール通知を有効にできます。コネクタは、 通知システムストアドプロシージャ を使用してメール通知を送信します。メール通知の設定はオプションですが、推奨されるアクションです。
メール通知を構成する¶
エラーが発生したときに、メール通知を送信するようにコネクタを構成できます。
指定されたスケジュールで、コネクタは新しいエラーが発生したかどうかを確認します。エラーがある場合、指定した受信者にエラー数を含むメールが送信されます。メール通知は増分ベースで送信されるため、新しいエラーが発生した場合にのみ通知がトリガーされます。セキュリティ上の理由から、メールにはエラー数に関する情報のみが含まれます(エラーの内容は含まれない)。
エラーに関するメール通知を受信するには、アカウントのイベントテーブルをすでに作成して設定し(ログに記録されたエラーをキャプチャするため)、そのイベントテーブルで CHANGE_TRACKING を TRUE に設定しておく必要があります。
メール通知を構成するには、次を実行します。
通知統合を作成する¶
メール通知を送信するために、コネクタは通知統合オブジェクトを使用します。これは、Snowflakeとメールサービス間のインターフェイスを提供するSnowflakeオブジェクトです。
通知統合を作成するには、次のコマンドを実行します。
CREATE NOTIFICATION INTEGRATION <integration_name> TYPE=EMAIL ENABLED=TRUE ALLOWED_RECIPIENTS=('first.last@example.com','first2.last2@example.com');
条件:
integration_name
通知統合の名前を指定します。
コネクタには、メールの送信に使用される通知統合に対する USAGE
権限が必要です。この権限を付与するには、次のコマンドを実行します。
GRANT USAGE ON INTEGRATION <integration_name> TO APPLICATION <app_db_name>;
条件:
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>';
条件:
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>;
条件:
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>']]);
条件:
integration_name
通知統合の名前を指定します。
logs_db
前のステップで作成したビューを含むデータベースの名前を指定します。
logs_schema
前のステップで作成したビューを含むスキーマの名前を指定します。
logs_view
前のステップで作成したビューの名前を指定します。
schedule
コネクタがエラーをチェックして通知を送信するスケジュールまたは頻度を指定します。スケジュールまたは頻度の指定の詳細については、 SCHEDULE パラメーター をご参照ください。
['email_address_1' [, ... 'email_address_2']]
コネクタからメール通知を受信できる1つ以上の引用符で囲まれたメールアドレスの配列を指定します。この配列のメールアドレスは、 メール通知統合 で指定された ALLOWED_RECIPIENTS パラメーターに含まれている必要があります。
メール通知の設定を変更するには、修正されたパラメーターを指定して上記のコマンドを使用します。
メール通知を無効にする¶
メール通知を無効にするには、次のコマンドを実行します。
CALL PUBLIC.DISABLE_ALERTS();
このコマンドは、初期構成時に追加されたすべてのメールアドレスを削除します。
次のステップ¶
これらの手順を完了したら、 Snowflake Connector for MySQL エージェントコンテナの設定 のステップに従います。