catalog_type = 'horizon'으로 설정된 DataLakeCatalog 데이터베이스 엔진을 사용하여 ClickHouse에서 Snowflake 관리형 Iceberg 테이블을 읽고 쓸 수 있습니다.
Horizon은 Snowflake Open Catalog / 자체 호스팅 Polaris와 관련은 있지만 동일한 것은 아닙니다.
이 기능은 베타이므로 다음을 사용하여 활성화하십시오.
SET allow_experimental_database_iceberg = 1;
(ClickHouse 버전에 따라 SET allow_database_iceberg = 1;을 사용합니다).사전 요구 사항
- Snowflake 관리형 Iceberg 테이블이 있는 Snowflake 계정
- Horizon Iceberg REST endpoint:
https://<organization>-<account>.snowflakecomputing.com/polaris/api/catalog - Iceberg 테이블에 대한 권한이 있는 Snowflake 역할(INSERT를 수행하려면 쓰기 권한도 필요)
- 다음 중 하나를 사용하는 인증:
- 프로그래밍 방식의 액세스 토큰 (PAT)
- 액세스 토큰으로 교환되는 키 쌍 JWT
- 외부 OAuth 액세스 토큰(bearer
auth_header로 사용)
- ClickHouse에서 액세스할 수 있는 객체 스토리지(vended 자격 증명 권장)
- DataLakeCatalog Iceberg를 지원하는 ClickHouse
연결 생성
옵션 A: 프로그래밍 방식의 액세스 토큰(권장)
warehouse에는 Snowflake 가상 웨어하우스가 아닌 Snowflake 데이터베이스 이름을 지정해야 합니다.
따옴표로 묶지 않은 Snowflake 식별자는 대문자로 표기합니다.
옵션 B: 사전 교환한 Bearer 액세스 토큰
Iceberg 테이블 쿼리
실험적 테이블 네임스페이스를 활성화하지 않는 한, 네임스페이스(schema)와 테이블은 일반적으로
`SCHEMA.table` 형식으로 지정합니다.쓰기 경로
CREATE TABLE 구문은 사용 중인 버전에서 REST 카탈로그에 지원되는 ClickHouse Iceberg / DataLakeCatalog 쓰기 기능에 따라 달라지며, Snowflake 권한 관련 실패는 카탈로그 HTTP 오류로 표시됩니다.