Mesclagem na leitura com exclusão posicional de arquivos para tabelas Apache Iceberg™ v2 gerenciadas pelo Snowflake (pendente)¶
Atenção
Essa alteração de comportamento faz parte do pacote 2026_03.
Para saber o status atual do pacote, consulte Histórico do pacote.
- Antes da mudança:
Para tabelas Apache Iceberg™ gerenciadas pelo Snowflake no Iceberg v2, o Snowflake não grava arquivos de exclusão posicional para mesclagem na leitura quando você executa instruções DELETE, UPDATE ou MERGE. O Snowflake usa cópia na gravação para essas operações.
- Após a mudança:
Quando o pacote de alterações de comportamento 2026_03 estiver habilitado em sua conta, as tabelas Apache Iceberg™ gerenciadas pelo Snowflake no Iceberg v2 usarão mesclagem na leitura com arquivos de exclusão posicional por padrão para DELETE, UPDATE e MERGE quando
ENABLE_ICEBERG_MERGE_ON_READforTRUE, que é o padrão do sistema. O Snowflake grava arquivos de exclusão posicional junto com seus arquivos de dados no local de armazenamento Iceberg da tabela. Esse comportamento corresponde à forma como o Snowflake já usa arquivos de exclusão posicional para tabelas Iceberg v2 gerenciadas externamente quando a mesclagem na leitura está habilitada.Para desativar a mesclagem na leitura e usar a cópia na gravação para essas operações DML, defina o parâmetro
ENABLE_ICEBERG_MERGE_ON_READcomoFALSEno nível da tabela, do esquema ou do banco de dados. Para obter mais informações, consulte ENABLE_ICEBERG_MERGE_ON_READ.Compatibilidade com mecanismos de consulta externos
Os arquivos de exclusão posicional exigem suporte da versão do formato Iceberg em seu mecanismo externo. Se você usar um mecanismo de consulta externo que dependa de uma versão do Iceberg anterior à v2, esse mecanismo poderá não oferecer suporte a arquivos de exclusão posicional e poderá não conseguir ler os metadados da tabela para suas tabelas Iceberg v2 gerenciadas pelo Snowflake depois que o Snowflake gravar arquivos de exclusão posicional.
Antes que a alteração entre em vigor em suas contas de produção, faça o seguinte:
Confirme se todos os mecanismos de consulta externos que você usa para ler tabelas Apache Iceberg™ v2 gerenciadas pelo Snowflake são compatíveis com arquivos de exclusão posicional (Iceberg v2 ou posterior).
Se algum mecanismo não for compatível com arquivos de exclusão posicional, atualize-o para uma versão baseada no Iceberg v2 ou posterior ou defina
ENABLE_ICEBERG_MERGE_ON_READcomoFALSEpara as tabelas relevantes (ou esquema ou banco de dados que as contém) para que o Snowflake continue usando a cópia na gravação e não grave arquivos de exclusão posicional.
Para obter mais informações sobre arquivos de exclusão posicional, mesclagem na leitura e parâmetros relacionados no Snowflake, consulte Use as exclusões em nível de linha.
Ref: 2279