Identificateurs de compte

Un identificateur de compte identifie de manière unique un compte Snowflake au sein de votre entité commerciale, ainsi que dans l’ensemble du réseau mondial de plates-formes et de régions Cloud prises en charge par Snowflake.

Snowflake propose deux options différentes pour identifier un compte Snowflake. Vous pouvez identifier un compte en utilisant son nom dans votre organisation ou son localisateur attribué par Snowflake dans la région Cloud dans laquelle le compte est situé.

Note

Les deux options peuvent être utilisées. Cependant, pour utiliser la première option, un rôle ORGADMIN doit être créé dans l’un de vos comptes. Si le rôle n’existe pas, contactez l’assistance de Snowflake.

Dans ce chapitre :

Où les identificateurs de compte sont-ils utilisés ?

Des identificateurs de compte sont requis dans Snowflake partout où vous devez spécifier le compte que vous utilisez, y compris :

  • URLs pour accéder à l’une des interfaces Web de Snowflake.

  • SnowSQL, les pilotes, les connecteurs et les autres clients pour la connexion à Snowflake.

  • Les applications et services tiers qui constituent l’écosystème Snowflake.

  • Les fonctionnalités utilisées pour la sécurisation des opérations internes de Snowflake et la communication/l’interaction avec les systèmes externes.

  • Des fonctionnalités globales telles que Secure Data Sharing, la réplication des bases de données et le basculement/la restauration automatique.

Par exemple, l’URL d’un compte utilise le format suivant :

identificateur_de_compte.snowflakecomputing.com

Pour plus d’informations sur l’utilisation des identificateurs de compte dans les URLS et les pilotes, voir Utilisation des identificateurs de compte pour se connecter à vos comptes.

Option 1 : nom du compte dans votre organisation

Une organisation est un objet Snowflake de première classe qui relie les comptes appartenant à votre entité commerciale. Les organisations permettent aux administrateurs des organisations (c’est-à-dire aux utilisateurs ayant le rôle ORGADMIN) de visualiser, de créer et de gérer tous vos comptes à travers différentes régions et sur différentes plates-formes cloud.

Le nom du compte doit être unique au sein de votre organisation et peut être modifié, ce qui permet une plus grande flexibilité et conduit à des noms de compte plus courts et plus intuitifs. Vous spécifiez un nom de compte lorsque vous créez un nouveau compte (voir Création d’un compte). Pour changer le nom d’un compte existant, contactez l’assistance de Snowflake.

Bien qu’un nom de compte identifie de manière unique un compte au sein de votre organisation, il n’est pas un identificateur unique d’un compte parmi les organisations Snowflake.

Les noms de compte avec des traits de soulignement ont également une version en tiret de l’URL pour les fonctionnalités qui n’acceptent pas les URLs avec des traits de soulignement, comme Okta SSO/SCIM.

Utilisation d’un nom de compte comme identificateur

L’identificateur d’un compte pour un compte dans votre organisation prend la forme suivante, en fonction de l’endroit et de la manière dont l’identificateur est utilisé :

  • nom_de_l’organisation-nom_du_compte (pour la plupart des URLs et une autre utilisation plus générale)

  • nom_de_l’organisation_nom_du_compte (pour les scénarios/fonctions où les traits d’union ne sont pas pris en charge dans les URLs)

  • nom_de_l’organisation.nom_du_compte (pour les commandes et opérations SQL)

Où :

nom_de_l’organisation

Nom de votre organisation Snowflake.

nom_compte

Nom unique de votre compte au sein de votre organisation :

Pour plus d’informations sur les noms d’organisation et de compte, voir Nom de l’organisation et du compte (dans cette rubrique).

Nom de l’organisation et du compte

Nom de l’organisation

Le nom de l’organisation est le nom choisi par le client. Le nom doit être unique pour toutes les organisations Snowflake. Il peut inclure des lettres majuscules et des chiffres, mais pas de caractères de soulignement ni d’autres délimiteurs.

Pour changer le nom de votre organisation, contactez l’assistance de Snowflake.

La meilleure pratique consiste à revoir et à modifier le nom de l’organisation, si nécessaire, avant de l’utiliser comme identificateur. Renommer le nom de l’organisation dans le futur renommera également toutes les URLs de comptes.

Pour identifier le nom de votre organisation, voir Affichage du nom de votre organisation.

Nom du compte

Le nom du compte doit être unique au sein de votre organisation. Vous spécifiez un nom de compte lorsque vous créez un nouveau compte (voir Création d’un compte).

Bien qu’un nom de compte identifie de manière unique un compte au sein de votre organisation, il n’est pas un identificateur unique d’un compte parmi les organisations Snowflake.

Pour identifier de manière unique un compte dans Snowflake, vous devez ajouter le nom du compte au nom de l’organisation. Par exemple, <organization_name>-<account_name>.

Les noms de compte avec des traits de soulignement ont également une version en tiret de l’URL pour les fonctionnalités qui n’acceptent pas les URLs avec des traits de soulignement, comme Okta SSO/SCIM.

Conformément aux normes SQL relatives aux identificateurs, les noms de compte peuvent comporter des traits de soulignement comme séparateurs entre les mots (par exemple MARKETING_TEST_ACCOUNT), mais uniquement des traits de soulignement. Cela va générer des URLs de compte avec des caractères de soulignement.

Les URLs avec des caractères de soulignement peuvent parfois causer des problèmes pour certaines fonctionnalités. Pour ces URLs, Snowflake publie une version tout en tirets de l’URL.

Par exemple, ces deux URLs seront fonctionnelles :

URL avec des caractères de soulignement : https://acme-marketing_test_account.snowflakecomputing.com

URL avec des tirets : https://acme-marketing-test-account.snowflakecomputing.com

Comptes existants

Lorsqu’un compte existant est ajouté à une organisation, le Option 2 : localisateur de compte dans une région est utilisé à la place du nom du compte.

Si vous avez des comptes portant le même nom dans différentes régions, les noms Cloud et de région sont ajoutés au nom du compte dans le nouveau format d’URL.

Par exemple, si le nom de l’organisation est ACME et qu’il y a deux comptes nommés TEST, l’un dans la région AWS US East 2 et l’autre dans la région Azure West US 2, les URLs se présenteront comme suit :

URL d’origine du compte 1 : https://test.us-east-2.aws.snowflakecomputing.com

URL d’origine du compte 2 : https://test.west-us-2.azure.snowflakecomputing.com

Nouvelle URL du compte 1 : https://acme-test_aws_us_east_2.snowflakecomputing.com

Nouvelle URL du compte 2 : https://acme-test_azure_west_us_2.snowflakecomputing.com

Ces noms de compte peuvent être modifiés à condition que les nouveaux noms soient uniques. Pour savoir comment changer le nom d’un compte, voir Changement de nom de compte.

Option 2 : localisateur de compte dans une région

Un localisateur de compte est un identificateur attribué par Snowflake lors de la création du compte :

  • Si le compte est créé par un représentant de Snowflake, vous pouvez demander une valeur spécifique pour le localisateur, comme un nom de société, un acronyme ou une autre chaîne reconnaissable.

  • Si le compte est créé en libre-service ou par un processus automatisé/en arrière-plan, le localisateur est une chaîne aléatoire de caractères et de chiffres uniques (par exemple xy12345).

Le localisateur d’un compte ne peut pas être modifié une fois que le compte est créé.

Utilisation d’un localisateur de compte comme identificateur

Chaque compte Snowflake est hébergé sur une plate-forme Cloud dans une région géographique.

La région détermine où les données du compte sont stockées et où les ressources de calcul utilisées par le compte sont provisionnées.

Lorsqu’on utilise un localisateur de compte pour identifier un compte, le localisateur ne suffit pas toujours à lui seul pour identifier l’emplacement du compte. En fonction de la région et de la plate-forme Cloud du compte, des segments supplémentaires peuvent être nécessaires, sous la forme suivante :

localisateur_compte.id_région ou

localisateur_compte.id_région.cloud

Où :

id_région

Identificateur de la région Cloud (imposé par la plate-forme Cloud).

cloud

Identificateur de la plate-forme Cloud (aws, azure ou gcp).

Par exemple, si votre localisateur de compte est xy12345 :

  • Si le compte est situé dans la région AWS US Ouest (Oregon), aucun segment supplémentaire n’est nécessaire et l’URL serait xy12345.snowflakecomputing.com.

  • Si le compte est situé dans la région AWS US Est (Ohio), des segments supplémentaires sont nécessaires et l” URL serait xy12345.us-east-2.aws.snowflakecomputing.com.

Pour une liste complète des formats de région et de localisateur, voir Formats de localisateur par plateforme Cloud et par région (dans cette rubrique).

Note

Si votre édition Snowflake est VPS, le localisateur de compte utilise un format différent. Voir Trouver le localisateur de compte pour un compte VPS.

Trouver la région et le localisateur pour votre compte

Si vous pouvez vous connecter à votre compte Snowflake, vous pouvez interroger les fonctions contextuelles suivantes pour identifier la région et le localisateur de compte pour le compte Snowflake auquel vous êtes connecté :

Si vous ne pouvez pas vous connecter à Snowflake, contactez l’administrateur de votre compte Snowflake pour récupérer ces informations.

Formats de localisateur par plateforme Cloud et région

Le tableau suivant énumère les formats de localisateurs de comptes dans toutes les régions prises en charge, en indiquant notamment si le localisateur de compte d’une région donnée exige des segments supplémentaires.

Si votre localisateur de compte est xy12345:

Plate-forme Cloud / région .

Localisateur de compte . (avec des segments supplémentaires si nécessaire)

Amazon Web Services (AWS)

US Ouest (Oregon)

xy12345

US Gov West 1

xy12345.us-gov-west-1.aws

US East (Ohio)

xy12345.us-east-2.aws

US Est (Virginie du Nord)

xy12345.us-east-1

US Est (Gouvernement commercial - Virginie du Nord)

xy12345.us-east-1-gov.aws

Canada (Centre)

xy12345.ca-central-1.aws

EU (Irlande)

xy12345.eu-west-1

Europe (Londres)

xy12345.eu-west-2.aws

EU (Francfort)

xy12345.eu-central-1

Asie-Pacifique (Tokyo)

xy12345.ap-northeast-1.aws

Asie-Pacifique (Seoul)

xy12345.ap-northeast-2.aws

Asie Pacifique (Mumbai)

xy12345.ap-south-1.aws

Asie-Pacifique (Singapour)

xy12345.ap-southeast-1

Asie-Pacifique (Sydney)

xy12345.ap-southeast-2

Google Cloud Platform (GCP)

US Central1 (Iowa)

xy12345.us-central1.gcp

Europe Ouest2 (Londres)

xy12345.europe-west2.gcp

Europe Ouest4 (Pays-Bas)

xy12345.europe-west4.gcp

Microsoft Azure

Ouest US 2 (Washington)

xy12345.west-us-2.azure

Central US (Iowa)

xy12345.central-us.azure

East US 2 (Virginia)

xy12345.east-us-2.azure

US Gov Virginia

xy12345.us-gov-virginia.azure

Canada Central (Toronto)

xy12345.canada-central.azure

Europe du Nord (Irlande)

xy12345.north-europe.azure

Europe de l’Ouest (Pays-Bas)

xy12345.west-europe.azure

Suisse Nord (Zurich)

xy12345.switzerland-north.azure

Asie du Sud-Est (Singapour)

xy12345.southeast-asia.azure

Australie Est (Nouvelle-Galles du Sud)

xy12345.australia-east.azure

Trouver le localisateur de compte pour un compte VPS

Si votre édition Snowflake est VPS, le localisateur de compte utilise des conventions d’appellation différentes de celles des comptes des autres éditions Snowflake. Il en résulte une structure différente pour les noms d’hôte et URLs utilisés pour accéder aux comptes VPS.

Pour plus d’informations, contactez le Support Snowflake ou votre représentant Snowflake.

Vous pouvez également utiliser le format privilégié organizationName-accountName comme identificateur de compte. Ce format fonctionne pour les comptes utilisant l’édition VPS. Voir Option 1 : nom du compte dans votre organisation pour plus de détails.

Identificateur de compte pour la connectivité privée

Si AWS PrivateLink ou Azure Private Link est activé pour votre compte et que vous souhaitez utiliser la connectivité privée pour vous connecter à Snowflake, exécutez la fonction SYSTEM$GET_PRIVATELINK_CONFIG pour déterminer l’URL de la connectivité privée à utiliser.

Pour plus de détails sur la connectivité privée, voir :

Identificateur de compte pour la réplication et le basculement

Si la fonction Organisation est activée pour votre compte, voir Option 1 : nom du compte dans votre organisation.

Les commandes SQL liées à la réplication et au basculement nécessitent l’utilisation de l’ID de la région Snowflake dans l’identificateur du compte. Pour plus de détails et une liste complète, voir IDs de régions Snowflake (dans ce chapitre).

région_snowflake.localisateur_de_compte

Où :

région_snowflake ID de région Snowflake.

localisateur_compte Le localisateur de compte pour les commandes de réplication est la valeur de la colonne account_locator dans

SHOW REPLICATION ACCOUNTS ou SHOW REPLICATION DATABASES.

Pour la réplication et le basculement entre différents groupes de régions, vous devrez également spécifier le groupe de régions dans l’identificateur du compte. Pour plus de détails, voir Groupes de régions (dans ce chapitre).

La colonne region_group se trouve dans la sortie de SHOW REPLICATION ACCOUNTS.

groupe_région.id_région_snowflake.nom

Groupes de régions

Un groupe de régions est un groupe de régions qui offrent des contrôles de sécurité, une isolation et une conformité similaires. La spécification du groupe de régions dans le cadre de l’identificateur du compte est nécessaire si la fonction Organisations est activée et que vous souhaitez créer des comptes dans différents groupes de régions, ou pour la réplication et le basculement vers et depuis des comptes dans différents groupes de régions.

Les comptes Snowflake se trouvent dans l’un des trois groupes de régions :

  • PUBLIC est le groupe de régions pour toutes les régions Snowflake mutualisées sur tous les Clouds.

  • Les groupes de régions Virtual Private Snowflake (VPS) contiennent un groupe de régions à locataire unique (VPS) qui appartiennent au même client.

  • Les groupes de régions gouvernementales contiennent des régions gouvernementales.

IDs de régions Snowflake

Une région Snowflake est un emplacement distinct dans une région de plate-forme Cloud qui est isolée des autres régions Snowflake. Elle peut être mutualisée ou à locataire unique (pour un compte Virtual Private Snowflake). La spécification de l’ID de région Snowflake dans le cadre de l’identificateur de compte est requise si la fonction Organisations est activée lorsque vous créez un nouveau compte, et lors de la configuration de la réplication et du basculement.

Le tableau suivant affiche la liste complète des IDs de régions Snowflake :

Région

ID de région

ID de région Snowflake

Remarques

Amazon Web Services (AWS)

US Ouest (Oregon)

us-west-2

aws_us_west_2

US Gov West 1

us-gov-west-1

aws_us_gov_west_1

Disponible uniquement pour les comptes sur Business Critical (ou version supérieure) ; situé dans AWS GovCloud (US).

US East (Ohio)

us-east-2.aws

aws_us_east_2

US Est (Virginie du Nord)

us-east-1

aws_us_east_1

US Est (Gouvernement commercial - Virginie du Nord)

us-east-1-gov.aws

aws_us_east_1_gov

Disponible uniquement pour les comptes sur Business Critical (ou version supérieure) ; non situé dans AWS GovCloud (US).

Canada (Centre)

ca-central-1.aws

aws_ca_central_1

EU (Irlande)

eu-west-1

aws_eu_west_1

Europe (Londres)

eu-west-2.aws

aws_eu_west_2

EU (Francfort)

eu-central-1

aws_eu_central_1

Asie-Pacifique (Tokyo)

ap-northeast-1.aws

aws_ap_northeast_1

Asie-Pacifique (Seoul)

ap-northeast-2.aws

aws_ap_northeast_2

Asie Pacifique (Mumbai)

ap-south-1.aws

aws_ap_south_1

Asie-Pacifique (Singapour)

ap-southeast-1

aws_ap_southeast_1

Asie-Pacifique (Sydney)

ap-southeast-2

aws_ap_southeast_2

Google Cloud Platform (GCP)

US Central1 (Iowa)

us-central1.gcp

gcp_us_central1

Europe Ouest2 (Londres)

europe-west2.gcp

gcp_europe_west2

Europe Ouest4 (Pays-Bas)

europe-west4.gcp

gcp_europe_west4

Microsoft Azure

Ouest US 2 (Washington)

west-us-2.azure

azure_westus2

Central US (Iowa)

central-us.azure

azure_centralus

East US 2 (Virginia)

east-us-2.azure

azure_eastus2

US Gov Virginia

us-gov-virginia.azure

azure_usgovvirginia

Disponible uniquement pour les comptes sur Business Critical (ou version supérieure) ; situé dans Azure Government Cloud.

Canada Central (Toronto)

canada-central.azure

azure_canadacentral

Europe du Nord (Irlande)

north-europe.azure

azure_northeurope

Europe de l’Ouest (Pays-Bas)

west-europe.azure

azure_westeurope

Asie du Sud-Est (Singapour)

southeast-asia.azure

azure_southeastasia

Suisse Nord (Zurich)

switzerland-north.azure

azure_switzerlandnorth

Australie Est (Nouvelle-Galles du Sud)

australia-east.azure

azure_australiaeast