ALTER CONNECTION

既存の接続のプロパティを変更します。

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

CREATE CONNECTION、 DROP CONNECTION、 SHOW CONNECTIONS

構文

ALTER CONNECTION <name> ENABLE FAILOVER TO ACCOUNTS <organization_name>.<account_name> [ , <organization_name>.<account_name> ... ]
                        [ IGNORE EDITION CHECK ]

ALTER CONNECTION <name> DISABLE FAILOVER [ TO ACCOUNTS <organization_name>.<account_name> [ , <organization_name>.<account_name> ... ] ]

ALTER CONNECTION <name> PRIMARY

ALTER CONNECTION [ IF EXISTS ] <name> SET COMMENT = '<string_literal>'

ALTER CONNECTION [ IF EXISTS ] <name> UNSET COMMENT
Copy

パラメーター

name

変更する接続の識別子。

ENABLE FAILOVER TO ACCOUNTS organization_name.account_name [ , organization_name.account_name ... ]

このプライマリ接続のセカンダリ接続をプライマリ接続として機能するように昇格できる、組織内のアカウントのコンマ区切りリストを指定します。リストに各アカウントの組織名を含めます。

リスト内の各アカウントは、プライマリ接続のアカウントとは異なるリージョンに配置する 必要 があります。それ以外の場合、コマンドは失敗します。

DISABLE FAILOVER [ TO ACCOUNTS organization_name.account_name [ , organization_name.account_name ... ] ]

このプライマリ接続のフェールオーバーを無効にします。つまり、このプライマリ接続のセカンダリ接続を昇格してプライマリ接続として機能させることはできません。

選択したアカウント（すべてのアカウントではなく）へのフェールオーバーを無効にするには、それらのアカウントのコンマ区切りリストを指定します。

PRIMARY

プライマリ接続として機能するように接続を昇格します。

SET ...

接続に設定するプロパティを指定します。

COMMENT = 'string'

接続のコメントを追加するか、既存のコメントを上書きします。

UNSET ...

接続の設定を解除してデフォルトにリセットするプロパティを指定します。

現在、設定解除できるプロパティは COMMENT のみです。これにより、接続のコメントがあれば削除されます。

使用上の注意

  • アカウント管理者（ACCOUNTADMIN ロールを持つユーザー）のみが、この SQL コマンドを実行できます。

  • SnowflakeアカウントでSnowflakeサービスへのプライベート接続が有効になっている場合、ネットワーク管理者は、接続がプライマリ接続として機能するように昇格されたときに、接続 URL の DNS CNAME 記録を更新する必要があります。詳細については、 Snowflakeサービスへのプライベート接続用 DNS 設定の構成 をご参照ください。

  • メタデータについて、

    注意

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

例

myorg 組織のアカウント myaccount2 と myaccount3 に、それぞれ myconnection 接続のセカンダリ接続を保存することを許可します。

ALTER CONNECTION myconnection ENABLE FAILOVER TO ACCOUNTS myorg.myaccount2, myorg.myaccount3;
Copy

接続にコメントを追加します。

ALTER CONNECTION myconnection SET COMMENT = 'New comment for connection';
Copy

セカンダリ接続をプライマリ接続に昇格します。

ALTER CONNECTION myconnection PRIMARY;
Copy
言語: 日本語