共用方式為

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具有有限正則表示式模式的常值，用來篩選語句的結果。

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

退貨

具有下列資料行的數據表：

  • 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
  • Last updated on