ALTER FAILOVER GROUP¶
既存の フェールオーバーグループ のプロパティを変更します。
ソースアカウントから、次のアクションを実行できます。
フェールオーバーグループの名前を変更する。
複製とフェールオーバーが有効になっている指定されたオブジェクト型のリストをリセットする。
セカンダリフェールオーバーグループの自動更新の複製スケジュールを設定または更新する。
次の型のアカウントオブジェクトをフェールオーバーグループに追加、またはフェールオーバーグループから削除する。
データベース
共有
セキュリティの統合
API 統合
特定の種類の通知統合(統合複製 を参照)
複製とフェールオーバーが有効になっているターゲットアカウントを追加または削除する。
共有またはデータベースを別のフェールオーバーグループに移動する。
ターゲットアカウントから、次のアクションを実行できます。
ソースアカウントからターゲットアカウントのオブジェクトを更新する。
セカンダリフェールオーバーグループをプライマリに昇格する(つまり、オブジェクトのフェールオーバーグループをフェールオーバーする)。
スケジュールされた複製を一時停止する。
スケジュールされた複製を再開する。
- こちらもご参照ください。
CREATE FAILOVER GROUP、 DROP FAILOVER GROUP、 SHOW FAILOVER GROUPS
構文¶
ソースアカウント
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_databases
プロパティは NULL に設定されます。同じ動作が共有にも当てはまります。移動先グループの
object_types
リストに移動先のオブジェクト型(databases
またはshares
)がない場合は、オブジェクトを移動する前に、移動先グループに明示的に追加する必要があります。
複製が有効になっている組織内のアカウントのリストを取得するには、 SHOW REPLICATION ACCOUNTS コマンドを使用します。
組織内のフェールオーバーグループのリストを取得するには、 SHOW FAILOVER GROUPS を使用します。
メタデータについて、
注意
Snowflakeサービスを使用する場合、お客様は、個人データ(ユーザーオブジェクト向け以外)、機密データ、輸出管理データ、またはその他の規制されたデータがメタデータとして入力されていないことを確認する必要があります。詳細については、 Snowflakeのメタデータフィールド をご参照ください。
例¶
ソースアカウントから実行¶
ソースアカウントからの指定されたオブジェクトの複製とフェールオーバーが有効になっている、ターゲットアカウントのリストに myorg.myaccount3
を追加します。
ALTER FAILOVER GROUP myfg ADD myorg.myaccount3 TO ALLOWED_ACCOUNTS;
ソースアカウントで複製用のオブジェクト型リストをリセットし、データベース db1
を追加します。
ALTER FAILOVER GROUP myfg SET
OBJECT_TYPES = USERS, ROLES, WAREHOUSES, RESOURCE MONITORS, DATABASES
ALLOWED_DATABASES = db1;
データベース db2
と db3
をデータベースのリストに追加します。
ALTER FAILOVER GROUP myfg
ADD db2, db3 TO ALLOWED_DATABASES;
データベース db3
を別のフェールオーバーグループ myfg2
に移動します。
ALTER FAILOVER GROUP myfg
MOVE DATABASES db3 TO FAILOVER GROUP myfg2;
myfg
のデータベース db2
を現在データベースがない別のフェールオーバーグループ myfg3
に移動します。
最初に
databases
をobject_types
に追加します。ALTER FAILOVER GROUP myfg3 SET OBJECT_TYPES = DATABASES, SHARES;
db2
をmyfg3
に移動します。ALTER FAILOVER GROUP myfg MOVE DATABASES db2 TO FAILOVER GROUP myfg3;
複製とフェールオーバーのために、ソースアカウントのデータベースのリストからすべてのデータベースを削除します。
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';
ターゲットアカウントから実行¶
ターゲットアカウントのフェールオーバーグループ myfg
のオブジェクトを更新します。
ALTER FAILOVER GROUP myfg REFRESH;
現在のターゲットアカウントのセカンダリフェールオーバーグループをプライマリに昇格します。
ALTER FAILOVER GROUP myfg PRIMARY;
自動更新を一時停止します。
ALTER FAILOVER GROUP myfg SUSPEND;