Pacote 2022_03

Este tópico descreve as seguintes mudanças de comportamento (se houver) do mês:

  • Recursos que foram descontinuados.

  • Pacote de mudanças que foram ativadas.

  • Outras mudanças não inclusas no pacote que foram implementadas.

Se tiver alguma dúvida sobre estas mudanças, entre em contato com o suporte Snowflake.

Para obter mais detalhes sobre os novos recursos, melhorias e correções introduzidos neste mês, consulte Junho de 2022.

Importante

Salvo indicação em contrário, estas mudanças estão no pacote 2022_03, que foi habilitado por padrão no lançamento da mudança de comportamento 6.21.

Neste tópico:

Mudanças de segurança

Controle de acesso: mensagem de erro ao revogar uma concessão de função inexistente de uma função ou usuário

Quando você executa o comando REVOKE ROLE para revogar uma função de um usuário ou outra função, mas a função não está atualmente concedida ao objeto especificado, a mensagem de erro retornada mudou da seguinte forma:

Texto anterior da mensagem de erro:

Revoke not executed: Insufficient privileges

Texto atual da mensagem de erro:

Statement executed successfully

Observe que a instrução SQL é bem-sucedida apesar do texto da mensagem de erro. Esta mudança ajuda a evitar preocupações desnecessárias ao examinar seus logs com históricos de consultas.

Mudanças de SQL — Geral

Atualização para a versão 2021a do TZDB

Snowflake usa o banco de dados de fuso horário (TZDB) para informações de fuso horário (por exemplo, para a lista de nomes de fuso horário e alias para CONVERT_TIMEZONE).

Snowflake atualizou a versão de TZDB utilizada:

Anteriormente:

Snowflake usado em versões anteriores (a partir de 2016f) do TZDB.

Atualmente:

Snowflake utilizava a versão 2021a do TZDB.

Para uma lista das mudanças feitas até a versão 2021a do TZDB, consulte Notícias sobre o banco de dados tz.

Mudanças de SQL — Comandos e funções

Comando SHOW SHARES e UI do Data Sharing: mudanças na saída

O comando SHOW SHARES e a interface da Web correspondente para compartilhamento de dados que inclui um localizador de conta (anteriormente conhecido como um nome de conta gerado automaticamente) na saída mudou para usar o nome da organização e o novo nome da conta:

Anteriormente:
  • A coluna NAME exibia <localizador_da_conta>.<nome_do_compartilhamento>.

  • A coluna TO (para compartilhamentos de saída) exibia <localizador_da_conta>.

Atualmente:
  • A coluna NAME exibe <nome_da_organizacao>.<nome_da_conta>.<nome_de_compartilhamento>.

  • A coluna TO (para compartilhamentos de saída) exibe <nome_da_organizacao>.<nome_da_conta>.

Além disso, os seguintes comandos que usam <localizador_da_conta>.<nome_do_compartilhamento> como parâmetro agora podem usar <nome_da_organizacao>.<nome_da_conta>.<nome_do_compartilhamento> como parâmetro:

Para obter mais informações sobre a diferença entre o localizador de conta e o novo nome de conta, consulte Identificadores de conta.

Comandos DESCRIBE TASK/SHOW TASKS: nova coluna em saída

A saída dos comandos DESCRIBE TASK e SHOW TASKS agora inclui uma nova coluna ERROR_INTEGRATION. Para ajudar a limitar o impacto desta mudança, a coluna foi adicionada como a última coluna na saída.

A coluna mostra o nome da integração de notificação utilizada para acessar o Amazon Simple Notification Service (SNS) para retransmitir notificações de erro para a tarefa.

Comando SHOW TASKS: novas colunas na saída

A saída do comando SHOW TASKS agora inclui as duas novas colunas a seguir:

Nome da coluna

Tipo de dados

Descrição

LAST_COMMITTED_ON

TIMESTAMP

Especifica quando uma versão da tarefa foi definida pela última vez. Se nenhuma versão tiver sido definida (isto é, se a tarefa não foi retomada ou executada manualmente após ter sido criada), o valor é NULL.

LAST_SUSPENDED_ON

TIMESTAMP

Especifica quando a tarefa foi suspensa pela última vez. Se a tarefa ainda não foi suspensa, o valor será NULL.

Ambas as colunas se referem a uma tarefa autônoma ou à tarefa raiz em uma árvore. Os valores da coluna são NULL para tarefas filho em uma árvore.

Comando SHOW TASKS e função TASK_DEPENDENTS: mudanças para as colunas PREDECESSORS / PREDECESSOR

A tarefa precedente de uma determinada tarefa, se houver, é retornada nas seguintes colunas:

  • Coluna PREDECESSORS na saída do comando SHOW TASKS.

  • Coluna PREDECESSOR na saída da função de tabela TASK_DEPENDENTS (em Information Schema).

O valor da coluna mudou da seguinte forma:

Anteriormente:

O valor foi retornado como uma cadeia de caracteres. Por exemplo:

mydb.myschema.task1

Atualmente:

O valor é retornado como uma matriz JSON. Os nomes de tarefas individuais na matriz são totalmente qualificados (isto é, inclui o banco de dados do contêiner e os nomes de esquema). As aspas duplas nos nomes de tarefas são digitadas com o caractere de escape barra invertida (\).

A matriz contém apenas um valor. Por exemplo:

[
"mydb.myschema.task1"
]
Copy

Se uma tarefa não tiver uma tarefa precedente, a matriz ficará vazia: [].

Além disso, a coluna PREDECESSOR na saída TASK_DEPENDENTS foi renomeada para PREDECESSORS.

Essas mudanças foram feitas para oferecer suporte para os gráficos acíclicos dirigidos (DAGs) de tarefas.

Mudanças de SQL — Exibições de uso e exibições Information Schema/funções de tabela

Exibição GRANTS_TO_ROLES (Account Usage): retorna as concessões de privilégios CREATE WAREHOUSE

A exibição GRANT_TO_ROLES (no esquema ACCOUNT_USAGE do banco de dados SNOWFLAKE) inclui agora concessões existentes do privilégio global CREATE WAREHOUSE às funções. Anteriormente, consultar a exibição não retornava as concessões deste privilégio.

Observe que o comando SHOW GRANTS retorna concessões do privilégio CREATE WAREHOUSE.

Exibição USERS e Exibição ROLES (Account Usage): novas colunas adicionadas

As seguintes colunas foram adicionadas às exibições USERS e ROLES (no esquema ACCOUNT_USAGE do banco de dados SNOWFLAKE):

Nome da coluna

Tipo de dados

Descrição

OWNER

VARCHAR

Especifica a função com o privilégio OWNERSHIP no objeto. Acrescentada às exibições USERS e ROLES.

DEFAULT_SECONDARY_ROLES

VARCHAR

Especifica a função padrão secundária do usuário (isto é, ALL) ou NULL, se não estiver definida. Adicionada somente à exibição USERS.

Para ajudar a limitar o impacto desta mudança, as novas colunas foram adicionadas como as últimas colunas na saída.

Exibição VIEWS (Account Usage): exibições materializadas adicionadas à exibição

As exibições materializadas agora estão incluídas na exibição VIEWS (no esquema ACCOUNT_USAGE do banco de dados SNOWFLAKE).

Anteriormente, a exibição VIEWS não incluía exibições materializadas.

Mudanças no carregamento de dados

Opção de formato de arquivo VALIDATE_UTF8 — Obsoleto

A opção de formato de arquivo VALIDATE_UTF8 especifica se é recomendável validar a codificação de caracteres UTF-8 em dados de uma coluna de cadeia de caracteres. Essa opção foi fornecida apenas para garantir a retrocompatibilidade com versões mais antigas do Snowflake. Como o valor da opção padrão é TRUE desde o início de 2017, a documentação do produto tem insistido veementemente contra a substituição da configuração padrão.

Essa opção agora está obsoleta e o comportamento ao tentar substituir o valor padrão mudou da seguinte forma:

  • A execução de uma instrução CREATE <objeto>, ALTER <objeto> ou COPY INTO <tabela> que define VALIDATE_UTF8 = FALSE produz um erro de usuário. Os seguintes tipos de objetos oferecem suporte a esta opção de formato de arquivo:

    • Formato do arquivo

    • Estágio

    • Tabela

  • Se a opção foi substituída em objetos existentes, agora ela é ignorada ao carregar dados. A operação de carregamento inclui validação de codificação de caracteres UTF-8.