ALTER NOTIFICATION INTEGRATION¶
既存の通知統合のプロパティを変更します。
- こちらもご参照ください:
CREATE NOTIFICATION INTEGRATION , DROP INTEGRATION , SHOW INTEGRATIONS
構文¶
自動データロードまたはメタデータ更新
ALTER [ NOTIFICATION ] INTEGRATION [ IF EXISTS ] <name> SET
[ ENABLED = { TRUE | FALSE } ]
[ TAG <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' ... ] ]
[ COMMENT = '<string_literal>' ]
プッシュ通知
ALTER [ NOTIFICATION ] INTEGRATION [ IF EXISTS ] <name> SET
[ ENABLED = { TRUE | FALSE } ]
cloudProviderParamsPush
[ TAG <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' ... ] ]
[ COMMENT = '<string_literal>' ]
- 条件:
cloudProviderParamsPush (for Amazon Simple Notification Service) ::= AWS_SNS_TOPIC_ARN = '<topic_arn>' AWS_SNS_ROLE_ARN = '<iam_role_arn>'
cloudProviderParamsPush (for Google Pub/Sub) ::= GCP_PUBSUB_SUBSCRIPTION_NAME = '<subscription_id>'
cloudProviderParamsPush (for Microsoft Azure Event Grid) ::= AZURE_STORAGE_QUEUE_PRIMARY_URI = '<queue_URL>' AZURE_TENANT_ID = '<directory_ID>';
メール通知
ALTER [ NOTIFICATION ] INTEGRATION [ IF EXISTS ] <name> SET
[ ENABLED = { TRUE | FALSE } ]
[ ALLOWED_RECIPIENTS = ( '<email_address_1>' [ , ... '<email_address_N>' ] ) ]
[ TAG <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' ... ] ]
[ COMMENT = '<string_literal>' ]
ALTER [ NOTIFICATION ] INTEGRATION [ IF EXISTS ] <name> UNSET {
ALLOWED_RECIPIENTS |
COMMENT
}
パラメーター¶
name
変更する統合の識別子。識別子にスペースまたは特殊文字が含まれる場合、文字列全体を二重引用符で囲む必要があります。二重引用符で囲まれた識別子も大文字と小文字が区別されます。
SET ...
テーブルに設定する1つ以上のプロパティ/パラメーターを指定します(空白、コンマ、または改行で区切られます)。
ENABLED = { TRUE | FALSE }
統合の操作を開始するか、中断するかを指定します。
TRUE
: 統合が有効になります。FALSE
: メンテナンスのために統合を一時停止します。Snowflakeとサードパーティサービス間の統合はいずれも機能しません。
TAG tag_name = 'tag_value' [ , tag_name = 'tag_value' , ... ]
タグ の名前とタグ文字列の値を指定します。
タグ値は常に文字列であり、タグ値の最大文字数は256です。
ステートメントでのタグの指定に関する情報については、 オブジェクトおよび列のタグクォータ をご参照ください。
ALLOWED_RECIPIENTS=('email_address_1' [, ... 'email_address_N'])
(
TYPE = EMAIL
の場合)この統合からの通知メールを受信できる、引用されたメールアドレスのコンマで区切られたリスト。現在のアカウントにあるユーザーのメールアドレスを指定する必要があります。これらのユーザーは、 メールアドレスを確認する 必要があります。
指定できるメールアドレスの最大数は50です。
このパラメーターを省略すると、現在のアカウントで検証されたメールアドレスにメール通知を送信できます。
COMMENT = 'string_literal'
統合のコメントを指定する文字列(リテラル)。
UNSET ...
API 統合の設定を解除する1つ以上のプロパティ/パラメーターを指定し、それらをデフォルトにリセットします。
ENABLED
TAG tag_name [ , tag_name ... ]
ALLOWED_RECIPIENTS
COMMENT
プッシュ通知用のクラウドプロバイダーパラメーター(cloudProviderParamsPush
)¶
CREATE NOTIFICATION INTEGRATION の プッシュ通知用のクラウドプロバイダーパラメーター(cloudProviderParamsPush) セクションでこれらのパラメーターの説明をご参照ください。
使用上の注意¶
メタデータについて。
注意
Snowflakeサービスを使用する場合、お客様は、個人データ(ユーザーオブジェクト向け以外)、機密データ、輸出管理データ、またはその他の規制されたデータがメタデータとして入力されていないことを確認する必要があります。詳細については、 Snowflakeのメタデータフィールド をご参照ください。
統合がキャッシュされている可能性があるため、統合を無効にしたりドロップしたりしても、すぐに反映されないことがあります。よりすばやく反映されるようにするために、クラウドプロバイダーから統合権限を削除することをお勧めします。
例¶
次の例では、中断された統合の操作を開始します。
ALTER NOTIFICATION INTEGRATION myint SET ENABLED = TRUE;
ALTER NOTIFICATION INTEGRATION myint UNSET COMMENT;