Kontobezeichner

Ein Kontobezeichner ermöglicht die eindeutige Identifizierung eines Snowflake-Kontos innerhalb Ihrer Geschäftseinheit sowie im gesamten globalen Netzwerk der von Snowflake unterstützten Cloudplattformen und Cloudregionen.

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

Bemerkung

Es können beide Optionen verwendet werden. Um die erste Option zu verwenden, muss jedoch eine ORGADMIN-Rolle in einem Ihrer Konten 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, Treiber, Konnektoren und andere Clients für die Verbindung mit Snowflake.

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

  • Funktionen zur Sicherung der Snowflake-internen Operationen und der 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 Treibern finden Sie unter Verwenden von Kontobezeichnern für die Verbindung mit Ihren Konten.

Option 1: 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.

Der Kontoname muss innerhalb Ihrer Organisation eindeutig sein und kann 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 einen Namen für ein bestehendes Konto 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. 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:

  • 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

    Name Ihrer Snowflake-Organisation.

  • Kontoname

    Eindeutiger Name für Ihr Konto innerhalb Ihrer Organisation.

Weitere Informationen zu Organisations- und Kontonamen finden Sie unter Organisation und Kontoname (unter diesem Thema).

Organisation und Kontoname

Name der Organisation

Der Organisationsname ist der vom Kunden gewählte Name. Der Name muss unter allen Snowflake-Organisationen eindeutig sein. Er kann Großbuchstaben und Zahlen enthalten, aber keine Unterstriche oder andere Trennzeichen.

Wenn Sie den Namen Ihrer Organisation ändern möchten, wenden Sie sich an den Snowflake-Support.

Als bewährte Methode sollten Sie den Organisationsnamen erst überprüfen und ggf. ändern, bevor Sie ihn als Bezeichner verwenden. Wenn Sie den Organisationsnamen in Zukunft umbenennen, werden auch alle Konto-URLs umbenannt.

Weitere Informationen zur Identifizierung des Namens Ihrer Organisation finden Sie unter Anzeigen des Namens Ihrer Organisation.

Kontoname

Der Kontoname muss innerhalb Ihrer Organisation eindeutig sein. Sie geben einen Kontonamen an, wenn Sie ein neues 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.

Um ein Konto in Snowflake eindeutig zu identifizieren, müssen Sie den Kontonamen an den Namen der Organisation anhängen. Beispiel: <organization_name>-<account_name>.

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

In Übereinstimmung mit den SQL-Standards für Bezeichner können Kontonamen Unterstriche als Trennzeichen zwischen Wörtern enthalten (z. B. MARKETING_TEST_ACCOUNT), aber nur Unterstriche. Dadurch werden Konto-URLs generiert, die Unterstrichen enthalten.

URLs mit Unterstrichen können manchmal Probleme bei bestimmten Funktionen verursachen. Für diese URLs veröffentlicht Snowflake eine separate Version der URL, die nur Bindestriche enthält.

Die beiden folgenden URLs sind beispielsweise gleichermaßen verwendbar:

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

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

Vorhandene Konten

Wenn ein bestehendes Konto zu einer Organisation hinzugefügt wird, wird das anstelle des Kontonamens der Option 2: Konto-Locator in einer Region verwendet.

Wenn Sie Konten mit dem gleichen Namen in verschiedenen Regionen haben, werden die Namen von Cloud und Region dem Kontonamen im neuen URL-Format vorangestellt.

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 Azure West US 2, sehen die Konto-URLs wie folgt aus:

Ursprüngliche Konto-URL 1: https://test.us-east-2.aws.snowflakecomputing.com

Ursprüngliche Konto-URL 2: https://test.west-us-2.azure.snowflakecomputing.com

Neue Konto-URL 1: https://acme-test_aws_us_east_2.snowflakecomputing.com

Neue Konto-URL 2: 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.

Option 2: 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.

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

Konto-Locator.Regions-ID oder

Konto-Locator.Regions-ID.Cloud

Wobei:

  • Regions-ID

    Bezeichner für die Cloudregion (wird von der Cloudplattform vorgegeben).

  • Cloud

    Bezeichner für die 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 Locator-Formate nach Cloudplattform und Region (unter diesem Thema).

Bemerkung

Wenn Ihre Snowflake-Edition VPS ist, verwendet der Konto-Locator ein anderes Format. Siehe Suchen des Konto-Locators eines VPS-Kontos.

Suchen der Region und des Locators für Ihr Konto

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.

Locator-Formate nach Cloudplattform und Region

Die folgende Tabelle listet die Konto-Locator-Formate für alle unterstützten 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 . (mit zusätzlichen Segmenten, falls erforderlich)

Amazon Web Services (AWS)
US West (Oregon)

xy12345
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
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
Europe (London)

xy12345.eu-west-2.aws
EU (Frankfurt)

xy12345.eu-central-1
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
Asia Pacific (Sydney)

xy12345.ap-southeast-2

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
West US 2 (Washington)

xy12345.west-us-2.azure
Central US (Iowa)

xy12345.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
Japan East (Tokio)

xy12345.japan-east.azure
Southeast Asia (Singapur)

xy12345.southeast-asia.azure
Australia East (New South Wales)

xy12345.australia-east.azure

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 Informationen dazu finden Sie unter Option 1: Kontoname in Ihrer Organisation.

Kontobezeichner für private Konnektivität

Wenn AWS PrivateLink, Azure Private Link oder Google Cloud Private Service Connect für Ihr Konto aktiviert ist und Sie eine private Konnektivität zur Verbindung mit Snowflake verwenden möchten, führen Sie die Funktion SYSTEM$GET_PRIVATELINK_CONFIG aus, um die zu verwendende private Konnektivitäts-URL zu bestimmen.

Weitere Details zur privaten Konnektivität finden Sie unter Private Konnektivität zum Snowflake-Dienst.

Kontobezeichner für Replikation und Failover

Wenn Sie die Funktion „Organisation“ für Ihr Konto aktiviert haben, finden Sie unter Option 1: Kontoname in Ihrer Organisation weitere Informationen.

Replikations- und Failover-bezogene SQL-Befehle erfordern die Verwendung der Snowflake-Regions-ID als Teil des Kontobezeichners. Weitere Details und eine vollständige Liste finden Sie unter Snowflake-Regions-IDs (unter diesem Thema).

Snowflake-Region.Konto-Locator

Wobei:

Für Replikation und Failover über verschiedene Regionsgruppen hinweg müssen Sie im Kontobezeichner auch die Regionsgruppe angeben. Weitere Details dazu finden Sie unter Regionsgruppen (unter diesem Thema).

Die Spalte region_group befindet sich in der Ausgabe von SHOW REPLICATION ACCOUNTS.

Regionsgruppe.Snowflake-Regions-ID.Name

Regionsgruppen

Eine Regionsgruppe ist eine Gruppe von Regionen, die ähnliche Sicherheitssteuerelemente sowie ähnliche Formen der Isolation und Compliance bieten. Die Angabe der Regionsgruppe als Teil des Kontobezeichners ist erforderlich, wenn Sie die Funktion „Organisationen“ aktiviert haben und Konten in verschiedenen Regionsgruppen erstellen möchten, oder für die Replikation und das Failover zu und von Konten in verschiedenen Regionsgruppen.

Snowflake-Konten gehören zu einer von drei Regionsgruppen:

  • PUBLIC ist die Regionsgruppe für alle mandantenfähige Snowflake-Regionen über alle Clouds hinweg.

  • Virtual Private Snowflake (VPS)-Regionengruppen enthalten eine Gruppe von Einzelmandanten-(VPS)-Regionen, die zum selben Kunden gehören.

  • Regionsgruppen für Regierungsbehörden enthalten Regionen für Regierungsbehörden.

Snowflake-Regions-IDs

Eine Snowflake-Region ist ein bestimmter Speicherort innerhalb einer Cloudplattform-Region, der von anderen Snowflake-Regionen isoliert ist. Sie kann entweder für Einzelmandanten oder für mehrere Mandanten sein (für ein Virtual Private Snowflake-Konto). Die Angabe der Snowflake-Regions-ID als Teil des Kontobezeichners ist erforderlich, wenn Sie beim Erstellen eines neuen Kontos die Funktion „Organisationen“ aktiviert haben sowie beim Konfigurieren von Replikation und Failover.

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

Region

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

aws_us_east_2
US East (N. Virginia)

us-east-1

aws_us_east_1
US East (Commercial Gov - N. Virginia)

us-east-1-gov.aws

aws_us_east_1_gov

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

ca-central-1.aws

aws_ca_central_1
EU (Irland)

eu-west-1

aws_eu_west_1
Europe (London)

eu-west-2.aws

aws_eu_west_2
EU (Frankfurt)

eu-central-1

aws_eu_central_1
Asia Pacific (Tokio)

ap-northeast-1.aws

aws_ap_northeast_1
Asia Pacific (Seoul)

ap-northeast-2.aws

aws_ap_northeast_2
Asia Pacific (Mumbai)

ap-south-1.aws

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

gcp_us_central1
Europe West2 (London)

europe-west2.gcp

gcp_europe_west2
Europe West4 (Niederlande)

europe-west4.gcp

gcp_europe_west4

Microsoft Azure
West US 2 (Washington)

west-us-2.azure

azure_westus2
Central US (Iowa)

central-us.azure

azure_centralus
East US 2 (Virginia)

east-us-2.azure

azure_eastus2
US Gov Virginia

us-gov-virginia.azure

azure_usgovvirginia

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

canada-central.azure

azure_canadacentral
North Europe (Irland)

north-europe.azure

azure_northeurope
West Europe (Niederlande)

west-europe.azure

azure_westeurope
Switzerland North (Zürich)

switzerland-north.azure

azure_switzerlandnorth
Japan East (Tokio)

japan-east.azure

azure_japaneast
Southeast Asia (Singapur)

southeast-asia.azure

azure_southeastasia
Australia East (New South Wales)

australia-east.azure

azure_australiaeast