Pacote 2022_05

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 Agosto de 2022.

Importante

Salvo indicação em contrário, estas mudanças estão no pacote 2022_05, que foi habilitado por padrão na versão 6.29.

Neste tópico:

Mudanças de segurança

Autenticação de pares de chaves: tempo de emissão deve ser 1 dia ou menos

A autenticação do par de chaves com tokens da web JSON (JWT) mudou da seguinte forma:

Anteriormente:
  • Tokens JWT permitidos com tempo de emissão e tempo de expiração a serem apresentados em segundos. Se estes valores fossem apresentados em milissegundos, Snowflake trataria o valor de milissegundos como se fossem segundos.

  • Tokens JWT permitidos com tempos de emissão no futuro.

Atualmente:
  • Tokens JWT são agora permitidos com tempo de emissão e tempo de expiração em milissegundos ou segundos.

  • JWT não é mais permitido com tempo de emissão no futuro. Se necessário, atualize seu processo de geração de tokens para garantir que o valor do tempo de emissão não seja no futuro.

Mudanças de SQL — Geral

Mudanças nas IDs de transação e carimbos de data/hora

As IDs de transação aumentaram em tamanho e os carimbos de data/hora devolvidos por funções selecionadas do sistema aumentaram a precisão:

Anteriormente:
  • Os valores da ID da transação tinham aproximadamente 13 dígitos.

  • Os carimbos de data/hora tinham uma precisão de milissegundos.

Atualmente:
  • A ID de transação é agora um número inteiro assinado de 64 bits (de comprimento). O intervalo de valores é de -9,223,372,036,854,775,808 (-263) para 9,223,372,036,854,775,807 (263 1).

  • Os carimbos de data/hora são convertidos para precisão de nanossegundos.

Essa mudança tem o seguinte impacto:

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

Função GET_DDL: mudanças na saída para identificadores contendo aspas duplas e pontos

A saída da função GET_DDL mudou da seguinte forma:

Anteriormente:

GET_DDL não devolveu corretamente os nomes dos objetos ou colunas quando as cadeias de caracteres tinham aspas duplas. Se um nome continha aspas duplas, a aspas duplas devem ser precedidas por outras aspas duplas, resultando na cadeia de caracteres contendo um par de aspas duplas; entretanto, a função só retornou uma das aspas duplas.

Por exemplo, uma tabela foi nomeada como "foo""one". Executando GET_DDL na tabela fazia com que "foo"one" fosse retornado incorretamente como o nome da tabela. Como resultado, a saída da função não poderia ser usada para recriar a tabela.

Além disso, GET_DDL (e outras funções que aceitam nomes de objetos totalmente qualificados como cadeias de caracteres) não puderam analisar o nome especificado se um período estivesse no início do nome ou imediatamente após as aspas duplas na cadeia de caracteres.

Por exemplo, as seguintes cadeias de caracteres não foram suportadas como nomes de objetos:

  • ".foo" (" analisado como o nome do esquema e FOO" como o nome do objeto)

  • "public"".foo" (public" analisado como o nome do esquema e FOO" como o nome do objeto)

Atualmente:

GET_DDL retorna corretamente e com sucesso nomes de objetos e colunas que contêm aspas duplas.

Além disso, GET_DDL (e outras funções que aceitam nomes de objetos totalmente qualificados) são capazes de analisar nomes de objetos especificados que contêm pontos no início do nome ou imediatamente após as aspas duplas na cadeia de caracteres.

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

Exibição FUNCTIONS (Information Schema): novas colunas na exibição

A saída da exibição FUNCTIONS no Information Schema agora inclui as seguintes novas colunas:

Nome da coluna

Tipo de dados

Descrição

PACKAGES

STRING

Especifica os pacotes solicitados pela função.

RUNTIME_VERSION

STRING

Especifica a versão do runtime da função. NULL se a função for SQL ou Javascript

INSTALLED_PACKAGES

STRING

Lista todos os pacotes instalados pela função. Saída apenas para as funções Python.

Mudanças no pipeline de dados

Comandos DESCRIBE STREAM/SHOW STREAMS: nova coluna INVALID_REASON na saída

A saída dos comandos DESCRIBE STREAM e SHOW STREAMS agora inclui as seguintes colunas adicionais:

Nome da coluna

Tipo de dados

Descrição

INVALID_REASON

STRING

Especifica a razão quando o conteúdo de um fluxo não puder ser consultado com sucesso. Esta coluna foi introduzida para oferecer suporte à funcionalidade futura. Quando a coluna for introduzida, o único valor retornado será N/A.

Para ajudar a limitar o impacto desta mudança, a coluna foi adicionada como a última coluna na saída.

Mudanças no data lake

Comando SHOW EXTERNAL TABLES: coluna LOCATION retorna NULL para consumidores de dados

Os provedores podem incluir tabelas externas, entre outros objetos de banco de dados, em compartilhamentos para contas de consumidores via Snowflake Secure Data Sharing.

Quando um usuário em uma conta de consumidor executa o comando SHOW EXTERNAL TABLES, a saída para tabelas externas compartilhadas mudou da seguinte forma:

Anteriormente:

A coluna LOCATION mostrou o estágio externo e o caminho da pasta na definição da tabela externa para tabelas externas em um compartilhamento importado (ou seja, as mesmas informações retornadas para tabelas externas na conta do consumidor).

Atualmente:

A coluna LOCATION mostra NULL para tabelas externas em um compartilhamento importado.

Mudanças do Snowflake CLI, Conectores, Driver e SQL API

Snowflake SQL API: remoção dos pontos de extremidade mais antigos

Os pontos de extremidade mais antigos e obsoletos do Snowflake SQL API não estão mais disponíveis. Isto inclui os seguintes pontos de extremidade:

  • /api/statements/

  • /api/statements/<statementHandle>

  • /api/statements/<statementHandle>/cancel

As chamadas para estes pontos de extremidade agora retornam um código de erro HTTP 404.

Você deve se certificar de que está usando a versão mais recente do SQL API. Consulte Sobre os pontos de extremidade da SQL API para obter mais detalhes.