Snowflake에서 Apache Iceberg™ 테이블 생성¶

Snowflake 관리¶

Snowflake를 카탈로그로 사용하여 Iceberg 테이블을 만들려면 Snowflake가 테이블 데이터와 메타데이터를 쓸 수 있는 외부 볼륨 과 기본 위치(외부 볼륨의 디렉터리)를 지정해야 합니다. 외부 볼륨 생성에 대한 지침은 외부 볼륨 구성 섹션을 참조하십시오.

테이블 열을 정의하려면 Iceberg 데이터 타입을 사용할 수 있습니다. 자세한 내용은 Apache Iceberg™ 테이블의 데이터 타입 섹션을 참조하십시오.

다음 예제에서는 Snowflake를 Iceberg 카탈로그로 사용하여 Iceberg 테이블을 생성합니다.

CREATE OR REPLACE ICEBERG TABLE my_iceberg_table (
    boolean_col boolean,
    int_col int,
    long_col long,
    float_col float,
    double_col double,
    decimal_col decimal(10,5),
    string_col string,
    fixed_col fixed(10),
    binary_col binary,
    date_col date,
    time_col time,
    timestamp_ntz_col timestamp_ntz(6),
    timestamp_ltz_col timestamp_ltz(6)
  )
  CATALOG = 'SNOWFLAKE'
  EXTERNAL_VOLUME = 'my_ext_vol'
  BASE_LOCATION = 'my/relative/path/from/extvol';

Snowflake를 카탈로그로 사용하는 테이블을 만들면 다음과 같은 작업을 수행할 수 있습니다.

• 스냅샷 생성하기

• 테이블 쿼리하기

• 테이블 업데이트하기

자세한 내용은 Apache Iceberg™ 테이블 관리하기 섹션을 참조하십시오.

외부 카탈로그¶

외부 카탈로그를 사용하거나 카탈로그를 전혀 사용하지 않는 Iceberg 테이블을 생성하려면 외부 볼륨 과 카탈로그 통합 을 지정해야 합니다. 외부 Iceberg 카탈로그를 사용하는 경우 추가 매개 변수를 지정해야 할 수도 있습니다. 예를 들어 AWS Glue를 카탈로그로 사용할 때 카탈로그 테이블 이름을 지정해야 합니다.

외부 카탈로그를 사용하는 Iceberg 테이블을 생성하면 Snowflake가 초기 메타데이터를 새로 고칩니다. 또한 ALTER ICEBERG TABLE … REFRESH 명령을 사용하여 테이블 메타데이터를 수동으로 새로 고쳐 메타데이터를 최신 테이블 변경 사항과 동기화할 수도 있습니다. 자세한 내용은 테이블 메타데이터 새로 고침 섹션을 참조하십시오.

CREATE ICEBERG TABLE myGlueTable
  EXTERNAL_VOLUME='glueCatalogVolume'
  CATALOG='glueCatalogInt'
  CATALOG_TABLE_NAME='myGlueTable';

CREATE ICEBERG TABLE myIcebergTable
  EXTERNAL_VOLUME='icebergMetadataVolume'
  CATALOG='icebergCatalogInt'
  METADATA_FILE_PATH='path/to/metadata/v1.metadata.json';

CREATE ICEBERG TABLE my_delta_iceberg_table
  CATALOG = delta_catalog_integration
  EXTERNAL_VOLUME = delta_external_volume
  BASE_LOCATION = 'relative/path/from/ext/vol/';

CREATE OR REPLACE ICEBERG TABLE my_iceberg_table
  EXTERNAL_VOLUME = 'my_external_volume'
  CATALOG = 'my_rest_catalog_integration'
  CATALOG_TABLE_NAME = 'my_remote_table';