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éthodecall
renvoyait des résultats erronés lors de l’utilisation de l’optionextract
avec le typeReturnTable
.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éthodeServiceResource.get_containers
.Ajout de l’option
extract
à la méthodeprocedure.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éfinirextract=True
pour qu’il renvoie la valeur42
.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’utiliserextract=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’argumentdrop_finalizer
est défini surTrue
.Important
L’argument
drop_finalizer
sera supprimé dans la prochaine version majeure de API, et la méthodeDAGOperation.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
etSchema
(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 deCortexAgentService.run
.Ajout de nouveaux attributs facultatifs à divers modèles de l’API Cortex Search Service :
text_boosts
etvector_boosts
au modèleFunction
weights
au modèleScoringConfig
Corrections de bogues¶
Vous pouvez désormais appeler
create_or_alter
avec un objet de tâche renvoyé par la méthodeiter
.
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.