SHOW INTEGRATIONS

SHOW INTEGRATIONS

SHOW INTEGRATIONS 명령은 계정의 통합(integration) 목록을 보여주는 명령이에요. 통합의 메타데이터와 속성을 반환해요.

출처: 문서

본문

이 명령은 계정의 통합을 나열해요.

관련 명령: CREATE INTEGRATION, DROP INTEGRATION, ALTER INTEGRATION, DESCRIBE INTEGRATION.

통합 유형별 명령:

구문 (Syntax)

SHOW [ { API | CATALOG | EXTERNAL ACCESS | NOTIFICATION | SECURITY | STORAGE } ] INTEGRATIONS [ LIKE '<pattern>' ]

파라미터 (Parameters)

  • { API | CATALOG | EXTERNAL ACCESS | NOTIFICATION | SECURITY | STORAGE } — 지정한 유형의 통합만 반환해요. 일부 유형에 대한 자세한 내용은 SHOW CATALOG INTEGRATIONS와 SHOW NOTIFICATION INTEGRATIONS를 참고해요.

  • LIKE <pattern> — 명령 출력을 객체 이름으로 필터링해요. 대소문자를 구분하지 않는 패턴 매칭이며 SQL 와일드카드 문자(%와 _)를 지원해요. 기본값: 없음.

접근 제어 요구 사항 (Access control requirements)

이 SQL 명령을 실행하는 역할은 최소한 다음 권한 중 하나를 가져야 해요:

권한 (Privilege) 객체 (Object) 비고
USAGE 통합
OWNERSHIP 통합 객체에 대한 특별 권한으로, 객체를 만든 역할에 자동 부여되며 GRANT OWNERSHIP으로 다른 역할에 이전할 수 있어요.

출력 (Output)

명령 출력은 통합 속성과 메타데이터를 다음 컬럼으로 제공해요:

  • name — 통합 이름.
  • type — 통합 유형.
  • category — 통합 범주.
  • enabled — 통합의 현재 상태. TRUE(활성화) 또는 FALSE(비활성화).
  • comment — 통합에 대한 주석.
  • created_on — 통합이 생성된 날짜·시간.

통합 유형별로 지정할 수 있는 속성에 대한 자세한 내용은 해당 CREATE 명령을 참고해요.

사용 참고 사항 (Usage notes)

  • 현재는 LIKE 파라미터만 지원돼요.
  • 실행에 실행 중인 웨어하우스를 요구하지 않아요.
  • 현재 역할에 하나 이상의 접근 권한이 부여된 객체만 반환해요.
  • MANAGE GRANTS 권한은 보유자가 계정의 모든 객체를 볼 수 있게 해줘요. 기본적으로 ACCOUNTADMIN과 SECURITYADMIN 역할만 이 권한을 가져요.
  • 출력을 후처리하려면 파이프 연산자(|>) 또는 RESULT_SCAN 함수를 사용할 수 있어요. 출력 컬럼을 참조할 때는 컬럼 이름을 큰따옴표로 감싸서 사용해요.

예제 (Examples)

모든 알림 통합을 표시해요:

SHOW NOTIFICATION INTEGRATIONS;

더 알아보기 (Learn more)