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 ]

パラメーター

  • user_principal

    指定したユーザーを含むグループのみを表示します。

  • group_principal

    指定したグループを含むグループのみを表示します。

  • 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