SHOW REPLICATION DATABASES¶
アカウント内のすべてのプライマリデータベースとセカンダリデータベース(つまり、複製が有効になっているすべてのデータベース)をリストし、各アカウントが存在する リージョン を示します。
- こちらもご参照ください。
構文¶
SHOW REPLICATION DATABASES [ LIKE '<pattern>' ]
[ WITH PRIMARY <account_identifier>.<primary_db_name> ]
パラメーター¶
LIKE 'pattern'オプションで、オブジェクト名でコマンド出力をフィルタリングします。フィルターは、 SQL ワイルドカード文字(
%および_)をサポートする、 大文字と小文字を区別しない パターンマッチングを使用します。たとえば、次のパターンは 同じ 結果を返します。
... LIKE '%testing%' ...... LIKE '%TESTING%' .... デフォルト: 値なし(フィルタリングは出力に非適用)。
WITH PRIMARY {account_identifier}.{primary_db_name}コマンドのスコープを指定します。コマンドのスコープは、コマンドが指定されたプライマリデータベースの記録のみを一覧表示するかどうかを決定します。
account_identifierは、org_name.account_nameまたはsnowflake_region.account_locatorの形式にすることができます。詳細については 複製およびフェールオーバーのアカウント識別子 をご参照ください。
出力¶
コマンド出力では、次の列にプライマリおよびセカンダリデータベースプロパティとメタデータが提供されます。複数の リージョングループ にまたがる組織のコマンド出力には、追加の region_group 列が含まれています。
列 |
説明 |
|---|---|
|
アカウントが配置されている リージョングループ。注: この列は、複数のリージョングループにまたがる組織に対してのみ表示されます。 |
|
データベースを保存するアカウントがあるSnowflake Region。Snowflake Regionは、他のSnowflake Regionから分離されたクラウドプラットフォームリージョン内の個別の場所です。Snowflake Regionは、マルチテナントまたはシングルテナント(Virtual Private Snowflakeアカウントの場合)にすることができます。 |
|
データベースが作成された日時。 |
|
データベースが保存されているアカウントの名前。 |
|
データベースの名前。 |
|
データベースのコメント。 |
|
データベースがプライマリデータベースであるかどうか。それ以外の場合は、セカンダリデータベース。 |
|
リージョン、アカウント、データベース名を含むプライマリデータベースの完全修飾名。 |
|
|
|
|
|
Snowflake組織の名前。 |
|
リージョン内のアカウントロケーター。 |
使用上の注意¶
データベースに対する任意の権限を持つロールの結果を返します(例えば、 USAGE または MONITOR)。
このコマンドの実行には、稼働中のウェアハウスは必要ありません。
このコマンドは、現在のユーザーの現在のロールに少なくとも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, specifySELECT "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.
コマンドは、コマンドを実行するために使用されるロールのアクセス権限によって決定された通り、指定されたオブジェクトタイプに対して 最大 1万件の記録を返します。1万件を超える記録は、フィルターを適用しても返されません。
1万件を超える記録が存在する結果を表示するには、 Snowflake Information Schema で対応するビュー(存在する場合)をクエリします。
例¶
名前が mydb で始まるすべての複製データベースを表示します。
SHOW REPLICATION DATABASES LIKE 'mydb%';
myorg.account1.mydb1 組織、アカウント、およびプライマリデータベースのそれぞれのセカンダリデータベースすべてを表示します。
SHOW REPLICATION DATABASES WITH PRIMARY myorg.account1.mydb1;