ALTER FAILOVER GROUP¶

構文¶

ソースアカウント

ALTER FAILOVER GROUP [ IF EXISTS ] <name> RENAME TO <new_name>

ALTER FAILOVER GROUP [ IF EXISTS ] <name> SET
  [ OBJECT_TYPES = <object_type> [ , <object_type> , ... ] ]
  [ REPLICATION_SCHEDULE = '{ <num> MINUTE | USING CRON <expr> <time_zone> }' ]

ALTER FAILOVER GROUP [ IF EXISTS ] <name> SET
  OBJECT_TYPES = INTEGRATIONS [ , <object_type> , ... ] ]
  ALLOWED_INTEGRATION_TYPES = <integration_type_name> [ , <integration_type_name> ... ] ]
  [ REPLICATION_SCHEDULE = '{ <num> MINUTE | USING CRON <expr> <time_zone> }' ]

ALTER FAILOVER GROUP [ IF EXISTS ] <name>
  ADD <db_name> [ , <db_name> ,  ... ] TO ALLOWED_DATABASES

ALTER FAILOVER GROUP [ IF EXISTS ] <name>
  MOVE DATABASES <db_name> [ , <db_name> ,  ... ] TO FAILOVER GROUP <move_to_fg_name>

ALTER FAILOVER GROUP [ IF EXISTS ] <name>
  REMOVE <db_name> [ , <db_name> ,  ... ] FROM ALLOWED_DATABASES

ALTER FAILOVER GROUP [ IF EXISTS ] <name>
  ADD <share_name> [ , <share_name> ,  ... ] TO ALLOWED_SHARES

ALTER FAILOVER GROUP [ IF EXISTS ] <name>
  MOVE SHARES <share_name> [ , <share_name> ,  ... ] TO FAILOVER GROUP <move_to_fg_name>

ALTER FAILOVER GROUP [ IF EXISTS ] <name>
  REMOVE <share_name> [ , <share_name> ,  ... ] FROM ALLOWED_SHARES

ALTER FAILOVER GROUP [ IF EXISTS ] <name>
  ADD <org_name>.<target_account_name> [ , <org_name>.<target_account_name> ,  ... ] TO ALLOWED_ACCOUNTS
  [ IGNORE EDITION CHECK ]

ALTER FAILOVER GROUP [ IF EXISTS ] <name>
  REMOVE <org_name>.<target_account_name> [ , <org_name>.<target_account_name> ,  ... ] FROM ALLOWED_ACCOUNTS

ターゲットアカウント

ALTER FAILOVER GROUP [ IF EXISTS ] <name> REFRESH

ALTER FAILOVER GROUP [ IF EXISTS ] <name> PRIMARY

ALTER FAILOVER GROUP [ IF EXISTS ] <name> SUSPEND

ALTER FAILOVER GROUP [ IF EXISTS ] <name> RESUME

パラメーター¶

ソースアカウント

name

フェールオーバーグループの識別子を指定します。

RENAME TO new_name

new_name

フェールオーバーグループの新しい識別子を指定します。識別子が別の複製またはフェールオーバーにすでに配置されている場合、新しい識別子は使用できません。

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

SET ...

フェールオーバーグループに設定する1つ（または複数）のプロパティを指定します（空白、コンマ、または改行で区切り）。設定できるプロパティの詳細については、 CREATE FAILOVER GROUP をご参照ください。

ADD db_name [ , db_name ,  ... ] TO ALLOWED_DATABASES

複製とフェールオーバーを有効にする追加データベースのコンマ区切りリストを指定します。データベースを追加するには、指定されたオブジェクト型のリストに DATABASES を含める必要があります。オブジェクト型のリストにまだ DATABASES が含まれていない場合は、追加する必要があります。

db_name

データベースの識別子を指定します。

MOVE DATABASES db_name [ , db_name ,  ... ] TO FAILOVER GROUP move_to_fg_name

あるフェールオーバーグループから別のフェールオーバーグループに移動するデータベースのコンマ区切りリストを指定します。データベースの移動先のフェールオーバーグループには、指定されたオブジェクト型のリストに DATABASES を含める必要があります。

db_name

データベースの識別子を指定します。

move_to_fg_name

データベースの移動先のフェールオーバーグループに対する識別子を指定します。

REMOVE db_name [ , db_name ,  ... ] FROM ALLOWED_DATABASES

複製とフェールオーバーが有効になっているデータベースのリストから、削除するデータベースのコンマ区切りリストを指定します。

ADD share_name [ , share_name ,  ... ] TO ALLOWED_SHARES

複製とフェールオーバーを有効にする追加の共有のコンマ区切りリストを指定します。共有を追加するには、指定されたオブジェクト型のリストに SHARES を含める必要があります。オブジェクト型のリストにまだ SHARES が含まれていない場合は、追加する必要があります。

share_name

共有の識別子を指定します。

MOVE SHARES share_name [ , share_name ,  ... ] TO FAILOVER GROUP move_to_fg_name

あるフェールオーバーグループから別のフェールオーバーグループに移動する共有のコンマ区切りリストを指定します。共有の移動先のフェールオーバーグループには、指定されたオブジェクト型のリストに SHARES を含める必要があります。

share_name

共有の識別子を指定します。

move_to_fg_name

共有の移動先のフェールオーバーグループに対する識別子を指定します。

REMOVE share_name [ , share_name ,  ... ] FROM ALLOWED_SHARES

複製とフェールオーバーが有効になっている共有のリストから、削除する共有のコンマ区切りリストを指定します。

ADD org_name.target_account_name [ , org_name.target_account_name ,  ... ] TO ALLOWED_ACCOUNTS

プライマリフェールオーバーグループに追加するターゲットアカウントのコンマ区切りリストを指定して、ソースアカウント内にある指定されたオブジェクトのターゲットアカウントへの複製とフェールオーバーを有効にします。このリストにあるターゲットアカウントのセカンダリフェールオーバーグループは、フェールオーバーの場合にプライマリフェールオーバーグループとして機能するように昇格できます。

org_name

Snowflake組織の名前。

target_account_name

指定されたオブジェクトの複製を有効にするターゲットアカウント。

REMOVE org_name.target_account_name [ , org_name.target_account_name ,  ... ] FROM ALLOWED_ACCOUNTS

プライマリフェールオーバーグループから削除するターゲットアカウントのコンマ区切りリストを指定して、ソースアカウント内にある指定されたオブジェクトのターゲットアカウントへの複製を無効にします。ターゲットアカウントを削除すると、現在のアカウントからこのターゲットアカウントへのフェールオーバーが無効になります。

org_name

Snowflake組織の名前。

target_account_name

指定されたオブジェクトの複製を無効にするターゲットアカウント。

IGNORE EDITION CHECK

次のシナリオにおいて、オブジェクトのアカウントへの複製を許可します。

プライマリフェールオーバーグループがBusiness Critical（またはそれ以上）のアカウントにあり、 HIPAA および HITRUST 規制に従ってアカウントに PHI データを格納するための署名済みビジネスアソシエイト契約が整っている。しかし、Business Critical（またはそれ以上）のアカウントであるかどうかにかかわりなく、複製が承認された1つ以上のアカウントに対してはそのような契約がない。

このシナリオはデフォルトで禁止されています。

ターゲットアカウント

secondary_name

フェールオーバーグループの識別子を指定します。

REFRESH

ソースアカウントからターゲット（現在の）アカウントのオブジェクトを更新します。

PRIMARY

ターゲット（現在の）アカウント内のセカンダリフェールオーバーグループとその指定されたオブジェクトをプライマリに昇格します（フェールオーバーの場合）。

SUSPEND

セカンダリフェールオーバーグループのスケジュールされた更新を一時停止します（プライマリフェールオーバーグループが、 REPLICATION_SCHEDULE プロパティを使用してスケジュールされた更新を行っている場合）。

RESUME

セカンダリフェールオーバーグループのスケジュールされた更新を再開します（プライマリフェールオーバーグループが、 REPLICATION_SCHEDULE プロパティを使用してスケジュールされた更新を行っている場合）。

使用上の注意¶

• 次の最小限の権限が必要です。

  • ALTER FAILOVER GROUP ... REFRESH を使用してセカンダリフェールオーバーグループを更新するには、フェールオーバーグループに対する OWNERSHIP または REPLICATE 権限のいずれかがロールに必要です。

  • ALTER FAILOVER GROUP ... PRIMARY を使用してセカンダリフェールオーバーグループをフェールオーバーするには、フェールオーバーグループに対する OWNERSHIP または FAILOVER 権限のいずれかがロールに必要です。

  • フェールオーバーグループにその他の変更を加える、この SQL コマンドを実行できるのは、グループに対して OWNERSHIP 権限のあるロールのみです。

  • データベースをフェールオーバーグループに追加するには、データベースに対する MONITOR 権限がアクティブなロールに必要です。

  • フェールオーバーグループに共有を追加するには、共有に対する OWNERSHIP 権限がアクティブなロールに必要です。

• アカウント内のフェールオーバーグループと複製グループの識別子は一意にする必要があります。

• データベースと共有以外のオブジェクトは、同じフェールオーバーグループに属している必要があります。

• データベースは、1つのフェールオーバーグループにのみ追加できます。

• 更新が進行中の場合は、セカンダリフェールオーバーグループのプライマリへの昇格（フェールオーバーの場合）に失敗します。

• 複製スケジュールの更新時に更新が進行中の場合、更新は完了するまで続行され、次の更新で新しいスケジュールが使用されます。

• フェールオーバー時に、すべてのセカンダリフェールオーバーグループでスケジュールされた更新が一時停止されます。自動更新を再開するには、各セカンダリで ALTER FAILOVER GROUP ... RESUME を実行する必要があります。

• データベースまたは共有を1つのフェールオーバーグループ（移動元グループ）から別のフェールオーバーグループ（移動先グループ）に移動するには、

  • 両方のグループを同じ型の FAILOVER GROUP にする必要があります。

  • 両方のグループが、 allowed_accounts リストにリストされている同じアカウントを持っている必要があります。

  • 移動元グループの最後のデータベースが別のグループに移動された場合、移動元グループの allowed_databases プロパティは NULL に設定されます。同じ動作が共有にも当てはまります。

  • 移動先グループの object_types リストに移動先のオブジェクト型（databases または shares）がない場合は、オブジェクトを移動する前に、移動先グループに明示的に追加する必要があります。

• 複製が有効になっている組織内のアカウントのリストを取得するには、 SHOW REPLICATION ACCOUNTS コマンドを使用します。

• 組織内のフェールオーバーグループのリストを取得するには、 SHOW FAILOVER GROUPS を使用します。

• メタデータについて、

  注意

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

例¶

ALTER FAILOVER GROUP myfg ADD myorg.myaccount3 TO ALLOWED_ACCOUNTS;

ALTER FAILOVER GROUP myfg SET
  OBJECT_TYPES = USERS, ROLES, WAREHOUSES, RESOURCE MONITORS, DATABASES
  ALLOWED_DATABASES = db1;

ALTER FAILOVER GROUP myfg
  ADD db2, db3 TO ALLOWED_DATABASES;

ALTER FAILOVER GROUP myfg
  MOVE DATABASES db3 TO FAILOVER GROUP myfg2;

ALTER FAILOVER GROUP myfg
  SET ALLOWED_DATABASES = NULL;

ALTER FAILOVER GROUP myfg
  REMOVE databases FROM OBJECT_TYPES;

ALTER FAILOVER GROUP myfg
  SET REPLICATION_SCHEDULE = '15 MINUTE';

ALTER FAILOVER GROUP myfg REFRESH;

ALTER FAILOVER GROUP myfg PRIMARY;

ALTER FAILOVER GROUP myfg SUSPEND;