SHOW USERS¶
システム内のすべてのユーザーをリストします。
- こちらもご参照ください。
構文¶
SHOW [ TERSE ] USERS
[ LIKE '<pattern>' ]
[ STARTS WITH '<name_string>' ]
[ LIMIT <rows> ]
[ FROM '<name_string>' ]
パラメーター¶
TERSEオプションで、出力列のサブセットのみを返します。
| name | created_on | display_name | first_name | last_name | email | org_identity | comment | has_password | has_rsa_public_key |デフォルト: 値なし（出力にすべての列を含む）。
LIKE 'pattern'オブジェクト名でコマンド出力をフィルターします。フィルターは、 SQL ワイルドカード文字（
%および_）をサポートする、 大文字と小文字を区別しない パターンマッチングを使用します。たとえば、次のパターンは同じ結果を返します。
... LIKE '%testing%' ...... LIKE '%TESTING%' ...
STARTS WITH 'name_string'オプションで、オブジェクト名の先頭に表示される文字に基づいてコマンド出力をフィルタリングします。文字列は一重引用符で囲む必要があり、 大文字と小文字を区別します。
たとえば、次の句は異なる結果を返します。
... STARTS WITH 'B' ...... STARTS WITH 'b' ...
デフォルト: 値なし（フィルタリングは出力に非適用）。
LIMIT rows [ FROM 'name_string' ]オプションで、返される行の最大数を制限すると同時に、結果の「ページネーション」を有効にします。返される実際の行数は、指定された制限より少ない場合があります（例：既存のオブジェクトの数が指定された制限より少ない）。
オプションの
FROM 'name_string'サブ句は、結果の「カーソル」として効果的に機能します。これにより、指定された文字列と一致するオブジェクト名を持つ最初の行に続く指定された行数を取得できます。文字列は一重引用符で囲む必要があり、 大文字と小文字を区別します。
文字列に完全なオブジェクト名を含める必要はありません。部分的な名前がサポートされています。
デフォルト：値なし（出力に制限は適用されない）
注釈
STARTS WITH 'name_string'とFROM 'name_string'の両方は、同じステートメントで組み合わせることができます。ただし、両方の条件を満たしている必要があります。そうでない場合は、相互にキャンセルされ、結果が返されません。さらに、オブジェクトは名前の辞書式順序で返されるため、
FROM 'name_string'は、STARTS WITH 'name_string'によって返される行よりも辞書式の値が大きい行のみを返します。例:
... STARTS WITH 'A' LIMIT ... FROM 'B'は結果を返しません。... STARTS WITH 'B' LIMIT ... FROM 'A'は結果を返しません。... STARTS WITH 'A' LIMIT ... FROM 'AB'は結果を返します（入力文字列に一致する行がある場合）。
使用上の注意¶
いずれのユーザーも SHOW USERS コマンドを実行できます。Snowflakeは、ユーザーがコマンドを実行するために使用する アクティブロール に付与された権限に基づいて出力をフィルターします。コマンドを実行したユーザーは、
name列に記録されている結果のユーザー名を常に表示できます。完全な出力を表示するには、アクティブロールが以下のいずれかを持っている必要があります。ユーザーオブジェクトに対する OWNERSHIP 権限。
アカウントに対する CREATE USER 権限。
アカウントに10,000名を超えるユーザーがいる場合は、次のいずれかのオプションを使用できます。
SHOW USERS;SHOW USERS LIMIT 10000 FROM 'JOE';10,000の後にユーザーを返します。この例では、
JOEはコマンドの最終行のユーザー名です。
このコマンドは、稼働中のウェアハウスを必要としません。
このコマンドの出力を後処理するには、 RESULT_SCAN 関数を使用できます。この関数は、出力をクエリ可能なテーブルとして扱います。