次の方法で共有


SHOW GROUPS

適用対象:「はい」のチェック マーク Databricks SQL のチェックをオン Databricks Runtime

オプションで指定された正規表現パターンに一致するグループを一覧表示します。 パターンを指定しない場合、コマンドはシステム内のすべてのグループを一覧表示します。 必要に応じて、特定のユーザーまたはグループが属するグループのみを表示する識別子を指定できます。

このコマンドを実行するには、管理者である必要があります。

構文

SHOW GROUPS [ WITH USER user_principal |
              WITH GROUP group_principal ]
            [ [ LIKE ] regex_pattern ]

パラメーター

  • user_principal

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

  • group_principal

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

  • regex_pattern

    ステートメントの結果をフィルター処理するために使用される正規表現パターンが制限された STRING リテラル。

    • パターンの開始位置と末尾にある * は、substring に一致します。
    • パターンの末尾にある * のみが、グループの開始と一致します。
    • | は、複数の正規表現を分離し、そのいずれかが一致する可能性があります。
    • パターンの一致では、大文字と小文字は区別されません。

収益

次の列を含むテーブル。

  • name STRING NOT NULL

    グループの名前。

  • directGroup BOOLEAN

    • TRUE: プリンシパルは、グループの直接メンバーです。
    • FALSE: プリンシパルは、グループの間接メンバーです。
    • NULL: プリンシパルが指定されていない場合。

-- 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