Apache Iceberg™ REST 카탈로그에 대한 카탈로그 통합 구성

Apache Iceberg™ REST 카탈로그 통합 을 통해 Snowflake는 오픈 소스 Apache Iceberg REST OpenAPI 사양 을 준수하는 원격 카탈로그에서 관리되는 Apache Iceberg™ 테이블 에 액세스할 수 있습니다.

Snowflake는 Iceberg REST 카탈로그 통합을 사용할 때 다음과 같은 추가 기능을 지원합니다.

인증 방법

Snowflake는 Iceberg REST 카탈로그에 대해 다음 인증 방법을 지원합니다.

  • OAuth

  • 무기명 토큰 또는 개인 액세스 토큰(PAT)

  • 서명 버전 4(SigV4)

지원되는 인증 방법은 카탈로그 소스 에 따라 다릅니다.

자격 증명 순환

카탈로그 통합을 위한 자격 증명을 교체하려면 ALTER CATALOG INTEGRATION 명령을 사용하여 Snowflake가 원격 카탈로그 인증에 사용하는 자격 증명을 업데이트할 수 있습니다.

예:

ALTER CATALOG INTEGRATION my_cat_int SET
  REST_AUTHENTICATION (
    OAUTH_CLIENT_SECRET = 'myNewSecret'
  );

연결 옵션

이 섹션에서는 Iceberg REST 카탈로그의 연결 옵션에 대해 설명합니다.

발급된 자격 증명

외부 볼륨 뿐만 아니라 Snowflake는 Iceberg REST 카탈로그에 대해 다음과 같은 연결 옵션을 지원합니다.

지원되는 연결 옵션은 카탈로그 소스 에 따라 다릅니다.

비공개 연결

Snowflake는 :doc:`비공개 연결</user-guide/tables-iceberg-configure-catalog-integration-rest-private>`을 통해 Iceberg REST 카탈로그에 연결을 지원합니다.

그러나 비공개 연결을 통해 카탈로그에 연결할 때는 외부 볼륨을 사용하여 카탈로그 데이터에 연결해야 합니다.

지원되는 연결 옵션은 카탈로그 소스 에 따라 다릅니다.

카탈로그 소스

Snowflake는 Iceberg REST 사양을 준수하는 모든 외부 카탈로그 서버를 지원합니다.

다음 항목에서는 일반적으로 사용되는 REST 카탈로그에 대한 예제를 제공합니다.

원격 카탈로그 찾아보기

Iceberg REST 에 대한 카탈로그 통합을 생성한 후에는 다음 Snowflake 시스템 함수를 사용하여 카탈로그의 네임스페이스 및 테이블을 탐색할 수 있습니다.

테이블을 Iceberg REST 카탈로그 통합으로 마이그레이션

Iceberg REST에 대한 카탈로그 통합을 생성한 후 필요한 경우 표준 Snowflake 데이터베이스의 외부 관리형 Iceberg 테이블과 연결된 카탈로그 통합을 생성한 카탈로그 통합으로 바꿀 수 있습니다. 자세한 지침은 SYSTEM$SET_CATALOG_INTEGRATION 섹션을 참조하십시오.

카탈로그 연결 데이터베이스 만들기

Iceberg REST에 대한 카탈로그 통합을 생성한 후 카탈로그 연결 데이터베이스를 생성하여 원격 Iceberg REST 카탈로그에서 Snowflake로 데이터를 가져올 수 있습니다. 카탈로그 연결 데이터베이스를 생성할 때, 생성한 카탈로그 통합의 이름을 카탈로그로 지정합니다.

카탈로그 연결 데이터베이스는 원격 카탈로그의 네임스페이스 및 테이블을 자동으로 검색하고 동기화된 상태를 유지합니다. 기존 Iceberg 에코시스템과의 완전한 상호 운용성을 유지하면서 카탈로그 연결 데이터베이스를 사용하여 Snowflake에서 원격 카탈로그의 테이블을 읽고 쓸 수 있습니다. 자세한 내용은 다음 항목을 참조하십시오.