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:
Öffnen Sie die Kontoauswahl, und prüfen Sie die Liste der Konten, bei denen Sie sich zuvor angemeldet haben.
Suchen Sie das Konto, für das Sie den Kontonamen kopieren möchten.
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.
- SQL:
Um den Namen des aktuellen Kontos abzurufen, führen Sie die Funktion CURRENT_ACCOUNT_NAME aus.
Um die Organisation des aktuellen Kontos abzurufen, führen Sie die Funktion CURRENT_ORGANIZATION_NAME aus.
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
odergcp
).
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:
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-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)
|
|
Keine zusätzlichen Segmente erforderlich. |
US Gov West 1
|
|
|
US Gov West 1 (FedRAMP High Plus)
|
|
|
US East (Ohio)
|
|
|
US East (N. Virginia)
|
|
Die Cloudregions-ID ist das einzige erforderliche zusätzliche Segment. |
US East (Commercial Gov - N. Virginia)
|
|
|
Canada (Central)
|
|
|
South America (Sao Paulo)
|
|
|
EU (Irland)
|
|
Die Cloudregions-ID ist das einzige erforderliche zusätzliche Segment. |
Europe (London)
|
|
|
EU (Paris)
|
|
|
EU (Frankfurt)
|
|
Die Cloudregions-ID ist das einzige erforderliche zusätzliche Segment. |
EU (Stockholm)
|
|
|
Asia Pacific (Tokio)
|
|
|
Asia Pacific (Osaka)
|
|
|
Asia Pacific (Seoul)
|
|
|
Asia Pacific (Mumbai)
|
|
|
Asia Pacific (Singapur)
|
|
Die Cloudregions-ID ist das einzige erforderliche zusätzliche Segment. |
Asia Pacific (Sydney)
|
|
Die Cloudregions-ID ist das einzige erforderliche zusätzliche Segment. |
Asia Pacific (Jakarta)
|
|
|
Google Cloud Platform (GCP) |
||
US Central1 (Iowa)
|
|
|
US East4 (N. Virginia)
|
|
|
Europe West2 (London)
|
|
|
Europe West4 (Niederlande)
|
|
|
Microsoft Azure |
Die Azure-Konto-Locator wurden aus Gründen der Konsistenz mit AWS und GCP mit Bindestrichen implementiert. |
|
West US 2 (Washington)
|
|
|
Central US (Iowa)
|
|
|
South Central US (Texas)
|
|
|
East US 2 (Virginia)
|
|
|
US Gov Virginia
|
|
|
Canada Central (Toronto)
|
|
|
UK South (London)
|
|
|
North Europe (Irland)
|
|
|
West Europe (Niederlande)
|
|
|
Switzerland North (Zürich)
|
|
|
UAE North (Dubai)
|
|
|
Central India (Pune)
|
|
|
Japan East (Tokio)
|
|
|
Southeast Asia (Singapur)
|
|
|
Australia East (New South Wales)
|
|
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 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)
|
|
|
Nur für Business Critical-Konten (oder höher) verfügbar, die sich in AWS GovCloud (US) befinden. |
US East (Ohio)
|
|
|
|
US East (N. Virginia)
|
|
|
|
US East (Commercial Gov - N. Virginia)
|
|
|
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)
|
|
|
|
South America (Sao Paulo)
|
|
|
|
EU (Irland)
|
|
|
|
Europe (London)
|
|
|
|
EU (Paris)
|
|
|
|
EU (Frankfurt)
|
|
|
|
EU (Stockholm)
|
|
|
|
Asia Pacific (Tokio)
|
|
|
|
Asia Pacific (Osaka)
|
|
|
|
Asia Pacific (Seoul)
|
|
|
|
Asia Pacific (Mumbai)
|
|
|
|
Asia Pacific (Singapur)
|
|
|
|
Asia Pacific (Sydney)
|
|
|
|
Asia Pacific (Jakarta)
|
|
|
|
Google Cloud Platform (GCP) |
|||
US Central1 (Iowa)
|
|
|
|
US East4 (N. Virginia)
|
|
|
|
Europe West2 (London)
|
|
|
|
Europe West4 (Niederlande)
|
|
|
|
Microsoft Azure |
|||
West US 2 (Washington)
|
|
|
|
Central US (Iowa)
|
|
|
|
South Central US (Texas)
|
|
|
|
East US 2 (Virginia)
|
|
|
|
US Gov Virginia
|
|
|
Nur für Business Critical-Konten (oder höher) verfügbar, die sich in Microsoft Azure Government befinden. |
Canada Central (Toronto)
|
|
|
|
UK South (London)
|
|
|
|
North Europe (Irland)
|
|
|
|
West Europe (Niederlande)
|
|
|
|
Switzerland North (Zürich)
|
|
|
|
UAE North (Dubai)
|
|
|
|
Central India (Pune)
|
|
|
|
Japan East (Tokio)
|
|
|
|
Southeast Asia (Singapur)
|
|
|
|
Australia East (New South Wales)
|
|
|
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.