Criação de uma tabela Iceberg¶

Criação de uma tabela Iceberg com Snowflake como catálogo¶

Para criar uma tabela Iceberg com Snowflake como catálogo, você deve especificar um volume externo e um local base (diretório no volume externo) onde o Snowflake pode gravar dados e metadados da tabela. Para obter instruções sobre como criar um volume externo, consulte Configuração de um volume externo para tabelas Iceberg.

Para definir colunas de tabela, você pode usar tipos de dados Iceberg. Para obter mais informações, consulte Tipos de dados da tabela Iceberg.

O exemplo a seguir cria uma tabela Iceberg com Snowflake como catálogo 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';

Depois de criar uma tabela que usa Snowflake como catálogo, você pode realizar ações como:

• Gerar instantâneos

• Consultar a tabela

• Atualizar a tabela

Para obter mais informações, consulte Gerenciamento de uma tabela Iceberg.

Criação de uma tabela Iceberg com integração de catálogo¶

Para criar uma tabela Iceberg que use um catálogo externo ou nenhum catálogo, você deve especificar um volume externo e uma integração de catálogo. Se você usar um catálogo Iceberg externo, também poderá precisar especificar parâmetros adicionais. Por exemplo, ao usar o AWS Glue como catálogo, você deve especificar um nome de tabela de catálogo.

Quando você cria uma tabela Iceberg com integração de catálogo, o Snowflake executa uma atualização inicial de metadados. Você também pode atualizar manualmente os metadados da tabela usando o comando ALTER ICEBERG TABLE para sincronizar os metadados com as alterações mais recentes da tabela. Para obter mais informações, consulte Atualização manual dos metadados da tabela.

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';