Identificateurs de compte¶

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

L’identificateur de compte par défaut comprend le nom du compte ainsi que son organisation (par exemple, myorg-account123). Bien que vous puissiez également utiliser le localisateur attribué par Snowflake comme identificateur de compte, l’utilisation de cet ancien format est déconseillée.

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 et d’autres clients (connecteurs, pilotes, etc.) pour se connecter à Snowflake.
Les applications et services tiers qui constituent l’écosystème Snowflake.
Les fonctionnalités de sécurité utilisées pour la protection des opérations internes de Snowflake et la communication/l’interaction avec des systèmes externes.
Des fonctionnalités globales telles que Secure Data Sharing, la réplication et le basculement/la restauration.

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

account_identifier.snowflakecomputing.com

Si votre organisation utilise la fonction Redirection des clients, le nom d’un objet de connexion peut être utilisé à la place du nom du compte dans l’identificateur du compte pour se connecter à un compte Snowflake en utilisant un client Snowflake. Pour plus d’informations, voir Utilisation d’une URL de connexion.

Pour plus d’informations sur l’utilisation des identificateurs de compte et des connexions pour se connecter à un compte Snowflake, voir Connexion à vos comptes.

Format 1 (recommandé) : nom du compte dans votre organisation.¶

Une organisation est un objet Snowflake 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.

Les noms du compte doivent être uniques au sein de votre organisation et peuvent être modifiés, 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 modifier le nom d’un compte existant, voir Renommage 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.

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é :

orgname-account_name (pour la plupart des URLs et une autre utilisation plus générale)
orgname-account-name (pour les scénarios/fonctionnalités où les caractères de soulignement d’un nom de compte ne sont pas pris en charge)
orgname.account_name (pour les commandes et opérations SQL)

Où :

orgname est le nom de votre organisation Snowflake.
account_name est le nom unique de votre compte au sein de votre organisation.

Recherche de l’organisation et du nom de compte pour un compte¶

Pour trouver le nom d’un compte, vous pouvez utiliser Snowsight ou SQL.

Snowsight:

Ouvrez le sélecteur de compte et consultez la liste des comptes auxquels vous vous êtes précédemment connecté.
Localisez le compte pour lequel vous souhaitez copier le nom de compte.
Survolez le compte pour voir des détails supplémentaires et sélectionnez l’icône de copie pour copier l’identificateur du compte dans le format <orgname>.<account_name> dans votre presse-papiers.

SQL:

Pour récupérer le nom du compte courant, exécutez la fonction CURRENT_ACCOUNT_NAME.
Pour récupérer l’organisation du compte courant, exécutez la fonction CURRENT_ORGANIZATION_NAME.

Noms de l’organisation et du compte¶

Nom de l’organisation¶

Pour les utilisateurs qui s’inscrivent à un compte Snowflake en utilisant l’option de libre-service, une organisation est automatiquement créée avec un nom généré par le système lorsque le compte est créé. Pour les entités qui travaillent directement avec le personnel de Snowflake pour configurer des comptes, Snowflake peut attribuer à l’organisation un nom personnalisé. Ce nom personnalisé doit être unique parmi toutes les autres organisations de Snowflake. Le nom doit commencer par une lettre et ne peut contenir que des lettres (minuscules et majuscules) et des chiffres. Le nom ne peut pas contenir de barres de soulignement ou d’autres délimiteurs.

Si vous souhaitez modifier le nom d’une organisation, par exemple pour remplacer un nom généré par le système par un nom plus convivial, contactez le support Snowflake.

Une bonne pratique consiste à vérifier et à modifier le nom de votre organisation, si nécessaire, avant d’utiliser le nom dans tout identificateur de compte. Si vous modifiez le nom de l’organisation à l’avenir, toutes les URLs de vos comptes Snowflake seront modifiées pour correspondre au nouveau nom.

Pour connaître le nom de votre organisation, voir Affichage du nom de votre organisation et de ses comptes.

Nom du compte¶

Chaque nom de compte doit être unique au sein de votre organisation. Vous spécifiez un nom de compte lorsque vous créez le 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 faire précéder le nom du compte du nom de votre organisation. Par exemple :

orgname-account_name

Conformément aux normes SQL relatives aux identificateurs, les noms de compte peuvent inclure des traits de soulignement comme séparateurs entre les mots (par exemple MARKETING_TEST_ACCOUNT).

Les URLs avec des traits de soulignement peuvent parfois causer des problèmes pour certaines fonctionnalités, comme Okta SSO/SCIM. Pour cette raison, Snowflake prend également en charge une version du nom du compte qui substitue le caractère tiret (-) à la place du trait de soulignement. Par exemple, les deux URLs suivantes sont prises en charge :

URL avec des traits de soulignement : https://acme-marketing_test_account.snowflakecomputing.com

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

Comptes existants¶

Si vous avez des comptes qui existaient avant l’activation de la fonction Organisations, le Format 2 (existant) : localisateur de compte dans une région est utilisé comme nom de compte.

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

Par exemple, si le nom de votre 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 nouvelles URLs utiliseront la structure suivante :

Premier compte :

URL d’origine:

https://test.us-east-2.aws.snowflakecomputing.com

Nouvelles URL:

https://acme-test_aws_us_east_2.snowflakecomputing.com
Deuxième compte :

URL d’origine:

https://test.west-us-2.azure.snowflakecomputing.com

Nouvelles URL:

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 Renommage d’un compte.

Format 2 (existant) : 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éé.

Note

Les localisateurs de comptes continuent d’être pris en charge pour identifier les comptes dans Snowflake, mais ce n’est plus la méthode recommandée. La méthode recommandée pour identifier les comptes est désormais le nom du compte au sein de votre organisation (comme décrit précédemment dans cette rubrique).

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 le 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 :

account_locator.cloud_region_id ou

account_locator.cloud_region_id.cloud

Où :

cloud_region_id est l’identificateur de la région Cloud (imposé par la plate-forme Cloud).
cloud est l’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 non-VPS par plate-forme 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 format de localisateur de compte pour un compte VPS (dans cette rubrique).

Trouver la région et le localisateur pour un 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é :

CURRENT_REGION récupère la région dans laquelle se trouve votre compte.
CURRENT_ACCOUNT récupère le localisateur de compte.

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

Trouver le format de localisateur de compte pour un compte VPS¶

Si votre édition Snowflake est VPS, le format de 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 recommandé organization_name-account_name comme identificateur de compte. Ce format fonctionne pour les comptes utilisant l’édition VPS. Pour plus de détails, voir Format 1 (recommandé) : nom du compte dans votre organisation. (dans ce chapitre).

Formats de localisateur de compte non-VPS par plate-forme Cloud et par région¶

Le tableau suivant énumère les formats de localisateurs de comptes dans toutes les régions non-VPS 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/région Cloud	Identificateur du compte	Remarques
Amazon Web Services (AWS)
US Ouest (Oregon)	`xy12345`	Aucun segment supplémentaire n’est requis.
US Gov West 1	`xy12345.us-gov-west-1.aws`
US Gov West 1 (FedRAMP High Plus)	`xy12345.fhplus.us-gov-west-1.aws`
US East (Ohio)	`xy12345.us-east-2.aws`
US Est (Virginie du Nord)	`xy12345.us-east-1`	L’ID de région Cloud est le seul segment supplémentaire requis.
US Est (Gouvernement commercial - Virginie du Nord)	`xy12345.us-east-1-gov.aws`
Canada (Centre)	`xy12345.ca-central-1.aws`
Amérique du Sud (Sao Paulo)	`xy12345.sa-east-1.aws`
EU (Irlande)	`xy12345.eu-west-1`	L’ID de région Cloud est le seul segment supplémentaire requis.
Europe (Londres)	`xy12345.eu-west-2.aws`
EU (Paris)	`xy12345.eu-west-3.aws`
EU (Francfort)	`xy12345.eu-central-1`	L’ID de région Cloud est le seul segment supplémentaire requis.
EU (Stockholm)	`xy12345.eu-north-1.aws`
Asie-Pacifique (Tokyo)	`xy12345.ap-northeast-1.aws`
Asie-Pacifique (Osaka)	`xy12345.ap-northeast-3.aws`
Asie-Pacifique (Seoul)	`xy12345.ap-northeast-2.aws`
Asie Pacifique (Mumbai)	`xy12345.ap-south-1.aws`
Asie-Pacifique (Singapour)	`xy12345.ap-southeast-1`	L’ID de région Cloud est le seul segment supplémentaire requis.
Asie-Pacifique (Sydney)	`xy12345.ap-southeast-2`	L’ID de région Cloud est le seul segment supplémentaire requis.
Asie-Pacifique (Jakarta)	`xy12345.ap-southeast-3.aws`
Google Cloud Platform (GCP)
US Central1 (Iowa)	`xy12345.us-central1.gcp`
US East4 (Virginie du Nord)	`xy12345.us-east4.gcp`
Europe Ouest2 (Londres)	`xy12345.europe-west2.gcp`
Europe Ouest4 (Pays-Bas)	`xy12345.europe-west4.gcp`
Microsoft Azure		Les localisateurs de compte Azure ont été implémentés avec des traits d’union par souci de cohérence avec AWS et GCP.
Ouest US 2 (Washington)	`xy12345.west-us-2.azure`
Central US (Iowa)	`xy12345.central-us.azure`
Sud-Central US (Texas)	`xy12345.south-central-us.azure`
Est US 2 (Virginie)	`xy12345.east-us-2.azure`
US Gov Virginia	`xy12345.us-gov-virginia.azure`
Canada Central (Toronto)	`xy12345.canada-central.azure`
UK Sud (Londres)	`xy12345.uk-south.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`
UAE Nord (Dubaï)	`xy12345.uae-north.azure`
Inde centrale (Pune)	`xy12345.central-india.azure`
Japon Est (Tokyo)	`xy12345.japan-east.azure`
Asie du Sud-Est (Singapour)	`xy12345.southeast-asia.azure`
Australie Est (Nouvelle-Galles du Sud)	`xy12345.australia-east.azure`

Identificateurs de comptes pour la connectivité privée¶

Si la connectivité privée au service Snowflake est activé pour votre compte et que vous souhaitez utiliser la fonctionnalité pour vous connecter à Snowflake, exécutez la fonction SYSTEM$GET_PRIVATELINK_CONFIG pour déterminer l’URL de la connectivité privée à utiliser. Vous pouvez utiliser soit le nom du compte, soit le localisateur de compte dans l’URL pour vous connecter à l’interface Web de Snowflake.

Si vous souhaitez vous connecter à Snowsight en utilisant une connectivité privée, suivez les instructions suivantes : Se connecter à Snowsight.

Identificateurs de comptes pour la réplication et le basculement¶

La méthode préférée pour identifier un compte dans les commandes SQL liées à la réplication et au basculement utilise le nom de l’organisation et le nom du compte comme identificateur du compte. Si vous décidez d’utiliser l’ancien localisateur de compte à la place, il se peut qu’il doive contenir des segments supplémentaires afin d’identifier le compte de manière unique. Voir le tableau ci-dessous à titre de référence :

Identificateur du compte

Emplacement du compte distant

organization_name.account_name

Identificateur de compte préféré qui peut être utilisé quelle que soit la région ou quel que soit le groupe de régions du compte stockant la base de données principale.

account_locator

Même région, mais compte différent du compte qui stocke la base de données principale.

snowflake_region.account_locator

Même groupe de régions, mais région différente du compte qui stocke la base de données principale

region_group.snowflake_region.account_locator

Groupe de régions différent du compte qui stocke la base de données principale.

Identificateur du compte	Emplacement du compte distant
`organization_name.account_name`	Identificateur de compte préféré qui peut être utilisé quelle que soit la région ou quel que soit le groupe de régions du compte stockant la base de données principale.
`account_locator`	Même région, mais compte différent du compte qui stocke la base de données principale.
`snowflake_region.account_locator`	Même groupe de régions, mais région différente du compte qui stocke la base de données principale
`region_group.snowflake_region.account_locator`	Groupe de régions différent du compte qui stocke la base de données principale.

Les valeurs de snowflake_region et region_group se trouvent dans la sortie de SHOW REPLICATION ACCOUNTS.

IDs de régions Snowflake et groupes de régions¶

Une Snowflake Region est une région distincte (déployée dans une région Cloud AWS, Azure ou GCP) qui est isolée des autres régions Snowflake. Une Snowflake Region peut être soit multi-locataire (contenant des comptes pour plusieurs organisations) soit à locataire unique (également appelée Virtual Private Snowflake pour une seule organisation).

Chaque Snowflake Region possède un identificateur unique et appartient à un groupe de régions, ce qui permet des fonctionnalités globales telles que le partage et la réplication des données.

IDs de région¶

Étant donné que chaque plate-forme Cloud utilise des conventions et des formats différents pour nommer ses régions, Snowflake attribue un ID canonique à chaque Snowflake Region qui l’identifie de manière unique sur toutes les plates-formes Cloud et leurs régions.

Si la fonction Organisations est activée, la spécification de l’ID de la Snowflake Region dans le cadre d’un identificateur de compte est requise lorsque vous créez un nouveau compte, ainsi que lorsque vous configurez la réplication et le basculement.

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

Région Cloud	Cloud ID 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 Gov West 1 (FedRAMP High Plus)	`fhplus.us-gov-west-1.aws`	`aws_us_gov_west_1_fhplus`	Disponible uniquement pour les comptes sur Business Critical (ou version supérieure) ; situé dans AWS GovCloud (US).
US East (Ohio)	`us-east-2`	`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`	`aws_us_gov_east_1`	Disponible uniquement pour les comptes sur Business Critical (ou version supérieure) ; situé dans US Est 1, pas AWS GovCloud (US).
Canada (Centre)	`ca-central-1`	`aws_ca_central_1`
Amérique du Sud (Sao Paulo)	`sa-east-1`	`aws_sa_east_1`
EU (Irlande)	`eu-west-1`	`aws_eu_west_1`
Europe (Londres)	`eu-west-2`	`aws_eu_west_2`
EU (Paris)	`eu-west-3`	`aws_eu_west_3`
EU (Francfort)	`eu-central-1`	`aws_eu_central_1`
EU (Stockholm)	`eu-north-1`	`aws_eu_north_1`
Asie-Pacifique (Tokyo)	`ap-northeast-1`	`aws_ap_northeast_1`
Asie-Pacifique (Osaka)	`ap-northeast-3`	`aws_ap_northeast_3`
Asie-Pacifique (Seoul)	`ap-northeast-2`	`aws_ap_northeast_2`
Asie Pacifique (Mumbai)	`ap-south-1`	`aws_ap_south_1`
Asie-Pacifique (Singapour)	`ap-southeast-1`	`aws_ap_southeast_1`
Asie-Pacifique (Sydney)	`ap-southeast-2`	`aws_ap_southeast_2`
Asie-Pacifique (Jakarta)	`ap-southeast-3`	`aws_ap_southeast_3`
Google Cloud Platform (GCP)
US Central1 (Iowa)	`us-central1`	`gcp_us_central1`
US East4 (Virginie du Nord)	`us-east4`	`gcp_us_east4`
Europe Ouest2 (Londres)	`europe-west2`	`gcp_europe_west2`
Europe Ouest4 (Pays-Bas)	`europe-west4`	`gcp_europe_west4`
Microsoft Azure
Ouest US 2 (Washington)	`westus2`	`azure_westus2`
Central US (Iowa)	`centralus`	`azure_centralus`
Sud-Central US (Texas)	`southcentralus`	`azure_southcentralus`
Est US 2 (Virginie)	`eastus2`	`azure_eastus2`
US Gov Virginia	`usgovvirginia`	`azure_usgovvirginia`	Disponible uniquement pour les comptes sur Business Critical (ou version supérieure) ; situé dans Microsoft Azure Government.
Canada Central (Toronto)	`canadacentral`	`azure_canadacentral`
UK Sud (Londres)	`uk-south`	`azure_uksouth`
Europe du Nord (Irlande)	`northeurope`	`azure_northeurope`
Europe de l’Ouest (Pays-Bas)	`westeurope`	`azure_westeurope`
Suisse Nord (Zurich)	`switzerlandnorth`	`azure_switzerlandnorth`
UAE Nord (Dubaï)	`uaenorth`	`azure_uaenorth`
Inde centrale (Pune)	`central-india.azure`	`azure_centralindia`
Japon Est (Tokyo)	`japaneast`	`azure_japaneast`
Asie du Sud-Est (Singapour)	`southeastasia`	`azure_southeastasia`
Australie Est (Nouvelle-Galles du Sud)	`australiaeast`	`azure_australiaeast`

Groupes de régions¶

Un groupe de régions est un groupe de régions Snowflake qui offrent des contrôles de sécurité, une isolation et une conformité similaires. Le groupe de régions auquel appartient une Snowflake Region diffère selon la région :

Toutes les régions commerciales multi-locataires de Snowflake (sur toutes les plates-formes Cloud prises en charge) sont dans le même groupe partagé/général PUBLIC.
Chaque région gouvernementale multi-locataire Snowflake se trouve dans un groupe distinct spécifique à la région.
Chaque Virtual Private Snowflake (VPS) à locataire unique se trouve dans un groupe de régions distinct, spécifique au VPS. Si votre organisation a plus d’un VPS, vous pouvez avoir un VPS par groupe de régions, sinon plusieurs VPSs peuvent partager le même groupe de régions.

La spécification du groupe de régions dans l’identificateur d’un compte est nécessaire lorsque vous souhaitez créer des comptes dans différents groupes de régions.