顯示群組

  • 發行項

適用於：檢查標示為是 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 常值，用來篩選語句的結果。

    • * 在模式的開頭和結尾符合子字串。
    • * 只有在模式結尾符合群組的開頭。
    • | 會分隔多個正則表示式，其中任何一個都可以相符。
    • 模式比對不區分大小寫。

範例

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