SHOW ACCOUNTS¶
管理アカウント を除く、組織内のすべてのアカウントをリストします。
- こちらもご参照ください。
構文¶
SHOW ACCOUNTS [ HISTORY ] [ LIKE '<pattern>' ]
パラメーター¶
HISTORYオプションには、まだ削除されていないドロップされたアカウントも含まれます。SHOW ACCOUNTS HISTORY の出力には、ドロップされたアカウントに関連する追加列が含まれます。
デフォルト: 値なし(ドロップされたテーブルは出力に 含まれない)
LIKE 'pattern'オプションで、オブジェクト名でコマンド出力をフィルタリングします。フィルターは、 SQL ワイルドカード文字(
%および_)をサポートする、 大文字と小文字を区別しない パターンマッチングを使用します。たとえば、次のパターンは 同じ 結果を返します。
... LIKE '%testing%' ...... LIKE '%TESTING%' .... デフォルト: 値なし(フィルタリングは出力に非適用)。
出力¶
コマンド出力では、グローバルアカウントのプロパティとメタデータが次の列に表示されます。
列 |
説明 |
|---|---|
|
組織の名前。 |
|
組織内のアカウントを識別するユーザー定義の名前。 |
|
アカウントが配置されている リージョングループ。注: この列は、複数のリージョングループにまたがる組織に対してのみ表示されます。 |
|
アカウントが配置されているSnowflake Region。Snowflake Regionは、他のSnowflake Regionから分離されたクラウドプラットフォームリージョン内の別個の場所です。Snowflake Regionは、マルチテナントまたはシングルテナント(Virtual Private Snowflakeアカウントの場合)にすることができます。 |
|
アカウントの Snowflake Edition。 |
|
優先的なSnowflakeアカウント URL。これには、organization_nameとaccount_nameの値が含まれます。 |
|
アカウントが作成された日時。 |
|
アカウントのコメント。 |
|
アカウントのシステム割り当て識別子。 |
|
region_nameとaccount_locatorを含むレガシーSnowflakeアカウント URL 構文。 |
|
アカウントによって作成された 管理アカウント の数を示します。 |
|
消費請求エンティティの名前。 |
|
マーケットプレイスのコンシューマー請求エンティティの名前。 |
|
マーケットプレイスプロバイダーの請求エンティティの名前。 |
|
アカウント名の変更時に元の アカウント URL が保存されていた場合は、元の URL を提供します。元のアカウント URL がドロップされた場合、アカウント名が変更されても値は NULL です。 |
|
アカウントで ORGADMIN ロール が有効になっているかどうかを示します。TRUE の場合、ロールは有効です。 |
|
アカウントが最後にドロップされた日時。 |
|
アカウントが永久に削除される予定の日時。アカウントは予定時刻後、1時間以内に削除されます。 |
|
アカウントが最後に復元された日時。 |
|
アカウント名の変更時に元のアカウント URL が保存されていた場合は、元のアカウント URL が保存された日時を指定します。 |
|
アカウント名の変更時に元のアカウント URL が保存されていた場合は、元の URL を使用してアカウントに最後にアクセスした時刻を示します。 |
|
新しい アカウント URL を作成する方法でアカウントの組織が変更され、元のアカウント URL が保存された場合は、元のアカウント URL を提供します。元のアカウント URL がドロップされた場合、組織が変わっても値は NULL です。 |
|
新しいアカウント URL を作成する方法でアカウントの組織が変更され、元のアカウント URL が保存された場合は、元のアカウント URL が保存された日時を提供します。 |
|
新しいアカウント URL を作成する方法でアカウントの組織が変更され、元のアカウント URL が保存された場合は、元のアカウント URL を使用してアカウントに最後にアクセスした時刻を示します。 |
|
アカウントが別の組織に移された場合は、その組織名を提供します。 |
|
アカウントが別の組織に移された日時。 |
|
新しいアカウント URL を作成する方法でアカウントの組織が変更され、元のアカウント URL が保存された場合は、元のアカウント URL がドロップされる日時を提供します。ドロップされた URLs はアカウントへのアクセスには使用できません。 |
|
アカウントがイベントアカウントであるかどうかを示します。詳細については、 Use logging and event tracing for an app をご参照ください。 |
|
アカウントが 組織アカウント かどうかを示します。 |
アクセス制御の要件¶
組織管理者 がこのコマンドを実行すると、出力にはすべての列が含まれます。
次の権限を持つロールを使用してコマンドを実行することもできますが、列のサブセットのみが返されます。
CREATE LISTING
CREATE DATA EXCHANGE LISTING
CREATE ORGANIZATION LISTING
使用上の注意¶
このコマンドの実行には、稼働中のウェアハウスは必要ありません。
このコマンドは、現在のユーザーの現在のロールに少なくとも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 で対応するビュー(存在する場合)をクエリします。
例¶
名前が myaccount で始まるすべてのアカウントを表示します。
SHOW ACCOUNTS LIKE 'myaccount%';