SHOW REGIONS¶
アカウントを作成できるすべての リージョン をリストします。このコマンドは、Snowflake Region名、アカウントをホストするクラウドプロバイダー(AWS、Google Cloud Platform、またはMicrosoft Azure)、およびリージョンのクラウドプロバイダーの名前を返します。
- こちらもご参照ください。
構文¶
SHOW REGIONS [ LIKE '<pattern>' ]
パラメーター¶
LIKE 'pattern'オプションで、オブジェクト名でコマンド出力をフィルタリングします。フィルターは、 SQL ワイルドカード文字(
%および_)をサポートする、 大文字と小文字を区別しない パターンマッチングを使用します。たとえば、次のパターンは 同じ 結果を返します。
... LIKE '%testing%' ...... LIKE '%TESTING%' .... デフォルト: 値なし(フィルタリングは出力に非適用)。
出力¶
コマンド出力では、次の列にリージョンプロパティとメタデータが提供されます。複数の リージョングループ にまたがる組織のコマンド出力には、追加の region_group 列が含まれています。
列 |
説明 |
|---|---|
|
アカウントが配置されている リージョングループ。注: この列は、複数のリージョングループにまたがる組織に対してのみ表示されます。 |
|
アカウントが配置されているSnowflake Region。Snowflake Regionは、他のSnowflake Regionから分離されたクラウドプラットフォームリージョン内の別個の場所です。Snowflake Regionは、マルチテナントまたはシングルテナント(Virtual Private Snowflakeアカウントの場合)にすることができます。 |
|
アカウントをホストするクラウドプロバイダーの名前。 |
|
アカウントが存在するリージョン。つまり、リージョンのクラウドプロバイダーの名前。 |
|
人間が読めるクラウドリージョン名。例: |
使用上の注意¶
このコマンドの実行には、稼働中のウェアハウスは必要ありません。
このコマンドは、現在のユーザーの現在のロールに少なくとも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.