SHOW REGIONS¶

Listet alle Regionen auf, in denen Konten erstellt werden können. Dieser Befehl gibt den Namen der Snowflake Region, den Cloudanbieter (AWS, Google Cloud Platform oder Microsoft Azure), der das Konto hostet, und den Namen des Cloudanbieters für die Region zurück.

Siehe auch:: CURRENT_REGION

Syntax¶

SHOW REGIONS [ LIKE '<pattern>' ]

Copy

Parameter¶

LIKE 'pattern'

Filtert optional die Befehlsausgabe nach dem Objektnamen. Der Filter verwendet einen Musterabgleich ohne Berücksichtigung der Groß-/Kleinschreibung, aber mit Unterstützung von SQL-Platzhalterzeichen (% und _).

Die folgenden Muster geben beispielsweise die gleichen Ergebnisse zurück:

... LIKE '%testing%' ...

... LIKE '%TESTING%' ...

. Standard: Kein Wert (die Ausgabe wird nicht gefiltert).

Ausgabe¶

Die Befehlsausgabe stellt Eigenschaften und Metadaten der Region in den folgenden Spalten bereit. Die Befehlsausgabe für Organisationen, die sich über mehrere Regionsgruppen erstrecken, enthält eine zusätzliche Spalte region_group.

Spalte	Beschreibung
`region_group`	Regionsgruppe, in der sich das Konto befindet. Hinweis: Diese Spalte wird nur für Organisationen angezeigt, die sich über mehrere Regionsgruppen erstrecken.
`snowflake_region`	Snowflake Region, in der sich das Konto befindet. Eine Snowflake Region ist ein bestimmter Speicherort innerhalb einer Cloudplattform-Region. Eine Snowflake Region ist von jeder anderen Snowflake Region isoliert ist. Eine Snowflake Region kann entweder für Einzelmandanten oder für mehrere Mandanten sein (für ein virtuelles privates Snowflake-Konto).
`cloud`	Name des Cloudanbieters, der das Konto hostet.
`region`	Region, in der sich das Konto befindet, d. h. der Name des Cloudanbieters für die Region.
`display_name`	Besser lesbarer Name der Cloudregion, z. B. `US West (Oregon)`

Nutzungshinweise¶

Für die Ausführung des Befehls ist kein aktives Warehouse erforderlich.
Der Befehl gibt nur Objekte zurück, für die der aktuellen Rolle des aktuellen Benutzers mindestens ein Zugriffsrecht zugewiesen wurde.
Das Zugriffsrecht MANAGE GRANTS gibt seinem Eigentümer implizit die Möglichkeit, jedes Objekt im Konto anzuzeigen. Standardmäßig haben nur der Kontoadministrator (Benutzer mit der Rolle ACCOUNTADMIN) und der Systemadministrator (Benutzer mit der Rolle SECURITYADMIN) die Berechtigung MANAGE GRANTS.

Um die Ausgabe dieses Befehls nachzubearbeiten, können Sie den Befehl Pipe-Operator (->>) oder die RESULT_SCAN-Funktion verwenden. Beide Konstrukte behandeln die Ausgabe als Resultset, das Sie abfragen können.

Sie können zum Beispiel den Pipe-Operator oder die RESULT_SCAN-Funktion verwenden, um bestimmte Spalten aus der SHOW-Befehlsausgabe auszuwählen oder die Zeilen zu filtern.

Wenn Sie sich auf die Ausgabespalten beziehen, verwenden Sie Bezeichner mit doppelten Anführungszeichen für die Spaltennamen. Um beispielsweise die Ausgabespalte type auszuwählen, geben Sie SELECT "type" an.

Sie müssen Bezeichner in doppelten Anführungszeichen verwenden, da die Ausgabespaltennamen für SHOW-Befehle in Kleinbuchstaben geschrieben sind. Die doppelten Anführungszeichen stellen sicher, dass die Spaltennamen in der SELECT-Liste oder WHERE-Klausel den Spaltennamen in der SHOW-Befehlsausgabe entsprechen, die gescannt wurde.