SHOW GROUPS
適用対象: Databricks SQL Databricks Runtime
オプションで指定された正規表現パターンに一致するグループを一覧表示します。 パターンを指定しない場合、コマンドはシステム内のすべてのグループを一覧表示します。 必要に応じて、特定のユーザーまたはグループが属するグループのみを表示する識別子を指定できます。
WITH {USER | GROUP}
を使用してプリンシパルを指定した場合、列 directGroup
の null 以外のブール値は、プリンシパルのメンバーシップを示します。
TRUE
: プリンシパルは、グループの直接メンバーです。FALSE
: プリンシパルは、グループの間接メンバーです。
WITH {USER | GROUP}
が使用されていない場合、directGroup
は常に NULL
です。
構文
SHOW GROUPS [ WITH USER user_principal |
WITH GROUP group_principal ]
[ [ LIKE ] regex_pattern ]
パラメーター
-
指定したユーザーを含むグループのみを表示します。
-
指定したグループを含むグループのみを表示します。
regex_pattern
ステートメントの結果をフィルター処理するために使用される制限付き正規表現パターンの STRING リテラル。
- パターンの開始位置と末尾にある
*
は、substring に一致します。 - パターンの末尾にある
*
のみが、グループの開始と一致します。 |
は、複数の正規表現を分離し、そのいずれかが一致する可能性があります。- パターンの一致では、大文字と小文字は区別されません。
- パターンの開始位置と末尾にある
例
-- Lists all groups.
> SHOW GROUPS;
name directGroup
------------ -----------
tv_alien NULL
alien NULL
californian NULL
pastafarian NULL
-- Lists groups with name containing with string pattern `rou`.
> SHOW GROUPS LIKE '*al*';
name directGroup
------------ -----------
tv_alien NULL
alien NULL
californian NULL
-- Lists groups with Alf as a member.
> SHOW GROUPS WITH USER `alf@melmak.et`;
name directGroup
------------ -----------
tv_alien true
alien false