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.

Snowflake unterstützt zwei verschiedene Formate für die Identifizierung eines Snowflake-Kontos. Sie können ein Konto anhand seines Namens innerhalb Ihrer Organisation oder anhand seines in Snowflake zugewiesenen Locators innerhalb der Cloudregion identifizieren, in der sich das Konto befindet.

Bemerkung

Sie können beide Formate verwenden. Um das erste Format verwenden zu können, muss allerdings in einem Ihrer Konten eine ORGADMIN-Rolle erstellt werden. Wenn die Rolle nicht vorhanden ist, wenden Sie sich an den Snowflake-Support.

Unter diesem Thema:

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

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

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

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

Kontobezeichner.snowflakecomputing.com

Weitere Informationen zur Verwendung von Kontobezeichnern in URLs und Snowflake-Clients finden Sie unter Verwenden von Kontobezeichnern für die Verbindung mit Ihren Konten.

Format 1 (bevorzugt): Kontoname in Ihrer Organisation

Eine Organisation ist in Snowflake ein First-Class-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). Um den Namen eines bestehenden Kontos zu ändern, wenden Sie sich an den Snowflake-Support.

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 Funktionen, die URLs mit Unterstrichen nicht akzeptieren, wie z. B. SSO/SCIM in Okta.

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:

• Organisationsname-Kontoname (für die meisten URLs und andere allgemeine Verwendungszwecke)

• Organisationsname_Kontoname (für Szenarien/Funktionen, bei denen Bindestriche in URLs nicht unterstützt werden)

• Organisationsname.Kontoname (für SQL-Befehle und -Operationen)

Wobei:

• Organisationsname ist der Name Ihrer Snowflake-Organisation.

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

Weitere Details dazu finden Sie unter Organisation und Kontonamen (unter diesem Thema).

Organisation und Kontonamen

Name der Organisation

Der Organisationsname ist ein Name, den Sie bei der Einrichtung Ihres ersten Snowflake-Kontos für Ihre Organisation wählen. Der Name muss unter allen in Snowflake registrierten Organisationen eindeutig sein. Er kann Großbuchstaben und Zahlen enthalten, aber keine Unterstriche oder andere Trennzeichen.

Sie können den Namen Ihrer Organisation nicht selbst ändern. Wenn Sie den Namen Ihrer Organisation ändern möchten, 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.

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, müssen Sie dem Kontonamen der Name der Organisation vorangestellt werden. Beispiel:

Organisationsname-Kontoname

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 Funktionen verursachen, z. B. bei SSO/SCIM in Okta. 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 „Organisationen“-Features 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 Ändern des Kontonamens.

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 Kontos zu ermitteln. Je nach Region und Cloudplattform für das Konto können zusätzliche Segmente erforderlich sein, in Form von:

Konto-Locator.ID_der_Cloudregion oder

Konto-Locator.ID_der_Cloudregion.Cloud

Wobei:

• ID_der_Cloudregion ist der Identifikator der Cloudregion (wird von der Cloudplattform vorgegeben).

• Cloud ist der Identifikator 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-Locators 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:

• CURRENT_REGION ruft die Region ab, in der sich Ihr Konto befindet.

• CURRENT_ACCOUNT ruft den Konto-Locator ab.

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-Locators eines VPS-Kontos

Wenn Ihre Snowflake-Edition VPS ist, verwendet der Konto-Locator 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 Organisationsname-Kontoname 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	Konto-Locator	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 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
EU (Irland)	xy12345.eu-west-1	Die Cloudregions-ID ist das einzige erforderliche zusätzliche Segment.
Europe (London)	xy12345.eu-west-2.aws
EU (Frankfurt)	xy12345.eu-central-1	Die Cloudregions-ID ist das einzige erforderliche zusätzliche Segment.
Asia Pacific (Tokio)	xy12345.ap-northeast-1.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.
Google Cloud Platform (GCP)
US Central1 (Iowa)	xy12345.us-central1.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
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
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 aktiviert ist (siehe Private Konnektivität zum Snowflake-Dienst) 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.

Bemerkung

Derzeit wird die Verwendung des Kontonamenformats (siehe Format 1 (bevorzugt): Kontoname in Ihrer Organisation) in der URL für private Konnektivität zum Snowflake-Dienst für SnowSQL und andere Snowflake-Clients nicht unterstützt.

Als Problemumgehung kann bei der Verwendung von SnowSQL oder anderer Snowflake-Clients mit privater Konnektivität zum Snowflake-Dienst das unter Format 2 (älter): Konto-Locator in einer Region gezeigte URL-Format verwendet werden.

Weitere Details dazu finden Sie unter Verwenden von Kontobezeichnern für die Verbindung mit Ihren Konten.

Kontobezeichner für Replikation und Failover

Wenn das „Organisationen“-Feature für Ihr Konto aktiviert ist, finden Sie entsprechende Informationen unter Format 1 (bevorzugt): Kontoname in Ihrer Organisation.

Replikations- und Failover-bezogene SQL-Befehle erfordern die Verwendung der Snowflake-Regions-ID als Teil des Kontobezeichners:

ID_der_Snowflake-Region.Konto-Locator

Wobei:

• Snowflake-Regions-ID

  Snowflake-Regions-ID

• Konto-Locator

  Der Konto-Locator für Replikationsbefehle ist der Wert der Spalte account_locator in SHOW REPLICATION ACCOUNTS oder SHOW REPLICATION DATABASES.

Weitere Details und eine vollständige Liste finden Sie unter Regions-IDs (unter diesem Thema).

Außerdem müssen Sie bei Replikation und Failover über verschiedene Regionsgruppen hinweg im Kontobezeichner auch die Regionsgruppe angeben.

Regionsgruppe.Snowflake-Regions-ID.Name

Der Wert für Regionsgruppe ist in der Ausgabe von SHOW REPLICATION ACCOUNTS zu finden.

Weitere Details dazu finden Sie unter Regionsgruppen (unter diesem Thema).

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 „Organisationen“-Feature aktiviert ist, muss beim Erstellen eines Kontos oder beim Konfigurieren von Replikation/Failover die Snowflake-Regions-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 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_east_1_gov	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
EU (Irland)	eu-west-1	aws_eu_west_1
Europe (London)	eu-west-2	aws_eu_west_2
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 (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
Google Cloud Platform (GCP)
US Central1 (Iowa)	us-central1	gcp_us_central1
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
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
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.

Wenn das „Organisationen“-Feature aktiviert ist, muss beim Erstellen von Konten in verschiedenen Regionalgruppen oder bei Replikation/Failover von/zu Konten in verschiedenen Regionsgruppen die Regionsgruppe als Teil des Kontobezeichners angegeben werden.