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:

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:

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.

Zurück zum Anfang