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.

Snowflake propose deux formats différents pour identifier un compte Snowflake. Vous pouvez identifier un compte par son nom au sein de votre organisation ou par son localisateur attribué par Snowflake dans la région Cloud dans laquelle le compte est situé.

Note

Vous pouvez utiliser l’un ou l’autre format. Cependant, pour utiliser le premier format, 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 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 :

identificateur_de_compte.snowflakecomputing.com

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

Format 1 (recommandé) : 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.

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, contactez le support 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_organisation est le nom de votre organisation Snowflake.

  • nom_compte est le nom unique de votre compte au sein de votre organisation.

Pour plus de détails, voir Noms de l’organisation et du compte (dans ce chapitre).

Noms de l’organisation et du compte

Nom de l’organisation

Le nom de l’organisation est un nom que vous avez choisi au moment où votre premier compte Snowflake était provisionné pour votre organisation. Le nom doit être unique parmi toutes les autres organisations de Snowflake. Il peut inclure des lettres majuscules et des chiffres, mais pas de caractères de soulignement ni d’autres délimiteurs.

Vous ne pouvez pas modifier vous-même le nom de votre organisation. Pour changer le nom de votre organisation, contactez l’assistance de 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.

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 :

nom_de_l’organisation-nom_du_compte

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 :

localisateur_compte.id_région_cloud ou

localisateur_compte.id_région_cloud.cloud

Où :

  • id_region_cloud 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 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 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 recommandé nom_organisation-nom_compte 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

Localisateur de 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

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

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

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.

Note

Actuellement, lorsqu’on utilise Format 1 (recommandé) : nom du compte dans votre organisation., l’URL de la connectivité privée vers le service Snowflake n’est pas prise en charge pour SnowSQL et d’autres clients Snowflake.

Comme solution de contournement lors de l’utilisation de SnowSQL ou d’autres clients Snowflake avec une connectivité privée au service Snowflake, utilisez le format d’URL présenté dans Format 2 (existant) : localisateur de compte dans une région.

Pour plus de détails, voir Utilisation des identificateurs de compte pour se connecter à vos comptes.

Identificateurs de comptes pour la réplication et le basculement

Si la fonction Organisation est activée pour votre compte, voir Format 1 (recommandé) : 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 :

id_région_snowflake.localisateur_compte

Où :

Pour plus de détails et une liste complète, voir IDs de région (dans ce chapitre).

De plus, 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 :

groupe_région.id_région_snowflake.nom

La valeur de groupe_région se trouve dans la sortie de SHOW REPLICATION ACCOUNTS.

Pour plus de détails, voir Groupes de régions (dans ce chapitre).

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

Une région Snowflake 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 région Snowflake 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 région Snowflake 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 région Snowflake 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 région Snowflake 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

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

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

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 région Snowflake 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