Configuration d’un client, d’un pilote, d’une bibliothèque ou d’une application tierce pour se connecter à Snowflake¶

Utilisation de Snowsight pour obtenir les paramètres de connexion¶

Pour obtenir les paramètres que vous pouvez utiliser pour configurer un client, un pilote, une bibliothèque ou une application tierce :

1. Connectez-vous à Snowsight.

2. Ouvrez le menu utilisateur en sélectionnant votre nom d’utilisateur.

   

3. Dans le menu utilisateur, sélectionnez Connect a tool to Snowflake pour afficher la boîte de dialogue Account Details.

   Astuce

   Vous pouvez également afficher les détails du compte à partir du sélecteur de compte.

4. Sélectionnez l’un des onglets suivants :

   • Si votre client, pilote, bibliothèque ou application tierce prend en charge l’utilisation d’un fichier de configuration TOML (par exemple, Snowflake CLI, Snowflake Python APIs ou Snowflake Connector for Python :

     1. Sélectionnez l’onglet Config file.

     2. Pour spécifier un entrepôt dans le fichier de configuration, sélectionnez l’entrepôt dans le menu Warehouse.

     3. Pour spécifier une base de données et un schéma dans le fichier de configuration, utilisez le menu Database pour sélectionner la base de données et le schéma.

     4. Dans le menu Connection Method, sélectionnez la méthode que vous planifiez d’utiliser pour l’authentification :

        • Pour utiliser l’authentification unique basée sur le navigateur (SSO), sélectionnez Web Browser.

        • Pour utiliser un mot de passe, sélectionnez Password.

        Note

        Les clients, pilotes, bibliothèques et applications tierces prennent en charge d’autres méthodes d’authentification qui ne figurent pas dans la liste. Pour plus d’informations, voir Sécurisation de Snowflake.

     5. Sélectionnez l’icône de copie () pour copier le contenu du fichier de configuration.

     Note

     Pour le support Snowflake Python APIs, les traits de soulignement ne sont pas pris en charge dans le paramètre account. Si l’identifiant du compte comprend des traits de soulignement, remplacez-les par des tirets.

   • Si votre client, pilote, bibliothèque ou application tierce prend en charge la spécification d’une chaîne de connexion (par exemple, le pilote ODBC, le pilote JDBC, le pilote Go Snowflake ou le pilote .NET):

     1. Sélectionnez l’onglet Connectors/Drivers.

     2. Dans le menu Select Connector or Driver, sélectionnez le pilote que vous souhaitez utiliser.

     3. Pour spécifier un entrepôt dans la chaîne de connexion, sélectionnez l’entrepôt dans le menu Warehouse. (Notez que ce menu n’est pas présent pour les pilotes ODBC et .NET.)

     4. Pour spécifier une base de données et un schéma dans la chaîne de connexion, utilisez le menu Database pour sélectionner la base de données et le schéma.

     5. Dans le menu Connection Method, sélectionnez la méthode que vous planifiez d’utiliser pour l’authentification :

        • Pour utiliser l’authentification unique basée sur le navigateur (SSO), sélectionnez Web Browser.

        • Pour utiliser un mot de passe, sélectionnez Password.

        Note

        Les clients, pilotes, bibliothèques et applications tierces prennent en charge d’autres méthodes d’authentification qui ne figurent pas dans la liste. Pour plus d’informations, voir Sécurisation de Snowflake.

     6. Sélectionnez l’icône de copie () pour copier la chaîne de connectivité obtenue.

   • Pour exécuter les commandes SQL afin d’obtenir les informations de configuration :

     1. Sélectionnez l’onglet SQL Commands.

     2. Sélectionnez l’icône de copie () à côté de la commande qui fournit les informations dont vous avez besoin, collez la commande dans une feuille de calcul et exécutez la commande.

Utilisation des commandes SQL pour obtenir les paramètres de connexion¶

Vous pouvez exécuter les commandes SQL pour obtenir les informations suivantes nécessaires à la configuration de votre client, pilote, bibliothèque ou application :

SELECT CURRENT_USER();

SELECT CURRENT_ROLE();

SELECT CURRENT_REGION();

SELECT CURRENT_WAREHOUSE();

SELECT CURRENT_DATABASE();

SELECT CURRENT_SCHEMA();

Formats de compte utilisés par les clients et les pilotes¶

Selon les clients et les pilotes, vous utilisez des syntaxes différentes pour spécifier votre compte.

En général, vous devez utiliser la variante qui comprend le nom de l’organisation (orgname) et le nom du compte (account_name).

Une exception à cette règle est l’utilisation de la fonction Client Redirect. Si vous utilisez cette fonction, remplacez le nom du compte (account_name) par le nom de la connexion (connection_name). Pour des exemples de cette syntaxe, voir Utilisation d’une URL de connexion.

Pour configurer une connexion privée au service Snowflake, ajoutez .privatelink à la syntaxe du nom de compte ou du localisateur de compte. Pour déterminer la valeur à utiliser pour se connecter à Snowflake lors de l’utilisation de la connectivité privée, appelez la fonction SYSTEM$GET_PRIVATELINK_CONFIG dans votre compte Snowflake.

Si vous devez utiliser le localisateur de compte, il se peut que vous deviez également spécifier l’ID de région du Cloud, le Cloud et le niveau de conformité gouvernementale en tant que segments supplémentaires après le localisateur de compte. Pour le format à utiliser, voir Format 2 : localisateur de compte dans une région. Dans les exemples ci-dessous, account_locator_with_additional_segments représente l’emplacement du compte avec tous les segments supplémentaires nécessaires.

SnowSQL:

• Nom du compte : snowsql -a orgname-account_name

• Localisateur de compte : snowsql -a account_locator_with_additional_segments

Pour plus d’informations, voir Syntaxe de connexion.

JDBC:

• Nom du compte : jdbc:snowflake://orgname>-<account_name.snowflakecomputing.com/?connection_paramsr

• Localisateur de compte : jdbc:snowflake://account_locator_with_additional_segments.snowflakecomputing.com/?connection_params

Pour plus d’informations, voir Chaîne de connexion de pilote JDBC.

ODBC:

• Nom du compte :

  • Serveur : orgname-account_name.snowflakecomputing.com

• Localisateur de compte :

  • Serveur : account_locator_with_additional_segments.snowflakecomputing.com}

Pour plus d’informations, voir Paramètres de configuration et de connexion ODBC.

Python:

• Nom du compte :

  • Définissez la valeur du paramètre ACCOUNT sur orgname-account_name.

• Localisateur de compte :

  • Définissez la valeur du paramètre ACCOUNT sur account_locator_with_additional_segments.

Pour plus d’informations, voir Connexion à Snowflake avec le connecteur Python.

.Net:

• Nom du compte :

  • Définissez la valeur du paramètre ACCOUNT sur orgname-account_name.

  • Définissez la valeur du paramètre HOST comme valeur par défaut (.snowflakecomputing.com).

• Localisateur de compte :

  • Définissez la valeur du paramètre ACCOUNT sur account_locator_with_additional_segments.

  • Définissez la valeur du paramètre HOST comme valeur par défaut .snowflakecomputing.com. Indiquez si votre compte Snowflake ne se trouve pas dans la région us-west.

Pour de plus amples informations, voir Connecter.

Golang:

• Nom du compte : db, err := sql.Open("snowflake", "jsmith:mypassword@orgname-account_name/mydb/testschema?warehouse=mywh")

• Localisateur de compte : sql.Open("snowflake", "jsmith:mypassword@account_locator_with_additional_segments/mydb/testschema?warehouse=mywh")

Pour de plus amples informations, voir Chaîne de connexion.

node.js:

• Nom du compte : Définissez la valeur du paramètre ACCOUNT sur orgname-account_name.

• Localisateur de compte : Définissez la valeur du paramètre ACCOUNT sur account_locator_with_additional_segments.

Pour plus d’informations, voir Gestion des connexions.

Spark (connecteur):

• Nom du compte : identique à JDBC

• Localisateur de compte : identique à JDBC

Pour plus d’informations, voir Réglage des options de configuration du connecteur.

Spark (Databricks):

• Nom du compte : Account URL for Snowflake account

• Localisateur de compte : Account Locator URL for Snowflake account

Pour plus d’informations, voir Configuration de Snowflake pour Spark dans Databricks.

Spark (Qubole):

• Nom du compte : Définissez la valeur du champ Host Address sur orgname-account_name.snowflakecomputing.com.

• Localisateur de compte : Définissez la valeur du champ Host Address sur account_locator_with_additional_segments.snowflakecomputing.com.

Pour plus d’informations, voir Configuration de Snowflake pour Spark dans Qubole.

PHP:

• Nom du compte :

  • Définissez la valeur du paramètre ACCOUNT sur orgname-account_name.

  • Laissez la valeur du paramètre REGION vide pour toutes les régions.

• Localisateur de compte :

  • Définissez la valeur du paramètre ACCOUNT sur account_locator.

  • Définissez la valeur du paramètre REGION si votre compte Snowflake n’est pas dans la région us-west.

Pour plus d’informations, voir Connexion à la base de données Snowflake.

SQLAlchemy:

• Nom du compte : snowflake://user_login_name:password@orgname-account_name

• Localisateur de compte : snowflake://user_login_name:password@account_locator_with_additional_segments

Pour plus d’informations, voir Utilisation du kit de ressources SQLAlchemy Snowflake avec le connecteur Python.

Étapes de configuration supplémentaires¶

Les rubriques suivantes couvrent des domaines spécifiques de la configuration d’une connexion :

• Autorisation des noms d’hôte

• Configuration d’OCSP