Installez la bibliothèque Snowflake Python APIs.¶

Vous pouvez installer la bibliothèque Snowflake Python APIs pour l’utiliser avec conda ou un environnement virtuel. Avant de commencer, assurez-vous de vérifier les versions Python prises en charge.

Pour configurer la bibliothèque Snowflake Python APIs, procédez comme suit :

Activez un environnement Python.
Installez la bibliothèque.
Définissez les options pour le client d’API Python.

Activer un environnement Python¶

Pour configurer un environnement dans lequel exécuter du code Python, vous devez activer un environnement Python. Par exemple, vous pouvez utiliser conda ou un environnement virtuel (venv).

Note

Ces étapes ne sont fournies qu’à titre d’exemple et, si vous suivez l’exemple, vous pourriez avoir besoin de droits supplémentaires sur des données, des produits ou des services tiers qui ne sont pas détenus ou fournis par Snowflake. Assurez-vous de disposer des droits appropriés sur les données, produits ou services tiers.

Vous pouvez utiliser conda pour créer un environnement d’exécution du code Python. Si vous ne disposez pas de conda, vous pouvez l’installer depuis le site Web de conda.

Pour plus d’informations sur conda, consultez Documentation sur conda. Pour télécharger et installer conda, voir Installer conda.

Créer un environnement conda :

conda create -n <env_name> python==3.10

Copy

Activer l’environnement :
```
conda activate <env_name>
```
Copy

Vous pouvez utiliser venv pour créer un environnement virtuel pour l’exécution du code Python. Si vous n’avez pas encore Python, vous pouvez télécharger et installer Python, puis créer un environnement virtuel.

Pour plus d’informations sur venv, voir venv - Création d’environnements virtuels. Pour télécharger Python, voir Téléchargements Python.

Utilisez venv pour créer un environnement virtuel :

cd <your Python project root folder>
python3 -m venv '.venv'

Copy

Activer l’environnement :
```
source '.venv/bin/activate'
```
Copy

Installez la bibliothèque Snowflake Python APIs.¶

Vous pouvez installer la bibliothèque Snowflake Python APIs depuis Python Package Index (PyPI).

Dans l’environnement virtuel ou conda que vous avez créé, exécutez la commande pip suivante pour installer la bibliothèque :
```
pip install snowflake -U
```
Copy
Le paquet Snowflake est le paquet parent de l’espace de noms PEP 420 pour Snowflake Python APIs. Il comprend snowflake.core, qui est le sous-paquet qui fournit les APIs Python pour la gestion des objets de ressources Snowflake.

L’installation du paquet snowflake entraîne automatiquement l’installation de snowflake.core et de ses dépendances requises, y compris snowflake-connector-python.
Pour installer également la bibliothèque Snowpark ML en tant que dépendance supplémentaire du paquet, vous pouvez exécuter la commande suivante pip :
```
pip install "snowflake[ml]" -U
```
Copy

Après avoir installé la bibliothèque, vous devez créer une connexion à Snowflake avant de pouvoir utiliser l’API. Pour plus d’informations sur la connexion, voir Connexion à Snowflake avec Snowflake Python APIs.

Définir les options de client d’API Python¶

Vous pouvez définir les variables d’environnement suivantes pour contrôler les options de client pour Snowflake Python APIs :

_SNOWFLAKE_PRINT_VERBOSE_STACK_TRACE

Spécifie si le traçage complet de la pile est activé dans les messages d’erreur imprimés.

Valeurs possibles :

Activé : true, t, yes, y, on ou non défini
Désactivé : Toute autre valeur

Par défaut : activé.

Lorsque cette option est désactivée, le client API définit sys.tracebacklimit sur 0 lors du traitement des requêtes. Ce paramètre entraîne la suppression des informations de retraçage par le client pour tous les types d’exceptions (et pas seulement celles liées au client API) et l’impression uniquement des messages d’erreur.

Pour désactiver cette option pour les environnements de notebook Python, exécutez la ligne suivante dans votre notebook :

%env _SNOWFLAKE_PRINT_VERBOSE_STACK_TRACE=false

Copy

_SNOWFLAKE_ENABLE_RETRY_REQUEST_QUERY

Spécifie si les nouvelles tentatives automatiques sont activées sur les demandes de requête avec des codes de statut spécifiques.

Valeurs possibles :

Activé : true, t, yes, y, on
Désactivé : toute autre valeur ou indéfinie

Par défaut : activé.

Lorsque cette option est activée, le client d’API réessaye automatiquement les demandes de requête lorsqu’elles présentent les codes de statut suivants :

202
429
503
504