Kontobezeichner

Ein Kontobezeichner ermöglicht das eindeutige Identifizieren eines Snowflake-Kontos innerhalb Ihrer Organisation sowie im gesamten globalen Netzwerk der von Snowflake unterstützten Cloudplattformen und Cloudregionen.

Der bevorzugte Kontobezeichner umfasst den Namen des Kontos zusammen mit der Organisation (z. B. myorg-account123). Obwohl Sie auch den von Snowflake zugewiesenen Locator als Kontobezeichner verwenden können, wird von der Verwendung dieses veralteten Formats abgeraten.

Wo werden Kontobezeichner verwendet?

Kontobezeichner sind in Snowflake überall dort erforderlich, wo Sie das verwendete Konto angeben müssen, einschließlich:

  • URLs für den Zugriff auf eine der Snowflake-Weboberflächen.

  • SnowSQL und andere Clients (Konnektoren, Treiber usw.) für die Verbindung mit Snowflake

  • Anwendungen und Dienste von Drittanbietern, die das Snowflake-Ökosystem bilden

  • Sicherheitsfeatures für die Snowflake-internen Operationen und für die Kommunikation/Interaktion mit externen Systemen

  • Globale Features wie Secure Data Sharing, Datenbankreplikation und Failover/Failback

Beispielsweise verwendet URL für ein Konto das folgende Format:

account_identifier.snowflakecomputing.com

Wenn Ihr Unternehmen das Feature Clientumleitung verwendet, kann zum Herstellen der Verbindung zu einem Snowflake-Konto über einen Snowflake-Client als Kontobezeichner der Name eines Verbindungsobjekts anstelle des Kontonamens verwendet werden. Weitere Informationen dazu finden Sie unter Verwenden einer Verbindungs-URL.

Weitere Informationen zur Verwendung von Kontobezeichnern und Verbindungen zur Verbindung eines Snowflake-Kontos finden Sie unter Verbinden mit Ihren Konten.

Format 1 (bevorzugt): Kontoname in Ihrer Organisation

Eine Organisation ist ein Snowflake-Objekt, das alle zu Ihrer Geschäftseinheit gehörenden Konten miteinander verknüpft. Mit Organisationen können Organisationsadministratoren (d. h. Benutzern mit der Rolle ORGADMIN) alle Ihre Konten über verschiedene Regionen und Cloudplattformen hinweg anzeigen, erstellen und verwalten.

Kontonamen müssen innerhalb Ihrer Organisation eindeutig sein. Sie können geändert werden, was mehr Flexibilität ermöglicht und zu kürzeren und intuitiveren Kontonamen führt. Sie geben einen Kontonamen an, wenn Sie ein neues Konto erstellen (siehe Erstellen eines Kontos). Weitere Informationen zum Ändern des Namens eines bestehenden Kontos finden Sie unter Umbenennen eines Kontos.

Während der Kontoname ein Konto innerhalb Ihrer Organisation eindeutig identifiziert, ist er kein eindeutiger Bezeichner eines Kontos unter allen Snowflake-Organisationen.

Kontonamen mit Unterstrichen haben auch eine Bindestrich-Version der URL für Features, die URLs mit Unterstrichen nicht akzeptieren, wie z. B. Okta SSO/SCIM.

Verwenden eines Kontonamens als Bezeichner

Der Kontobezeichner eines Kontos in Ihrer Organisation hat eine der folgenden Formen, je nachdem, wo und wie der Bezeichner verwendet wird:

  • orgname-account_name (für die meisten URLs und andere allgemeine Verwendungszwecke)

  • orgname-account-name (für Szenarios/Features, bei denen Unterstriche in einem Kontonamen nicht unterstützt werden)

  • orgname.account_name (für SQL-Befehle und -Operationen)

Wobei:

  • orgname ist der Name Ihrer Snowflake-Organisation.

  • account_name ist der eindeutige Name für Ihr Konto innerhalb Ihrer Organisation.

Suchen von Organisations- und Kontonamen eines Kontos

Um den Kontonamen für ein Konto zu finden, können Sie Snowsight oder SQL verwenden.

Snowsight:
  1. Öffnen Sie die Kontoauswahl, und prüfen Sie die Liste der Konten, bei denen Sie sich zuvor angemeldet haben.

    Screenshot der geöffneten Kontoauswahl mit einer Auflistung mehrerer Konten. Die Kontoauswahl ist mit dem Namen des aktuell ausgewählten Kontos beschriftet.
  2. Suchen Sie das Konto, für das Sie den Kontonamen kopieren möchten.

  3. Bewegen Sie den Mauszeiger über das Konto, um zusätzliche Details anzuzeigen, und wählen Sie dann das Kopiersymbol aus, um den Kontobezeichner im Format <orgname>.<account_name> in Ihre Zwischenablage zu kopieren.

    Screenshot der geöffneten Kontoauswahl mit einer Auflistung mehrerer Konten, wobei der Mauszeiger über ein Konto bewegt wird, um ein zusätzliches Fenster mit Informationen zu dem Konto anzuzeigen, und über die Option zum Kopieren des Kontobezeichners.
SQL:

Organisation und Kontonamen

Name der Organisation

Für Benutzer, die sich über die Self-Service-Option für ein Snowflake-Konto registrieren, wird beim Erstellen des Kontos automatisch eine Organisation mit einem vom System generierten Namen erstellt. Bei Entitäten, die beim Einrichten von Konten direkt mit Snowflake-Mitarbeitern zusammenarbeiten, kann Snowflake der Organisation einen kundenspezifischen Namen zuweisen. Dieser kundenspezifische Name muss unter allen in Snowflake registrierten Organisationen eindeutig sein. Der Name muss mit einem Buchstaben beginnen und darf nur Buchstaben (Klein- und Großbuchstaben) und Zahlen enthalten. Der Name darf keine Unterstriche oder andere Trennzeichen enthalten.

Wenn Sie den Namen einer Organisation ändern möchten, z. B. um einen vom System generierten Namen in einen benutzerfreundlicheren Namen zu ändern, wenden Sie sich an den Snowflake-Support.

Es empfiehlt sich, den Namen Ihrer Organisation erst sorgfältig zu überprüfen und gegebenenfalls zu ändern, bevor Sie ihn in Kontobezeichnern verwenden. Wenn Sie den Namen der Organisation in Zukunft umbenennen, werden alle URLs für Ihre Snowflake-Konten an den neuen Namen angepasst.

Weitere Informationen zum Anzeigen des Namens Ihrer Organisation finden Sie unter Anzeigen des Namens Ihrer Organisation und der zugehörigen Konten.

Kontoname

Jeder Kontoname muss innerhalb Ihrer Organisation eindeutig sein. Sie geben einen Kontonamen an, wenn Sie das Konto erstellen (siehe Erstellen eines Kontos).

Während der Kontoname ein Konto innerhalb Ihrer Organisation eindeutig identifiziert, ist er kein eindeutiger Bezeichner eines Kontos unter allen Snowflake-Organisationen. Damit ein Konto in Snowflake eindeutig identifiziert werden kann, muss dem Kontonamen der Name der Organisation vorangestellt werden. Beispiel:

orgname-account_name

In Übereinstimmung mit den SQL-Standards für Bezeichner können Kontonamen Unterstriche als Trennzeichen zwischen Wörtern enthalten (z. B. MARKETING_TEST_ACCOUNT).

URLs, die Unterstriche enthalten, können manchmal Probleme bei bestimmten Features verursachen, z. B. bei Okta SSO/SCIM. Aus diesem Grund unterstützt Snowflake auch eine Version des Kontonamens, bei der anstelle des Unterstrichs ein Bindestrich (-) verwendet wird. So werden beispielsweise die beiden folgenden URLs unterstützt:

URL mit Unterstrichen: https://acme-marketing_test_account.snowflakecomputing.com

URL mit Bindestrichen: https://acme-marketing-test-account.snowflakecomputing.com

Vorhandene Konten

Wenn Sie Konten haben, die bereits vor der Aktivierung des Features „Organisationen“ bestanden, wird der Format 2 (älter): Konto-Locator in einer Region als Kontoname verwendet.

Wenn Sie Konten mit demselben Namen in verschiedenen Regionen haben, werden dem Kontonamen im neuen URL-Format um die Namen von Cloud und Region ergänzt.

Wenn der Name der Organisation beispielsweise ACME lautet und es zwei Konten mit dem Namen TEST gibt, eines in der Region AWS us-east-2 und das andere in der Region west-us-2, haben die neuen URLs folgende Struktur:

  • Erstes Konto:

    Ursprüngliche URL:

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

    Neue URL:

    https://acme-test_aws_us_east_2.snowflakecomputing.com

  • Zweites Konto:

    Ursprüngliche URL:

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

    Neue URL:

    https://acme-test_azure_west_us_2.snowflakecomputing.com

Diese Kontonamen können geändert werden, solange die neuen Namen eindeutig sind. Eine Anleitung zum Ändern eines Kontonamens finden Sie unter Umbenennen eines Kontos.

Format 2 (älter): Konto-Locator in einer Region

Ein Konto-Locator ist ein Bezeichner, der von Snowflake beim Erstellen des Kontos zugewiesen wird:

  • Wenn das Konto von einem Snowflake-Vertreter erstellt wird, können Sie möglicherweise einen bestimmten Wert für den Locator anfordern, z. B. einen Firmennamen, ein Akronym oder eine andere erkennbare Zeichenfolge.

  • Wenn das Konto durch Self-Service oder einen automatisierten Prozess/Hintergrundprozess erstellt wurde, ist der Locator eine zufällige Zeichenfolge aus eindeutigen Zeichen und Zahlen (z. B. xy12345).

Der Locator für ein Konto kann nicht mehr geändert werden, sobald das Konto erstellt wurde.

Bemerkung

Konto-Locator werden weiterhin für die Identifizierung von Konten in Snowflake unterstützt, sind aber nicht mehr die bevorzugte Methode. Die bevorzugte Methode zur Identifizierung von Konten ist nun der Kontoname innerhalb Ihrer Organisation (wie weiter oben unter diesem Thema beschrieben).

Verwenden eines Konto-Locators als Bezeichner

Jedes Snowflake-Konto wird auf einer Cloudplattform in einer geografischen Region gehostet.

Die Region bestimmt, wo die Daten im Konto gespeichert werden und wo die vom Konto verwendeten Computeressourcen bereitgestellt werden.

Wenn Sie einen Konto-Locator zur Identifizierung eines Kontos verwenden, reicht der Locator allein nicht immer aus, um das Konto zu ermitteln. Je nach Region und Cloudplattform für das Konto können zusätzliche Segmente erforderlich sein, in Form von:

account_locator.cloud_region_id oder

account_locator.cloud_region_id.cloud

Wobei:

  • cloud_region_id ist der Bezeichner der Cloudregion (wird von der Cloudplattform vorgegeben).

  • cloud ist der Bezeichner der Cloudplattform (aws, azure oder gcp).

Wenn Ihr Konto-Locator z. B. xy12345 ist:

  • Wenn sich das Konto in der Region AWS US West (Oregon) befindet, sind keine zusätzlichen Segmente erforderlich und die URL wäre xy12345.snowflakecomputing.com.

  • Wenn sich das Konto in der Region AWS US East (Ohio) befindet, sind zusätzliche Segmente erforderlich und die URL würde xy12345.us-east-2.aws.snowflakecomputing.com lauten.

Eine vollständige Liste der Regionen und Locator-Formate finden Sie unter Nicht-VPS-Konto-Locator-Formate nach Cloudplattform und Cloudregion (unter diesem Thema).

Bemerkung

Wenn Ihre Snowflake-Edition VPS ist, verwendet der Konto-Locator ein anderes Format. Weitere Informationen dazu finden Sie unter Suchen des Konto-Locator-Formats eines VPS-Kontos (unter diesem Thema).

Ermitteln von Region und Locator eines Kontos

Wenn Sie eine Verbindung zu Ihrem Snowflake-Konto herstellen können, können Sie folgende Kontextfunktionen abfragen, um die Region und den Konto-Locator für das Snowflake-Konto zu ermitteln, mit dem Sie verbunden sind:

Wenn Sie keine Verbindung zu Snowflake herstellen können, wenden Sie sich an den Snowflake-Administrator für Ihr Konto, um diese Informationen abzurufen.

Suchen des Konto-Locator-Formats eines VPS-Kontos

Wenn Ihre Snowflake-Edition VPS ist, verwendet der Konto-Locator-Format andere Namenskonventionen als bei Konten anderer Snowflake-Editionen. Dies führt zu einer anderen Struktur für Hostnamen und URLs, die für den Zugriff auf VPS-Konten verwendet werden.

Weitere Informationen dazu erhalten Sie beim Snowflake-Support oder von Ihrem Snowflake-Vertreter.

Alternativ können Sie für den Kontobezeichner das bevorzugte Format organization_name-account_name verwenden. Dieses Format funktioniert für Konten der VPS Edition. Weitere Details dazu finden Sie unter Format 1 (bevorzugt): Kontoname in Ihrer Organisation (unter diesem Thema).

Nicht-VPS-Konto-Locator-Formate nach Cloudplattform und Region

Die folgende Tabelle listet die Konto-Locator-Formate für alle unterstützten Nicht-VPS-Regionen auf, einschließlich der Angabe, ob der Konto-Locator für eine bestimmte Region zusätzliche Segmente erfordert.

Wenn Ihr Konto-Locator xy12345 ist:

Cloudplattform/Region

Kontobezeichner

Anmerkungen

Amazon Web Services (AWS)

US West (Oregon)

xy12345

Keine zusätzlichen Segmente erforderlich.

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 East (N. Virginia)

xy12345.us-east-1

Die Cloudregions-ID ist das einzige erforderliche zusätzliche Segment.

US East (Commercial Gov - N. Virginia)

xy12345.us-east-1-gov.aws

Canada (Central)

xy12345.ca-central-1.aws

South America (Sao Paulo)

xy12345.sa-east-1.aws

EU (Irland)

xy12345.eu-west-1

Die Cloudregions-ID ist das einzige erforderliche zusätzliche Segment.

Europe (London)

xy12345.eu-west-2.aws

EU (Paris)

xy12345.eu-west-3.aws

EU (Frankfurt)

xy12345.eu-central-1

Die Cloudregions-ID ist das einzige erforderliche zusätzliche Segment.

EU (Stockholm)

xy12345.eu-north-1.aws

Asia Pacific (Tokio)

xy12345.ap-northeast-1.aws

Asia Pacific (Osaka)

xy12345.ap-northeast-3.aws

Asia Pacific (Seoul)

xy12345.ap-northeast-2.aws

Asia Pacific (Mumbai)

xy12345.ap-south-1.aws

Asia Pacific (Singapur)

xy12345.ap-southeast-1

Die Cloudregions-ID ist das einzige erforderliche zusätzliche Segment.

Asia Pacific (Sydney)

xy12345.ap-southeast-2

Die Cloudregions-ID ist das einzige erforderliche zusätzliche Segment.

Asia Pacific (Jakarta)

xy12345.ap-southeast-3.aws

Google Cloud Platform (GCP)

US Central1 (Iowa)

xy12345.us-central1.gcp

US East4 (N. Virginia)

xy12345.us-east4.gcp

Europe West2 (London)

xy12345.europe-west2.gcp

Europe West4 (Niederlande)

xy12345.europe-west4.gcp

Microsoft Azure

Die Azure-Konto-Locator wurden aus Gründen der Konsistenz mit AWS und GCP mit Bindestrichen implementiert.

West US 2 (Washington)

xy12345.west-us-2.azure

Central US (Iowa)

xy12345.central-us.azure

South Central US (Texas)

xy12345.south-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

UK South (London)

xy12345.uk-south.azure

North Europe (Irland)

xy12345.north-europe.azure

West Europe (Niederlande)

xy12345.west-europe.azure

Switzerland North (Zürich)

xy12345.switzerland-north.azure

UAE North (Dubai)

xy12345.uae-north.azure

Central India (Pune)

xy12345.central-india.azure

Japan East (Tokio)

xy12345.japan-east.azure

Southeast Asia (Singapur)

xy12345.southeast-asia.azure

Australia East (New South Wales)

xy12345.australia-east.azure

Kontobezeichner für private Konnektivität

Wenn für Ihr Konto private Konnektivität zum Snowflake-Dienst aktiviert ist und Sie dieses Feature für die Verbindung zu Snowflake verwenden möchten, führen Sie die Funktion SYSTEM$GET_PRIVATELINK_CONFIG aus, um die zu verwendende private Konnektivitäts-URL zu bestimmen. Sie können in der URL entweder den Kontonamen oder den Konto-Locator verwenden, um eine Verbindung zur Snowflake-Weboberfläche herzustellen.

Wenn Sie eine Verbindung zu Snowsight über private Konnektivität herstellen möchten, verwenden Sie die Anleitung unter Anmelden bei Snowsight.

Kontobezeichner für Replikation und Failover

Bei der bevorzugten Methode zum Identifizieren eines Kontos in SQL-Befehlen für Replikation und Failover werden der Name der Organisation und der Kontoname als Kontobezeichner verwendet. Wenn Sie sich entscheiden, stattdessen den alten Konto-Locator zu verwenden, muss dieser möglicherweise zusätzliche Segmente enthalten, um das Konto eindeutig zu identifizieren. Siehe Tabelle unten als Referenz:

Kontobezeichner

Speicherort des Remotekontos

organization_name.account_name

Bevorzugter Kontobezeichner, der unabhängig von der Region oder Regionsgruppe des Kontos, das die Primärdatenbank speichert, verwendet werden kann.

account_locator

Dieselbe Region, aber ein anderes Konto als das Konto, in dem die Primärdatenbank gespeichert ist.

snowflake_region.account_locator

Dieselbe Regionsgruppe, aber eine andere Region als das Konto, in dem die Primärdatenbank gespeichert ist.

region_group.snowflake_region.account_locator

Andere Regionsgruppe des Kontos, in dem die Primärdatenbank gespeichert ist.

Die Werte von snowflake_region und region_group sind in der Ausgabe von SHOW REPLICATION ACCOUNTS zu finden.

Snowflake Regions-IDs und Regionsgruppen

Eine Snowflake Region ist eine eigenständige Region (innerhalb einer AWS, Azure- oder GCP-Cloudregion), die von anderen Snowflake Regionen isoliert ist. Eine Snowflake Region kann entweder für mehrere Mandanten (enthält Konten mehrerer Organisationen) oder für Einzelmandanten (ein Virtual Private Snowflake-Konto) sein.

Jede Snowflake Region hat einen eindeutigen Bezeichner und gehört zu einer Regionsgruppe, die globale Features wie Data Sharing und Replikation ermöglicht.

Regions-IDs

Da jede Cloudplattform unterschiedliche Konventionen und Formate für die Benennung ihrer Regionen verwendet, weist Snowflake jeder Snowflake Region eine kanonischeID zu, mit der sie sich über alle Cloudplattformen und Cloudregionen hinweg eindeutig identifizieren lässt.

Wenn das Feature „Organisationen“ aktiviert ist, muss beim Erstellen eines Kontos oder beim Konfigurieren von Replikation/Failover die Snowflake Region-ID als Teil eines Kontobezeichners unbedingt angegeben werden.

In der folgenden Tabelle wird die vollständige Liste der Snowflake Regions-IDs angezeigt:

Cloudregion

Cloudregions-ID

Snowflake Regions-ID

Anmerkungen

Amazon Web Services (AWS)

US West (Oregon)

us-west-2

aws_us_west_2

US Gov West 1

us-gov-west-1

aws_us_gov_west_1

Nur für Business Critical-Konten (oder höher) verfügbar, die sich in AWS GovCloud (US) befinden.

US Gov West 1 (FedRAMP High Plus)

fhplus.us-gov-west-1.aws

aws_us_gov_west_1_fhplus

Nur für Business Critical-Konten (oder höher) verfügbar, die sich in AWS GovCloud (US) befinden.

US East (Ohio)

us-east-2

aws_us_east_2

US East (N. Virginia)

us-east-1

aws_us_east_1

US East (Commercial Gov - N. Virginia)

us-east-1

aws_us_gov_east_1

Nur für Business Critical-Konten (oder höher) verfügbar, die sich in Region US East 1, aber nicht in AWS GovCloud (US) befinden.

Canada (Central)

ca-central-1

aws_ca_central_1

South America (Sao Paulo)

sa-east-1

aws_sa_east_1

EU (Irland)

eu-west-1

aws_eu_west_1

Europe (London)

eu-west-2

aws_eu_west_2

EU (Paris)

eu-west-3

aws_eu_west_3

EU (Frankfurt)

eu-central-1

aws_eu_central_1

EU (Stockholm)

eu-north-1

aws_eu_north_1

Asia Pacific (Tokio)

ap-northeast-1

aws_ap_northeast_1

Asia Pacific (Osaka)

ap-northeast-3

aws_ap_northeast_3

Asia Pacific (Seoul)

ap-northeast-2

aws_ap_northeast_2

Asia Pacific (Mumbai)

ap-south-1

aws_ap_south_1

Asia Pacific (Singapur)

ap-southeast-1

aws_ap_southeast_1

Asia Pacific (Sydney)

ap-southeast-2

aws_ap_southeast_2

Asia Pacific (Jakarta)

ap-southeast-3

aws_ap_southeast_3

Google Cloud Platform (GCP)

US Central1 (Iowa)

us-central1

gcp_us_central1

US East4 (N. Virginia)

us-east4

gcp_us_east4

Europe West2 (London)

europe-west2

gcp_europe_west2

Europe West4 (Niederlande)

europe-west4

gcp_europe_west4

Microsoft Azure

West US 2 (Washington)

westus2

azure_westus2

Central US (Iowa)

centralus

azure_centralus

South Central US (Texas)

southcentralus

azure_southcentralus

East US 2 (Virginia)

eastus2

azure_eastus2

US Gov Virginia

usgovvirginia

azure_usgovvirginia

Nur für Business Critical-Konten (oder höher) verfügbar, die sich in Microsoft Azure Government befinden.

Canada Central (Toronto)

canadacentral

azure_canadacentral

UK South (London)

uk-south

azure_uksouth

North Europe (Irland)

northeurope

azure_northeurope

West Europe (Niederlande)

westeurope

azure_westeurope

Switzerland North (Zürich)

switzerlandnorth

azure_switzerlandnorth

UAE North (Dubai)

uaenorth

azure_uaenorth

Central India (Pune)

central-india.azure

azure_centralindia

Japan East (Tokio)

japaneast

azure_japaneast

Southeast Asia (Singapur)

southeastasia

azure_southeastasia

Australia East (New South Wales)

australiaeast

azure_australiaeast

Regionsgruppen

Eine Regionsgruppe ist eine Gruppe von Snowflake Regionen, die ähnliche Sicherheitssteuerelemente sowie ähnliche Formen der Isolation und Compliance bieten. Die Regionsgruppe, zu der eine Snowflake Region gehört, ist je nach Region unterschiedlich:

  • Alle kommerziellen mandantenfähigen Snowflake Regionen (über alle unterstützten Cloudplattformen hinweg) befinden sich in derselben gemeinsamen/allgemeinen Gruppe PUBLIC.

  • Jede Snowflake Region für Regierungsbehörden mit mehreren Mandanten befindet sich in einer separaten Gruppe der jeweiligen Region.

  • Jedes Virtual Private Snowflake (VPS)-Konto eines Einzelmandanten befindet sich in einer separaten, VPS-spezifischen Regionsgruppe. Wenn Ihre Organisation mehrere VPS-Konten hat, können Sie ein VPS-Konto pro Regionsgruppe haben, oder mehrere VPS-Konten können sich dieselbe Regionsgruppe teilen.

Beim Erstellen von Konten in verschiedenen Regionsgruppen muss die Regionsgruppe als Teil des Kontobezeichners angegeben werden.