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 :

  1. Activez un environnement Python.

  2. En option : Pour utiliser la bibliothèque dans les régions gouvernementales, créez la bibliothèque de cryptographie Python dans l’environnement.

    Note

    La bibliothèque Snowflake Python APIs s’appuie sur la bibliothèque de cryptographie Python pour l’authentification. Si vous utilisez un environnement Python conforme à la norme FIPS, vous devez compiler la bibliothèque de cryptographie par rapport à l’OpenSSL conforme à la norme FIPS du système.

  3. Installez la bibliothèque.

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

  1. Créer un environnement conda :

    conda create -n <env_name> python==3.10
    Copy

  2. Activer l’environnement :

    conda activate <env_name>
    Copy

Créer la bibliothèque de cryptographie Python pour les régions gouvernementales

Pour l’authentification, la bibliothèque Snowflake Python APIs utilise le Snowflake Connector pour Python, qui s’appuie sur la bibliothèque de cryptographie Python. La bibliothèque de cryptographie dépend de la bibliothèque C OpenSSL pour toutes les opérations cryptographiques et fournit des paquets wheel avec une dépendance OpenSSL liée statiquement incluse.

Ainsi, lorsque vous installez la cryptography via la commande pip install cryptography par défaut, la bibliothèque utilise sa propre version de OpenSSL plutôt que la version du système. Pour plus d’informations, consultez `Utilisation de OpenSSL<https://cryptography.io/en/latest/openssl/>`_.

Si vous utilisez l’API Python pour vous connecter à des comptes Snowflake dans les régions gouvernementales, vous devez vous assurer que vous utilisez un environnement Python conforme à la norme FIPS. Pour garantir la conformité à la norme FIPS, au lieu d’installer la bibliothèque de cryptographie à partir d’une wheel PyPI, vous devez la compiler vous-même par rapport à l’OpenSSL conforme à la norme FIPS.

  • Pour obtenir des instructions sur la façon de créer la bibliothèque de cryptographie sur votre système d’exploitation spécifique, consultez Installation dans la documentation de cryptography.

Important

Vous devez créer la bibliothèque de cryptographie de cette manière avant d’exécuter pip install snowflake -U. Cette construction définit la dépendance de cryptography et garantit que le paquet de cryptography n’est pas extrait de PyPI.

La bibliothèque de cryptographie doit être compilée en utilisant une version qui répond aux exigences de dépendance définies dans la bibliothèque Snowflake Connector pour Python.

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

Langage: Français