SHOW USERS

システム内のすべてのユーザーをリストします。

こちらもご参照ください。

CREATE USER、 ALTER USER、 DROP USER、 DESCRIBE USER

構文

SHOW [ TERSE ] USERS
[ LIKE '<pattern>' ]
[ STARTS WITH '<name_string>' ]
[ LIMIT <rows> ]
[ FROM '<name_string>' ]
Copy

パラメーター

TERSE

オプションで、出力列のサブセットのみを返します。

| name | created_on | display_name | first_name | last_name | email | org_identity | comment | has_password | has_rsa_public_key |
Copy

デフォルト: 値なし（出力にすべての列を含む）。

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' サブ句は、結果の「カーソル」として効果的に機能します。これにより、指定された文字列と一致するオブジェクト名を持つ最初の行に続く指定された行数を取得できます。

  • 文字列は一重引用符で囲む必要があり、 大文字と小文字を区別します。

  • 文字列に完全なオブジェクト名を含める必要はありません。部分的な名前がサポートされています。

デフォルト：値なし（出力に制限は適用されない）

注釈

FROM 'name_string' 句と STARTS WITH 'name_string' 句の両方をサポートする SHOW コマンドの場合、同じステートメントでこれらの両方の句を組み合わせることができます。ただし、両方の条件を満たしている必要があります。そうでない場合、互いにキャンセルされ、結果が返されません。

さらに、オブジェクトは名前の辞書式順序で返されるため、 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 関数を使用できます。この関数は、出力をクエリ可能なテーブルとして扱います。

言語: 日本語