Notas de lançamento de Snowflake Python APIs para 2025¶

Este artigo contém as notas de versão do Snowflake Python APIs, incluindo o seguinte, quando aplicável:

Versão 1.5.1 (28 de maio de 2025)¶

Nenhum.

Corrigido um bug em ProcedureResource que fazia com que o método call retornasse resultados errados ao usar a opção extract com o tipo ReturnTable.
CortexInferenceService.complete agora pode ser chamado a partir de planilhas e notebooks Python.

O método ServiceResource.get_service_status foi preterido em favor do método ServiceResource.get_containers.
Foi adicionada a opção extract ao método procedure.call. A ativação dessa opção faz com que o método extraia resultados da carga útil retornada.

Por exemplo, a configuração extract=False (comportamento padrão atual) retorna um resultado como [{'procedure_name': 42}]. Neste exemplo, você pode definir extract=True para retornar o valor 42.

Nota

extract=False continua sendo a configuração padrão atual, mas agora retorna um aviso de depreciação. A recomendação é que você passe a usar extract=True, que se tornará o novo padrão na próxima versão principal.
Foi adicionado suporte ao mapeamento do tipo VARIANT em uma chamada de procedimento armazenado.

Corrigido o mapeamento de tipo para os tipos de retorno GEOMETRY, GEOGRAPHY, OBJECT em procedimentos armazenados.
A implementação de __repr__ para procedimentos e funções armazenados agora mostra uma lista de argumentos além do nome.

Implementou o método __repr__ para todas as classes de coleção, recurso e modelo.

A variável de ambiente _SNOWFLAKE_PRINT_VERBOSE_STACK_TRACE foi alterada para ser ativada por padrão, o que faz com que as mensagens de erro impressas exibam o rastreamento completo da pilha.

Essa alteração foi feita para evitar a desativação dos rastreamentos de pilha para todas as exceções, o que acontece quando SNOWFLAKE_PRINT_VERBOSE_STACK_TRACE não está definido.

Foi adicionada a classe snowflake.core.FQN, que representa um identificador de objeto.
O método DAGOperation.drop descarta a tarefa do finalizador associada a DAG se o argumento drop_finalizer estiver definido como True.

Importante

O argumento drop_finalizer será removido na próxima versão principal da API e o método DAGOperation.drop sempre eliminará a tarefa do finalizador associado junto com o DAG.

Nenhum.

Foi adicionado suporte a solicitações assíncronas em todos os pontos de extremidade existentes.

Os métodos assíncronos são indicados pelo sufixo _async em seus nomes e usam pesquisa para determinar se uma operação foi concluída.

O número de chamadas que podem ser executadas em paralelo depende do número de CPUs. Para alterar o tamanho do pool de threads, use a variável de ambiente _SNOWFLAKE_MAX_THREADS.

Para obter exemplos de uso, consulte a documentação da classe snowflake.core.PollingOperation.
Foi adicionado suporte para a criação de tarefas sem servidor usando a definição StoredProcedureCall.
Foi adicionado suporte para os atributos sem servidor SERVERLESS_TASK_MIN_STATEMENT_SIZE e SERVERLESS_TASK_MAX_STATEMENT_SIZE aos recursos Database e Schema (dependente do Snowflake versão 9.8).
Foi adicionado suporte à configuração dos atributos SUSPEND_TASK_AFTER_NUM_FAILURES, USER_TASK_MANAGED_INITIAL_WAREHOUSE_SIZE e USER_TASK_TIMEOUT_MS em bancos de dados e esquemas clonados (dependente do Snowflake versão 9.8).
Preterido CortexAgentService.Run em favor de CortexAgentService.run.
Foram adicionados novos atributos opcionais a vários modelos da API do serviço Cortex Search:
- text_boosts e vector_boosts para o modelo Function
- weights para o modelo ScoringConfig

Agora você pode chamar create_or_alter com um objeto de tarefa retornado do método iter.

Foi adicionado suporte aos atributos sem servidor TARGET_COMPLETION_INTERVAL, SERVERLESS_TASK_MIN_STATEMENT_SIZE e SERVERLESS_TASK_MAX_STATEMENT_SIZE ao recurso de tarefa.
Adição de suporte para os seguintes novos recursos:
- API de integração
- Tabelas Iceberg (dependente do Snowflake versão 9.6)

Nenhum.

Nenhum.

Nenhum.

Nenhum.