CREATE NOTIFICATION INTEGRATION（メール）

アカウントに新しい通知統合を作成するか、 電子メールメッセージの送信 用の既存の統合を置き換えます。

こちらもご参照ください。

ALTER NOTIFICATION INTEGRATION（メール）、 DESCRIBE INTEGRATION、 DROP INTEGRATION、 SHOW INTEGRATIONS

構文

CREATE [ OR REPLACE ] NOTIFICATION INTEGRATION [ IF NOT EXISTS ] <name>
  TYPE = EMAIL
  ENABLED = { TRUE | FALSE }
  [ ALLOWED_RECIPIENTS = ( '<email_address>' [ , ... '<email_address>' ] ) ]
  [ DEFAULT_RECIPIENTS = ( '<email_address>' [ , ... '<email_address>' ] ) ]
  [ DEFAULT_SUBJECT = '<subject_line>' ]
  [ COMMENT = '<string_literal>' ]
Copy

必須パラメーター

name

統合の識別子（つまり、名前）を指定する文字列。アカウント内で一意である必要があります。

また、識別子はアルファベット文字で始まる必要があり、識別子文字列全体が二重引用符で囲まれていない限り、スペースや特殊文字を含めることはできません（例: "My object"）。二重引用符で囲まれた識別子も大文字と小文字が区別されます。

詳細については、 識別子の要件 をご参照ください。

ENABLED = { TRUE | FALSE }

統合の操作を開始するか、中断するかを指定します。

  • TRUE は、統合を有効にします。

  • FALSE は、メンテナンスのための統合を無効にします。Snowflakeとサードパーティサービス間の統合はいずれも機能しません。

TYPE = EMAIL

Snowflakeとサードパーティメールサービスの間のインターフェイスを作成します。

オプションのパラメーター

ALLOWED_RECIPIENTS = ( 'email_address' [ , ... 'email_address' ] )

（TYPE = EMAIL の場合）この統合からの通知メールを受信できる、引用されたメールアドレスのコンマで区切られたリスト。

現在のアカウントにあるユーザーのメールアドレスを指定する必要があります。これらのユーザーは、 メールアドレスを確認する 必要があります。

指定できるメールアドレスの最大数は50です。

このパラメーターを省略すると、現在のアカウントで検証されたメールアドレスにメール通知を送信できます。

DEFAULT_RECIPIENTS = ( 'email_address' [ , ... 'email_address' ] )

この統合で送信されるメッセージのデフォルト受信者のリストを指定します。コンマで区切られた引用メールアドレスのリストを使用して、デフォルトの受信者を指定します。

現在のアカウントにあるユーザーのメールアドレスを指定する必要があります。これらのユーザーは、自分のメールアドレスを確認する必要があります。

指定したメッセージのデフォルトの受信者を上書きするには、 SYSTEM$SEND_SNOWFLAKE_NOTIFICATION ストアドプロシージャを呼び出す際に EMAIL_INTEGRATION_CONFIG ヘルパー関数を使います。

DEFAULT_SUBJECT = 'subject_line'

この統合で送信されるメッセージの既定の件名を指定します。

件名は256文字を超えることはできません。

デフォルト: 「Snowflakeメール通知」

指定したメッセージの既定の件名の行を上書きするには、 SYSTEM$SEND_SNOWFLAKE_NOTIFICATION ストアドプロシージャを呼び出す際に、 EMAIL_INTEGRATION_CONFIG ヘルパー関数を使用します。

COMMENT = 'string_literal'

統合のコメントを指定する文字列（リテラル）。

デフォルト: 値なし

アクセス制御の要件

この SQL コマンドの実行に使用される ロール には、少なくとも次の 権限 が必要です。

権限

オブジェクト

メモ

CREATE INTEGRATION

アカウント

Only the ACCOUNTADMIN role has this privilege by default. The privilege can be granted to additional roles as needed.

指定された権限のセットを使用してカスタムロールを作成する手順については、 カスタムロールの作成 をご参照ください。

セキュリティ保護可能なオブジェクト に対して SQL アクションを実行するためのロールと権限付与に関する一般的な情報については、 アクセス制御の概要 をご参照ください。

使用上の注意

  • メタデータについて:

    注意

    Snowflakeサービスを使用する場合、お客様は、個人データ（ユーザーオブジェクト向け以外）、機密データ、輸出管理データ、またはその他の規制されたデータがメタデータとして入力されていないことを確認する必要があります。詳細については、 Snowflakeのメタデータフィールド をご参照ください。

  • CREATE OR REPLACE <オブジェクト> ステートメントはアトミックです。つまり、オブジェクトが置き換えられると、単一のトランザクションで、古いオブジェクトが削除されて新しいオブジェクトが作成されます。

例

メール通知の送信 をご参照ください。

言語: 日本語