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

Novos recursos e atualizações¶

• Adição de suporte para configuração de proxy. Você pode fornecer configurações de proxy usando a variável de ambiente HTTPS_PROXY.

Correções de bugs¶

Nenhum.

Novos recursos e atualizações¶

• Adição de suporte aos seguintes métodos para especificar a referência de ponto de tempo quando você usa o Time Travel para criar fluxos:

  • PointOfTimeStatement

  • PointOfTimeStream

  • PointOfTimeTimestamp

Correções de bugs¶

• Correção de um aviso: 'allow_population_by_field_name' has been renamed to 'validate_by_name'.

• Restauração do comportamento do método drop de DAGOperation de tal forma que drop_finalizer deve ser definido como True antes que a tarefa finalizadora seja descartada.

  Como resultado das mudanças na versão 9.20 do Snowflake, fetch_task_dependents começou a retornar a tarefa finalizadora junto com outras tarefas que pertencem ao gráfico acíclico dirigido (DAG). Esse comportamento fazia com que o método drop sempre descartasse o finalizador.

Novos recursos e atualizações¶

• Opcionalmente, os parâmetros query e column na QueryRequest para a API Cortex Search Service.

Correções de bugs¶

Nenhum.

Novos recursos e atualizações¶

Nenhum.

Correções de bugs¶

• 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.

Novos recursos e atualizações¶

• 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.

Correções de bugs¶

• 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.

Novos recursos e atualizações¶

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

Correções de bugs¶

• 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.

Novos recursos e atualizações¶

• 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.

Correções de bugs¶

Nenhum.

Novos recursos e atualizações¶

• 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

Correções de bugs¶

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

Novos recursos e atualizações¶

• 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)

Correções de bugs¶

Nenhum.

Novos recursos e atualizações¶

• Removida a dependência de protobuf de snowflake.core.

Correções de bugs¶

Nenhum.

Novos recursos e atualizações¶

• Foi adicionado suporte ao recurso Cortex Lite Agent.

Correções de bugs¶

Nenhum.

Novos recursos e atualizações¶

• Foi adicionado suporte ao recurso Cortex Embed.

Correções de bugs¶

Nenhum.