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.

Utiliser conda¶

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

Utiliser un environnement virtuel¶

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

L’installation du paquet snowflake installe automatiquement tous ses sous-paquets sous forme de dépendances, y compris le connecteur Python Snowflake, la bibliothèque Python Snowpark, ainsi que snowflake.core.

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
Désactivé : toute autre valeur ou indéfinie

Par défaut : désactivé

Lorsque cette option est désactivée, le client d’API imprime des traces de pile réduites au lieu de traces de pile complètes dans les messages d’erreur.

Pour désactiver cette option pour les environnements de notebook Python, vous devez également exécuter la ligne suivante dans votre notebook. Après avoir exécuté cette ligne une fois, la variable d’environnement contrôle elle-même le comportement du traçage de la pile :

%xmode minimal

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