カテゴリ:

ユーザーとセキュリティ DDL (サードパーティのサービス統合)

ALTER NOTIFICATION INTEGRATION

既存の通知統合のプロパティを変更します。

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

CREATE NOTIFICATION INTEGRATION , DROP INTEGRATION , SHOW INTEGRATIONS

このトピックの内容:

構文

ALTER [ NOTIFICATION ] INTEGRATION [ IF EXISTS ] <name> SET
  [ ENABLED = { TRUE | FALSE } ]
  cloudProviderParams
  [ COMMENT = '<string_literal>' ]

ALTER [ NOTIFICATION ] INTEGRATION <name> SET TAG <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' ... ]

ALTER [ NOTIFICATION ] INTEGRATION <name> UNSET TAG <tag_name> [ , <tag_name> ... ]

ALTER [ NOTIFICATION ] INTEGRATION [ IF EXISTS ] <name> UNSET
  ENABLED |
  COMMENT

条件:

cloudProviderParams (for Amazon S3) ::=
  AWS_SNS_TOPIC_ARN = '<topic_arn>'
  AWS_SNS_ROLE_ARN = '<iam_role_arn>'

cloudProviderParams (for Google Cloud Storage) ::=
  GCP_PUBSUB_SUBSCRIPTION_NAME = '<subscription_id>'

cloudProviderParams (for Microsoft Azure) ::=
  AZURE_STORAGE_QUEUE_PRIMARY_URI = 'https://<storage_queue_account>.queue.core.windows.net/<storage_queue_name>'
  AZURE_TENANT_ID = '<ad_directory_id>'

パラメーター

名前

変更する統合の識別子。識別子にスペースまたは特殊文字が含まれる場合、文字列全体を二重引用符で囲む必要があります。二重引用符で囲まれた識別子も大文字と小文字が区別されます。

SET ...

テーブルに設定する1つ以上のプロパティ/パラメーターを指定します(空白、コンマ、または改行で区切られます)。

ENABLED = TRUE | FALSE 統合の操作を開始するか一時停止するかを指定します。

  • TRUE: パイプ定義で指定されたパラメーターに基づいて統合を許可します。

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

TAG タグ名 = 'タグ値' [ , タグ名 = 'タグ値' , ... ]

タグ 名(つまり、キー)とタグ値を指定します。

タグ値は常に文字列であり、タグ値の最大文字数は256です。オブジェクトに設定できる 一意の タグキーの最大数は20です。

COMMENT = '文字列リテラル'

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

UNSET ...

API 統合の設定を解除する1つ以上のプロパティ/パラメーターを指定し、それらをデフォルトにリセットします。

  • ENABLED

  • TAG タグ名 [ , タグ名 ... ]

  • COMMENT

クラウドプロバイダーのパラメーター(cloudProviderParams

Amazon S3

AWS_SNS_TOPIC_ARN = '<topic_arn>'

エラーメッセージを処理するAmazon SNS (SNS)トピックのAmazonリソースネーム(ARN)。

最初にトピックの IAM ポリシーを変更し、リソースを新しいトピック ARN に変更する必要があることに注意してください。詳細については、 Snowpipeのエラー通知の有効化 の「ステップ2: IAM ポリシーを作成する」をご参照ください。

AWS_SNS_ROLE_ARN = '<iam_role_arn>'

SNS トピックにエラーメッセージを公開する権限を持つ IAM ロールの ARN。

ロールの IAM ポリシーを更新し、Snowflakeユーザーに sts:AssumeRole アクションを付与する必要があることに注意してください。詳細については、 Snowpipeのエラー通知の有効化 の「IAM ロールの信頼関係の変更」をご参照ください。

Google Cloud Storage

GCP_PUBSUB_SUBSCRIPTION_NAME = '<subscription_id>'

Snowflakeがイベントメッセージにアクセスできるようにするために使用される、Pub/Subトピックサブスクリプション ID。

Microsoft Azure

AZURE_STORAGE_QUEUE_PRIMARY_URI = 'https://ストレージキューアカウント.queue.core.windows.net/ストレージキュー名'

Event Grid通知用に作成されたAzure Queue Storageキューのキュー ID を指定します。

注釈

Azure Queue Storageキューは、単一の通知の統合をサポートしています。イベント通知は通知の統合間で分割されるため、複数の通知統合で単一のストレージキューを参照すると、ターゲットテーブルのデータが失われる可能性があります。

詳細については、次をご参照ください。

Snowpipe

Microsoft Azure BLOBストレージ用Snowpipeの自動化

外部テーブル

Azure Blobストレージに対する外部テーブルの自動更新

AZURE_TENANT_ID = '広告ディレクトリID'

ID管理に使用されるAzure Active Directoryテナントの ID を指定します。この ID は、BLOBストレージ内の新しいファイルのSnowpipeロードを自動トリガーするために使用する、Event Grid通知サブスクリプションへのSnowflakeアクセスを許可する同意 URL を生成するために必要です。

使用上の注意

  • メタデータについて。

    注意

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

次の例では、中断された統合の操作を開始します。

ALTER NOTIFICATION INTEGRATION myint SET ENABLED = TRUE;