Gerenciar tabelas Apache Iceberg™¶

Exemplo: atualizar uma tabela¶

Você pode usar instruções INSERT e UPDATE para modificar tabelas Iceberg gerenciadas pelo Snowflake.

O exemplo a seguir insere um novo valor em uma tabela Iceberg chamada store_sales e atualiza a coluna cola para 1 se o valor for atualmente -99.

INSERT INTO store_sales VALUES (-99);

UPDATE store_sales
  SET cola = 1
  WHERE cola = -99;

Cópia na gravação vs. fusão na leitura¶

O Iceberg oferece dois modos para configurar como os mecanismos de computação lidam com operações em nível de linha para tabelas gerenciadas externamente. O Snowflake oferece suporte a esses dois modos.

A tabela a seguir descreve quando você pode querer usar cada modo:

Para obter mais informações sobre alterações em nível de linha no Iceberg, consulte Exclusões em nível de linha na documentação do Apache Iceberg.

Considerações e limitações¶

Considere o seguinte ao usar exclusões em nível de linha com tabelas Iceberg gerenciadas externamente:

• O Snowflake apenas oferece suporte à exclusão por posição.

• Para obter o melhor desempenho de leitura ao usar exclusões em nível de linha, execute a compactação regular e a manutenção da tabela para remover arquivos de exclusão antigos. Para obter mais informações, consulte Manter tabelas que usam um catálogo externo.

• Atualmente, os recursos a seguir não são compatíveis quando você usa exclusões em nível de linha:

  • Atualização automatizada

  • Criação de exibições materializadas, otimização de pesquisa ou fluxos em tabelas dinâmicas, tabelas Iceberg dinâmicas ou tabelas Iceberg com exclusões de posição existentes.

  • Tabelas dinâmicas

  • Atualização do instantâneo Iceberg com exclusões de posição em tabelas dinâmicas, tabelas dinâmicas Iceberg ou tabelas Iceberg com exibições materializadas ativas ou excluídas, otimização de pesquisa ou fluxos.

  • Otimização de pesquisa

  • Fluxos

Atualizar os metadados de uma tabela¶

O exemplo a seguir atualiza manualmente os metadados de uma tabela que usa um catálogo externo (por exemplo, AWS Glue ou Delta). A atualização da tabela mantém a tabela sincronizada com quaisquer alterações ocorridas no catálogo remoto.

Com esse tipo de tabela Iceberg, você não precisa especificar um caminho de arquivo de metadados no comando.

ALTER ICEBERG TABLE my_iceberg_table REFRESH;

Para manter uma tabela atualizada automaticamente, você pode configurar a atualização automática. Use o comando ALTER ICEBERG TABLE.

Por exemplo:

ALTER ICEBERG TABLE my_iceberg_table SET AUTO_REFRESH = TRUE;

Atualizar os metadados de uma tabela criada a partir de arquivos Iceberg¶

O exemplo a seguir atualiza manualmente uma tabela criada a partir de arquivos de metadados Iceberg em um local de armazenamento em nuvem externo, especificando o caminho relativo para um arquivo de metadados sem a barra (/) no início. O arquivo de metadados define os dados na tabela após a atualização.

ALTER ICEBERG TABLE my_iceberg_table REFRESH 'metadata/v1.metadata.json';