SHOW CATALOG INTEGRATIONS
SHOW CATALOG INTEGRATIONS
계정의 카탈로그 통합(catalog integrations)을 나열하는 명령이에요. 이 명령은 통합의 메타데이터와 속성을 반환해요.
출처: 문서
본문
구문 (Syntax)
SHOW CATALOG INTEGRATIONS [ LIKE '<pattern>' ]
파라미터
- LIKE 'pattern' — 객체 이름으로 명령 출력을 선택적으로 필터링해요. 대소문자 무시 패턴 매칭을 사용하며 SQL 와일드카드 문자(%와 _)를 지원해요. 기본값: 없음.
접근 제어 요구사항 (Access control requirements)
이 SQL 명령을 실행하는 역할은 최소한 다음 권한 중 하나가 있어야 해요:
| Privilege | Object | Notes |
|---|---|---|
| USAGE | Integration | |
| OWNERSHIP | Integration | OWNERSHIP은 객체를 생성한 역할에 자동으로 부여되는 특별한 권한이지만, 소유 역할(또는 MANAGE GRANTS 권한이 있는 역할)이 GRANT OWNERSHIP 명령으로 다른 역할에 이전할 수 있어요. |
출력 (Output)
| Column | Description |
|---|---|
| name | 카탈로그 통합의 이름. |
| enabled | 카탈로그 통합이 Apache Iceberg™ 테이블에 사용 가능한지 여부. |
| type | 통합의 유형. 값은 항상 CATALOG. |
| category | 통합의 범주. 값은 항상 CATALOG. |
| comment | 통합에 대한 주석을 지정하는 문자열(리터럴). |
| created_on | 카탈로그 통합이 생성된 날짜와 시간. |
사용 메모 (Usage notes)
- 이 명령은 실행에 실행 중인 웨어하우스가 필요하지 않아요.
- 이 명령은 현재 사용자의 현재 역할에 최소한 하나의 접근 권한이 부여된 객체만 반환해요.
MANAGE GRANTS접근 권한은 보유자가 계정의 모든 객체를 볼 수 있게 암시적으로 허용해요. 기본적으로 계정 관리자(ACCOUNTADMIN)와 보안 관리자(SECURITYADMIN)만 이 권한을 가져요.- 이 명령의 출력을 후처리하려면 파이프 연산자(
->>)나RESULT_SCAN함수를 사용할 수 있어요. 출력 열 이름은 소문자이므로 큰따옴표로 묶은 식별자를 사용해요(예:SELECT "type").
예시 (Examples)
모든 카탈로그 통합을 표시해요:
SHOW CATALOG INTEGRATIONS;
이름이 demo로 시작하고 볼 권한이 있는 모든 카탈로그 통합을 표시해요:
SHOW CATALOG INTEGRATIONS LIKE 'demo%';