적용 대상:
Databricks SQL
Databricks Runtime
선택적으로 제공된 정규식 패턴과 일치하는 그룹을 나열합니다. 패턴을 제공하지 않으면 명령에 시스템의 모든 그룹이 나열됩니다. 필요에 따라 식별자를 제공하여 특정 사용자 또는 그룹이 속한 그룹만 표시할 수 있습니다.
이 명령을 실행하려면 관리자여야 합니다.
구문
SHOW GROUPS [ WITH USER user_principal |
WITH GROUP group_principal ]
[ [ LIKE ] regex_pattern ]
매개 변수
-
지정된 사용자를 포함하는 그룹만 표시합니다.
-
지정된 그룹을 포함하는 그룹만 표시합니다.
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