다음을 통해 공유


SHOW GROUPS

적용 대상:체크 표시된 예 Databricks SQL 체크 표시된 예 Databricks Runtime

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

이 명령을 실행하려면 관리자여야 합니다.

구문

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

매개 변수

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