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)
para9,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:
As IDs da transação para os seguintes comandos e funções são maiores em aproximadamente um milhão de vezes em relação a seus valores anteriores:
SHOW TRANSACTIONS (coluna
id
)DESCRIBE TRANSACTION (coluna
id
)CURRENT_TRANSACTION (saída da função)
LAST_TRANSACTION (saída da função)
SHOW LOCKS (coluna
transaction
)
A saída do carimbo de data/hora para as seguintes funções do sistema foi convertida de milissegundos para precisão de nanossegundos:
SYSTEM$LAST_CHANGE_COMMIT_TIME (saída da função)
SYSTEM$STREAM_GET_TABLE_TIMESTAMP (saída da função)
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 eFOO"
como o nome do objeto)"public"".foo"
(public"
analisado como o nome do esquema eFOO"
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.