DROP CATALOG INTEGRATION

계정에서 카탈로그 통합(Catalog Integration)을 제거하는 명령어입니다.

출처: 문서

본문

DROP CATALOG INTEGRATION은 계정에서 카탈로그 통합을 제거합니다. 관련 명령어로 CREATE CATALOG INTEGRATION, ALTER CATALOG INTEGRATION, SHOW CATALOG INTEGRATIONS, DESCRIBE CATALOG INTEGRATION이 있어요.

구문 (Syntax)

DROP CATALOG INTEGRATION [ IF EXISTS ] <name>

파라미터 (Parameters)

name — 삭제할 카탈로그 통합의 식별자를 지정합니다. 식별자에 공백, 특수 문자 또는 대소문자 혼합 문자가 포함된 경우 전체 문자열을 큰따옴표로 감싸야 합니다. 큰따옴표로 감싼 식별자는 대소문자를 구분합니다(예: "My Catalog").

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

이 작업을 실행하는 역할은 최소한 OWNERSHIP 권한(객체: Integration (catalog))이 있어야 합니다. OWNERSHIP은 객체에 대한 특별한 권한으로, 객체를 생성한 역할에 자동으로 부여되지만 소유 역할(또는 MANAGE GRANTS 권한이 있는 역할)이 GRANT OWNERSHIP으로 이전할 수 있습니다.

지정된 권한 집합으로 커스텀 역할을 만드는 방법은 Creating custom roles을, securable 객체에 대한 역할과 권한 부여에 관한 일반 정보는 Overview of Access Control을 참고하세요.

사용 참고 사항 (Usage notes)

삭제된 카탈로그 통합은 복구할 수 없습니다. 다시 생성해야 합니다.
IF EXISTS 절을 지정하고 대상 객체가 존재하지 않으면, 명령어는 오류를 반환하지 않고 성공적으로 완료됩니다.
하나 이상의 Apache Iceberg™ 테이블이 카탈로그 통합과 연결되어 있으면 카탈로그 통합을 삭제하거나 교체할 수 없습니다.
카탈로그 통합에 의존하는 테이블을 보려면 SHOW ICEBERG TABLES 명령어와 catalog_name 컬럼을 기준으로 필터링하는 파이프 연산자(->>) 쿼리를 사용할 수 있습니다.
참고: 컬럼 식별자(catalog_name)는 대소문자를 구분합니다. SHOW ICEBERG TABLES 출력에 나타나는 그대로 컬럼 식별자를 지정하세요.

예를 들어:

SHOW ICEBERG TABLES
  ->> SELECT *
        FROM $1
        WHERE "catalog_name" = 'my_catalog_integration_1';

예제 (Examples)

카탈로그 통합을 삭제합니다.

DROP CATALOG INTEGRATION myInt;

카탈로그 통합을 다시 삭제하되, 통합이 존재하지 않아도 오류를 발생시키지 않습니다.

DROP CATALOG INTEGRATION IF EXISTS myInt;

DROP CATALOG INTEGRATION