24 de fevereiro a 01 de março de 2025 — Notas da versão 9.4¶

Informações adicionais retornadas para objetos vinculados a referências — Disponibilidade geral¶

Os provedores do Snowflake Native App agora podem usar o seguinte para obter o nome do objeto, o nome do esquema e o nome do banco de dados de um objeto vinculado a uma referência:

• A função do sistema SYSTEM$GET_ALL_REFERENCES.

• O método snowflake.permissions.get_detailed_reference_associations do Python Permission SDK.

Controle mais granular dos níveis de log, rastreamento e métrica em um aplicativo — Disponibilidade geral¶

Em um Snowflake Native App, agora é possível substituir os níveis de log, rastreamento e métricas de objetos específicos em um aplicativo, incluindo:

• esquemas de banco de dados

• esquemas com versões

• procedimentos armazenados

• functions

Isso permite o monitoramento e a análise precisos desses objetos e oferece aos provedores um controle mais granular sobre a coleta de dados de telemetria. Os níveis de log, rastreamento e métrica no nível do aplicativo são usados como padrão e são aplicados somente quando não são definidas substituições específicas de objeto ou esquema. Você pode definir os níveis padrão de log, rastreamento e métrica no nível do aplicativo no arquivo de manifesto do aplicativo. Consulte Configurar definições de eventos para um aplicativo para obter mais informações. As substituições específicas do objeto no setup.sql têm precedência sobre os padrões no nível do aplicativo.

Para obter os valores de substituição dos níveis de registro, métrica e rastreamento, use as seguintes funções do sistema:

• SYSTEM$APPLICATION_GET_LOG_LEVEL

• SYSTEM$APPLICATION_GET_TRACE_LEVEL

• SYSTEM$APPLICATION_GET_METRIC_LEVEL

Clonagem de bancos de dados que contêm tabelas híbridas — Versão preliminar¶

Neste lançamento, temos o prazer de anunciar a versão preliminar do suporte à clonagem para bancos de dados que contêm tabelas híbridas. Você pode criar bancos de dados clonados para configurar uma solução de backup e restauração para aplicativos Unistore.

Para obter mais informações, consulte:

• Clone bancos de dados que contenham tabelas híbridas

• CREATE <objeto> … CLONE

• AT | BEFORE

Novas funções de SQL¶

A seguinte função agora está disponível neste lançamento:

Suporte para associação de uma tabela de eventos a um banco de dados — Disponibilidade geral¶

Neste lançamento, o suporte para associar uma tabela de eventos a um banco de dados está disponível de modo geral. Quando você atribui uma tabela de eventos a um banco de dados, o escopo dos objetos para os quais os eventos são coletados na tabela de eventos é limitado aos objetos do banco de dados.

Anteriormente, uma tabela de eventos podia ser associada apenas à conta.

Para obter mais informações, consulte Visão geral da tabela de evento.

Tabelas e tarefas dinâmicas: eventos registrados para atualizações e execuções de tarefas¶

Agora você pode configurar o Snowflake para registrar eventos de atualizações de tabelas dinâmicas e execuções de tarefas. Esses eventos são armazenados na tabela de eventos ativos associada à tabela ou tarefa dinâmica.

Quando uma tabela dinâmica é atualizada, o Snowflake registra um evento para indicar se:

• A atualização foi bem-sucedida.

• A atualização falhou. Nesse caso, o evento também inclui a mensagem de erro.

• A atualização falhou devido a uma falha na atualização de uma tabela dinâmica upstream.

Da mesma forma, quando uma tarefa é executada, o Snowflake registra um evento para indicar se a tarefa foi concluída com êxito ou se ocorreu um erro. Se ocorrer um erro, o evento inclui a mensagem de erro.

Você pode consultar esses eventos para identificar atualizações que falharam ou execuções de tarefas que resultaram em erros.

Por exemplo, a consulta a seguir obtém o carimbo de data/hora, o nome da tabela dinâmica, o ID da consulta e a mensagem de erro para erros com tabelas dinâmicas no banco de dados my_db:

SELECT
    timestamp,
    resource_attributes:"snow.executable.name"::VARCHAR AS dt_name,
    resource_attributes:"snow.query.id"::VARCHAR AS query_id,
    value:message::VARCHAR AS error
  FROM my_event_table
  WHERE
    resource_attributes:"snow.executable.type" = 'DYNAMIC_TABLE' AND
    resource_attributes:"snow.database.name" = 'MY_DB' AND
    value:state = 'FAILED'
  ORDER BY timestamp DESC;

A consulta a seguir obtém o carimbo de data/hora, o nome da tarefa, o ID da consulta e a mensagem de erro para erros com tarefas no banco de dados my_db:

SELECT
    timestamp,
    resource_attributes:"snow.executable.name"::VARCHAR AS task_name,
    resource_attributes:"snow.query.id"::VARCHAR AS query_id,
    value:message::VARCHAR AS error
  FROM my_event_table
  WHERE
    resource_attributes:"snow.executable.type" = 'TASK' AND
    resource_attributes:"snow.database.name" = 'MY_DB' AND
    value:state = 'FAILED'
  ORDER BY timestamp DESC;

Para obter mais informações, consulte:

• Consulte uma tabela de eventos para monitorar as atualizações (para tabelas dinâmicas)

• Monitoramento de eventos para execução de tarefas

Parâmetro CATALOG_NAMESPACE para integrações de catálogo agora é opcional¶

Neste lançamento, o parâmetro CATALOG_NAMESPACE para integrações de catálogo agora é opcional em vez de obrigatório:

• Se você criar uma integração de catálogo para sincronizar uma tabela Iceberg gerenciada pelo Snowflake com o Snowflake Open Catalog, não será mais necessário especificar o parâmetro CATALOG_NAMESPACE. O Snowflake sincroniza a tabela Apache Iceberg™ com o catálogo externo no Open Catalog que você especifica na integração do catálogo.

• Se o usuário criar uma integração de catálogo para tabelas Iceberg não gerenciadas e não especificar um CATALOG_NAMESPACE com a integração de catálogo, deverá especificá-lo no nível da tabela. Como alternativa, você pode especificá-lo com a integração do catálogo e substituí-lo no nível da tabela.