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.

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 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 des bases de données et le basculement/la restauration automatique.

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 Changement de nom de 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.

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 Changement de nom de 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é :

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 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 (Francfort)

xy12345.eu-central-1

L’ID de région Cloud est le seul segment supplémentaire requis.

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.

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

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 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 voulez vous connecter à Snowsight en utilisant une connectivité privée, suivez les instructions de la documentation 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.

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 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_east_1_gov

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 (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

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

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.

Si la fonction Organisations est activée, la spécification du groupe de régions dans le cadre d’un identificateur de compte est requise lorsque vous souhaitez créer des comptes dans différents groupes de régions, ou lorsque vous souhaitez répliquer et basculer vers/depuis des comptes dans différents groupes de régions.

Revenir au début