Comando DESC TABLE, comando SHOW COLUMNS e exibições COLUMNS: adicionar nova coluna SchemaEvolutionRecord

Atenção

Essa mudança de comportamento está no pacote 2023_08.

Para saber o status atual do pacote, consulte Histórico do pacote.

Quando esse pacote estiver ativado, uma nova coluna SchemaEvolutionRecord será adicionada à saída dos seguintes comandos e exibições:

Antes da mudança:

A saída dos comandos e exibições mencionados anteriormente não possui a coluna SchemaEvolutionRecord.

Após a mudança:

A saída dos comandos e exibições mencionados anteriormente adiciona uma nova coluna SchemaEvolutionRecord.

O comando DESC TABLE exibe a coluna SchemaEvolutionRecord para tabelas que têm Evolução do esquema da tabela ativada (ou seja, o parâmetro ENABLE_SCHEMA_EVOLUTION está definido como TRUE). Caso não tenham ocorrido evoluções na tabela, a coluna mostra todos os NULLs.

O comando SHOW COLUMNS e as exibições COLUMNS (Information_schema e Account_usage) sempre exibem a coluna SchemaEvolutionRecord. Caso nenhuma tabela tenha a evolução do esquema habilitada ou nenhuma evolução tenha ocorrido, a coluna mostra todos os NULLs.

Esta nova coluna será definida como NULL quando o usuário modificar manualmente a coluna da tabela após a ocorrência de uma evolução. O registro será restabelecido se ocorrer outra evolução de esquema na coluna.

Nome da coluna

Descrição

SchemaEvolutionRecord

Registra informações sobre a última evolução do esquema acionada para uma determinada coluna da tabela. Esta coluna contém os seguintes subcampos:

  • EvolutionType: o tipo de evolução do esquema acionado (ADD_COLUMN ou DROP_NOT_NULL).

  • EvolutionMode: o mecanismo de ingestão de acionamento (COPY ou SNOWPIPE).

  • FileName: o nome do arquivo que acionou a evolução.

  • TriggeringTime: o tempo aproximado em que a coluna evoluiu.

  • QueryId ou PipeID: um identificador exclusivo da consulta ou canal de acionamento (QUERY ID para COPY ou PIPE ID para SNOWPIPE).

Ref: 1377