SHOW FAILOVER GROUPS¶

アカウント内のプライマリおよびセカンダリフェールオーバーグループ、さらに自分のアカウントと関連する他のアカウント内のフェールオーバーグループをリストします。

他のアカウントに対して、

このアカウントへの複製とフェールオーバーが有効になっているプライマリフェールオーバーグループをリストします。
このアカウント内のグループにリンクしているセカンダリフェールオーバーグループをリストします。

こちらもご参照ください。: CREATE FAILOVER GROUP、 ALTER FAILOVER GROUP、 DROP FAILOVER GROUP

構文¶

SHOW FAILOVER GROUPS [ IN ACCOUNT <account> ]

Copy

パラメーター¶

account: アカウントの識別子を指定します。アカウント名は、組織内の一意の識別子です。アカウント名の詳細については、形式1（推奨）: 組織内のアカウント名をご参照ください。

使用上の注意¶

このコマンドを実行するには、フェールオーバーグループに対して次の権限のいずれかを持つロールが必要です。
- FAILOVER
- MONITOR
- OWNERSHIP
- REPLICATE
SHOW FAILOVER GROUPS の出力には、型 FAILOVER のグループのみが含まれます。

このコマンドの実行には、稼働中のウェアハウスは必要ありません。
このコマンドは、現在のユーザーの現在のロールに少なくとも1つのアクセス権限が付与されているオブジェクトのみを返します。
MANAGE GRANTS アクセス権限により、所有者はアカウント内のすべてのオブジェクトを暗黙的に参照できます。デフォルトでは、アカウント管理者（ ACCOUNTADMIN ロールを持つユーザー）とセキュリティ管理者（ SECURITYADMIN ロールを持つユーザー）のみが MANAGE GRANTS 権限を持っています。

このコマンドの出力を後処理するには、パイプ演算子（->>）または RESULT_SCAN 関数。どちらのコンストラクトも、出力をクエリできる結果セットとして扱います。

For example, you can use the pipe operator or RESULT_SCAN function to select specific columns from the SHOW command output or filter the rows.

When you refer to the output columns, use double-quoted identifiers for the column names. For example, to select the output column type, specify SELECT "type".

You must use double-quoted identifiers because the output column names for SHOW commands are in lowercase. The double quotes ensure that the column names in the SELECT list or WHERE clause match the column names in the SHOW command output that was scanned.

出力¶

このコマンドは、次の列を返します。

列	説明
`region_group`	アカウントが配置されているリージョングループ。注: この列は、複数のリージョングループにまたがる組織に対してのみ表示されます。
`snowflake_region`	アカウントが配置されているSnowflake Region。Snowflake Regionは、他のSnowflake Regionから分離されたクラウドプラットフォームリージョン内の別個の場所です。Snowflake Regionは、マルチテナントまたはシングルテナント（Virtual Private Snowflakeアカウントの場合）にすることができます。
`created_on`	フェールオーバーグループが作成された日時。
`account_name`	アカウントの名前。
`name`	フェールオーバーグループの名前。
`type`	グループの型。有効な値は `FAILOVER`。
`comment`	コメント文字列。
`is_primary`	フェールオーバーグループがプライマリグループであるかどうかを示します。
`primary`	プライマリグループの名前。
`object_types`	複製とフェールオーバーが有効になっている指定されたオブジェクト型のリスト。
`allowed_integration_types`	複製が有効になっている統合型のリスト。統合が CREATE FAILOVER GROUP または ALTER FAILOVER GROUP コマンドで指定されていない場合でも、Snowflakeは常にこの列を出力に含めます。
`allowed_accounts`	複製とフェールオーバーが有効になっているアカウントのリスト。
`organization_name`	Snowflake組織の名前。
`account_locator`	リージョン内のアカウントロケーター。
`replication_schedule`	更新のスケジュールされた間隔。複製スケジュールが設定されていない場合は NULL。
`secondary_state`	スケジュールされた更新の現在の状態。有効な値は `started` または `suspended`。複製スケジュールが設定されていない場合は NULL。
`next_scheduled_refresh`	スケジュールされた次回更新の日時。
`owner`	フェールオーバーグループに対する OWNERSHIP 権限を持つロールの名前。フェールオーバーグループが別のリージョンにある場合は NULL。
`is_listing_auto_fulfillment_group`	複製グループが:doc:`クロスクラウドの自動フルフィルメント</collaboration/provider-listings-auto-fulfillment>`に使用されている場合は、TRUE。それ以外の場合はFALSEです。

例¶

アカウント myaccount1 内のフェールオーバーグループをリストします。

SHOW FAILOVER GROUPS IN ACCOUNT myaccount1;

+------------------+-------------------------------+--------------+------+----------+---------+------------+-----------------------+---------------------------------------------+---------------------------+----------------------------------------------+-------------------+-------------------+----------------------+-----------------+-------------------------------+------------+-----------------------------------+
| snowflake_region | created_on                    | account_name | name | type     | comment | is_primary | primary               | object_types                                | allowed_integration_types |  allowed_accounts                            | organization_name | account_locator   | replication_schedule | secondary_state | next_scheduled_refresh        | owner      | is_listing_auto_fulfillment_group |
+------------------+-------------------------------+--------------+------+----------+---------+------------+-----------------------+---------------------------------------------+---------------------------+----------------------------------------------+-------------------+-------------------+----------------------+-----------------+-------------------------------+------------+-----------------------------------+
| AWS_US_EAST_1    | 2021-10-25 19:08:15.209 -0700 | MYACCOUNT1   | MYFG | FAILOVER |         | true       | MYORG.MYACCOUNT1.MYFG | DATABASES, ROLES, USERS, WAREHOUSES, SHARES |                           | MYORG.MYACCOUNT1.MYFG,MYORG.MYACCOUNT2.MYFG  | MYORG             | MYACCOUNT1LOCATOR | 10 MINUTE            | NULL            |                               | MYROLE     | false                             |
+------------------+-------------------------------+--------------+------+----------+---------+------------+-----------------------+---------------------------------------------+---------------------------+----------------------------------------------+-------------------+-------------------+----------------------+-----------------+-------------------------------+------------+-----------------------------------+
| AWS_US_WEST_2    | 2021-10-25 19:08:15.209 -0700 | MYACCOUNT2   | MYFG | FAILOVER |         | false      | MYORG.MYACCOUNT1.MYFG |                                             |                           |                                              | MYORG             | MYACCOUNT2LOCATOR | 10 MINUTE            | STARTED         | 2022-03-06 12:10:35.280 -0800 | NULL       | false                             |
+------------------+-------------------------------+--------------+------+----------+---------+------------+-----------------------+---------------------------------------------+---------------------------+----------------------------------------------+-------------------+-------------------+----------------------+-----------------+-------------------------------+------------+-----------------------------------+

Copy