Connexion à vos comptes

Cette rubrique présente les formats des URL et des identificateurs de compte que vous utilisez pour vous connecter aux comptes Snowflake de votre organisation.

Note

Si vous êtes administrateur d’une organisation et que vous souhaitez supprimer les anciennes URLs d’un compte qui a changé, consultez Gestion des URLs de comptes.

Dans ce chapitre :

Connexion à l’interface Web de Snowflake

Pour vous connecter à Snowsight à l’aide de votre navigateur Web, consultez Se connecter à Snowsight.

Connexion avec une URL

Snowflake prend en charge plusieurs formats d’URL lors de la connexion à un compte Snowflake sans navigateur. Par exemple, un fournisseur d’identité peut utiliser une URL directe pour communiquer avec Snowflake.

  • Le format nom du compte utilise le nom du compte et de son organisation pour identifier le compte. Pour trouver le nom de votre organisation et de votre compte, voir Recherche de l’organisation et du nom de compte pour un compte.

  • Le format nom de la connexion, qui remplace le nom du compte par le nom d’une connexion, est requis lors de l’utilisation de la fonction Redirection des clients. Pour connaître le nom de votre connexion, exécutez la commande SHOW CONNECTIONS.

  • L’ancien format de localisateur de compte est actuellement pris en charge, mais son utilisation est déconseillée.

URLs de compte standards

Le format d’URL standard peut être utilisé dans la plupart des cas où une URL de compte Snowflake est requise, notamment :

  • Connexions SSO (sauf Okta)

  • URL de base SCIM (sauf Okta)

  • Connexions OAuth avec des fournisseurs d’identité tiers (sauf Okta)

  • URL de base OAuth pour un serveur d’autorisation Snowflake

Les formats d’URL standard sont les suivants :

  • Nom du compte : https://<nomorg>-<nom_compte>.snowflakecomputing.com

  • Nom de la connexion : https://<nom_org>-<nom_connexion>.snowflakecomputing.com

  • Localisateur de compte (existant) : https://<localisateur_compte>.<région>.<cloud>.snowflakecomputing.com

URLs de connectivité privée

Lors de la connexion à Snowflake à l’aide de la connectivité privée au service Snowflake (par exemple, AWS PrivateLink), la chaîne privatelink doit être ajoutée à l’identificateur du compte dans l’URL de compte Snowflake.

  • Nom du compte : https://<nomorg>-<nom_compte>.privatelink.snowflakecomputing.com

  • Nom de la connexion : https://<nom_org>-<nom_connexion>.privatelink.snowflakecomputing.com

  • Account Locator (existant) : https://<account_locator>.<région>.privatelink.snowflakecomputing.com

Notez que l’utilisation d’une connectivité privée nécessite la mise à jour des enregistrements DNS pour inclure l’URL de connectivité privée. Pour plus d’informations, voir :

URLs Okta

Lorsque vous utilisez Okta pour SSO, SCIM ou OAuth, vous devez utiliser un format de nom de compte spécial si le nom du compte contient un trait de soulignement. Comme Okta ne prend pas en charge les traits de soulignement dans les URLs, le trait de soulignement dans le nom du compte doit être converti en trait d’union.

  • Nom du compte : https://<nomorg>-<nom-compte>.snowflakecomputing.com

  • Nom de la connexion : utilisez l’URL standard

  • Localisateur de compte (existant) : utilisez l’URL standard

Connexion avec des clients, des connecteurs et des pilotes

Les clients, les connecteurs et les pilotes utilisent une variété de syntaxes pour se connecter à Snowflake. En général, vous devez utiliser la variante qui comprend le nom de l’organisation (orgname) et le nom du compte (account_name), avec les exceptions suivantes :

  • Si vous utilisez la fonction Redirection des clients, 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.

  • Actuellement, la connectivité privée au service Snowflake utilisant le format de nom de compte n’est pas prise en charge. Comme solution de rechange, ajoutez privatelink à la syntaxe du localisateur de compte. Pour vérifier quelle valeur vous devez utiliser pour vous connecter à Snowflake lorsque vous utilisez la connectivité privée, appelez la fonction SYSTEM$GET_PRIVATELINK_CONFIG dans votre compte Snowflake.

SnowSQL:
  • Nom du compte : snowsql -a <nomorg>-<nom_compte>

  • Localisateur de compte : snowsql -a <localisateur_compte>

JDBC:
  • Nom du compte : jdbc:snowflake://<nomorg>-<nom_compte>.snowflakecomputing.com/?<paramètres_connexion>

  • Localisateur de compte : jdbc:snowflake://<localisateur_compte>.snowflakecomputing.com/?<paramètres_connexion>

ODBC:
  • Nom du compte :

    • Serveur : <nomorg>-<nom_compte>.snowflakecomputing.com

  • Localisateur de compte :

    • Serveur : <localisateur_compte>.snowflakecomputing.com

Python:
  • Nom du compte :

    • Définissez la valeur du paramètre ACCOUNT sur <orgname>-<nom_compte>.

  • Localisateur de compte :

    • Définissez la valeur du paramètre ACCOUNT sur <localisateur_compte>.<id_région>.<cloud>.

.Net:
  • Nom du compte :

    • Définissez la valeur du paramètre ACCOUNT sur <orgname>-<nom_compte>.

    • 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 <localisateur_compte>.

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

Golang:
  • Nom du compte : db, err := sql.Open("snowflake", "jsmith:mypassword@<nomorg>-<nom_compte>/mydb/testschema?warehouse=mywh")

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

node.js:
  • Nom du compte : définissez la valeur du paramètre ACCOUNT sur <nomorg>-<nom_compte>.

  • Localisateur de compte : définissez la valeur du paramètre ACCOUNT sur <localisateur_compte>.<id_région>.<cloud>.

Spark (connecteur):
  • Nom du compte : identique à JDBC

  • Localisateur de compte : identique à JDBC

Spark (Databricks):
  • Nom du compte : <URL du compte pour le compte Snowflake>

  • Localisateur de compte : <URL du localisateur de compte pour le compte Snowflake>

Spark (Qubole):
  • Nom du compte : définissez la valeur du champ Host Address sur <nomorg>-<nom_compte>.snowflakecomputing.com.

  • Localisateur de compte : définissez la valeur du champ Host Address sur <localisateur_compte>.snowflakecomputing.com.

PHP:
  • Nom du compte :

    • Définissez la valeur du paramètre ACCOUNT sur <orgname>-<nom_compte>.

    • 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 <localisateur_compte>.

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

SQLAchemy:
  • Nom du compte : snowflake://<nom_connexion_utilisateur>:<mot_de_passe>@<nomorg>-<nom_compte>

  • Localisateur de compte : snowflake://<nom_connexion_utilisateur>:<mot_de_passe>@<localisateur_compte>.<id_région>.<cloud>

Compatibilité descendante

L’utilisation du localisateur de compte existant dans un identificateur de compte ou une URL de compte est toujours possible, mais déconseillée.