Notes de version de Snowflake Python APIs pour 2025

Cet article contient les notes de version Snowflake Python APIs, y compris les éléments suivants, le cas échéant :

  • Changements de comportement

  • Nouvelles fonctionnalités

  • Corrections de bogues pour les clients

Voir Snowflake Python APIs : gestion des objets Snowflake avec Python pour la documentation.

Version 1.5.1 (28 mai 2025)

Nouvelles fonctions et mises à jour

Aucun.

Corrections de bogues

  • Correction d’un bogue dans ProcedureResource qui faisait que la méthode call renvoyait des résultats erronés lors de l’utilisation de l’option extract avec le type ReturnTable.

  • CortexInferenceService.complete peut désormais être appelé à partir des feuilles de calcul et des Notebooks Python.

Version 1.5.0 (14 mai 2025)

Nouvelles fonctions et mises à jour

  • Déclassement de la méthode ServiceResource.get_service_status au profit de la méthode ServiceResource.get_containers.

  • Ajout de l’option extract à la méthode procedure.call. L’activation de cette option permet à la méthode d’extraire les résultats de la charge utile renvoyée.

    Par exemple, le paramètre extract=False (comportement actuel par défaut) renvoie un résultat tel que [{'procedure_name': 42}]. Dans cet exemple, vous pouvez définir extract=True pour qu’il renvoie la valeur 42.

    Note

    extract=False reste le paramètre par défaut actuel mais renvoie désormais un avertissement de dépréciation. Il est recommandé d’utiliser extract=True, qui deviendra la nouvelle valeur par défaut dans la prochaine version majeure.

  • Ajout de la prise en charge du mappage du type VARIANT dans l’appel d’une procédure stockée.

Corrections de bogues

  • Correction du mappage des types de retour GEOMETRY, GEOGRAPHY, OBJECT dans les procédures stockées.

  • L’implémentation de __repr__ pour les procédures stockées et les fonctions affiche désormais une liste d’arguments en plus du nom.

Version 1.4.0 (23 avril 2025)

Nouvelles fonctions et mises à jour

  • Mise en œuvre de la méthode __repr__ pour toutes les classes de collections, de ressources et de modèles.

Corrections de bogues

  • La variable d’environnement _SNOWFLAKE_PRINT_VERBOSE_STACK_TRACE a été modifiée pour être activée par défaut, ce qui fait que les messages d’erreur imprimés affichent le traçage complet de la pile.

    Cette modification a été apportée pour éviter de désactiver les traces de pile pour toutes les exceptions, ce qui se produit lorsque SNOWFLAKE_PRINT_VERBOSE_STACK_TRACE n’est pas défini.

Version 1.3.0 (9 avril 2025)

Nouvelles fonctions et mises à jour

  • Ajout de la classe snowflake.core.FQN, qui représente un identificateur d’objet.

  • La méthode DAGOperation.drop abandonne la tâche de finalisation associée à DAG si l’argument drop_finalizer est défini sur True.

    Important

    L’argument drop_finalizer sera supprimé dans la prochaine version majeure de API, et la méthode DAGOperation.drop abandonnera toujours la tâche de finalisation associée en même temps que DAG.

Corrections de bogues

Aucun.

Version 1.2.0 (26 mars 2025)

Nouvelles fonctions et mises à jour

  • Ajout de la prise en charge des requêtes asynchrones pour tous les points de terminaison existants.

    Les méthodes asynchrones sont désignées par le suffixe _async dans leur nom et utilisent l’interrogation pour déterminer si une opération a été achevée.

    Le nombre d’appels pouvant être exécutés en parallèle dépend du nombre de CPUs. Pour modifier la taille du pool de threads, utilisez la variable d’environnement _SNOWFLAKE_MAX_THREADS.

    Pour un exemple d’utilisation, consultez la documentation de la classe snowflake.core.PollingOperation.

  • Ajout de la prise en charge de la création de tâches sans serveur à l’aide de la définition StoredProcedureCall.

  • Ajout du support des attributs sans serveur SERVERLESS_TASK_MIN_STATEMENT_SIZE et SERVERLESS_TASK_MAX_STATEMENT_SIZE aux ressources Database et Schema (dépend de la version 9.8 de Snowflake).

  • Ajout du support pour le paramétrage des attributs SUSPEND_TASK_AFTER_NUM_FAILURES, USER_TASK_MANAGED_INITIAL_WAREHOUSE_SIZE et USER_TASK_TIMEOUT_MS sur les bases de données et schémas clonés (dépend de la version 9.8 de Snowflake).

  • Déclassement de CortexAgentService.Run en faveur de CortexAgentService.run.

  • Ajout de nouveaux attributs facultatifs à divers modèles de l’API Cortex Search Service :

    • text_boosts et vector_boosts au modèle Function

    • weights au modèle ScoringConfig

Corrections de bogues

  • Vous pouvez désormais appeler create_or_alter avec un objet de tâche renvoyé par la méthode iter.

Version 1.1.0 (12 mars 2025)

Nouvelles fonctions et mises à jour

  • Ajout d’une ressource pour les attributs sans serveur TARGET_COMPLETION_INTERVAL, SERVERLESS_TASK_MIN_STATEMENT_SIZE et SERVERLESS_TASK_MAX_STATEMENT_SIZE à la ressource Tâche.

  • Ajout de la prise en charge des nouvelles ressources suivantes :

    • Intégrations API

    • Tables Iceberg (dépendance à la version 9.6 de Snowflake)

Corrections de bogues

Aucun.

Version 1.0.5 (19 février 2025)

Nouvelles fonctions et mises à jour

  • Suppression de la dépendance de protobuf par rapport à snowflake.core.

Corrections de bogues

Aucun.

Version 1.0.4 (13 février 2025)

Nouvelles fonctions et mises à jour

  • Ajout de la prise en charge de la ressource Cortex Lite Agent.

Corrections de bogues

Aucun.

Version 1.0.3 (4 février 2025)

Nouvelles fonctions et mises à jour

  • Ajout de la prise en charge de la ressource Cortex Embed.

Corrections de bogues

Aucun.