다음을 통해 공유

SHOW GROUPS

  • 아티클

적용 대상:예로 표시된 확인 Databricks SQL 예로 표시된 확인 Databricks Runtime

선택적으로 제공된 정규식 패턴과 일치하는 그룹을 나열합니다. 패턴을 제공하지 않으면 시스템의 모든 그룹이 나열됩니다. 선택적으로 identifier을 제공하여 특정 사용자 또는 그룹이 속한 그룹만 표시할 수 있습니다.

보안 주체가 WITH {USER | GROUP}를 사용하여 제공된 경우, columndirectGroup에서 null이 아닌 불리언 값은 해당 보안 주체의 멤버 자격을 나타냅니다.

  • TRUE: 보안 주체가 그룹의 직접 멤버입니다.
  • FALSE: 보안 주체가 그룹의 간접 멤버입니다.

WITH {USER | GROUP}을 사용하지 않으면 directGroup은 항상 NULL입니다.

구문

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

Parameters

  • 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