Kategorien:

DDL für Konten und Sitzungen

SHOW CONNECTIONS

Listet die Verbindungen auf, für die Sie Zugriffsrechte haben.

Die Ausgabe gibt Verbindungsmetadaten und -eigenschaften zurück, die nach Verbindungsname sortiert sind (Beschreibungen der Ausgabespalten finden Sie hier unter Ausgabe). Dies sollte beachtet werden, wenn Sie die Ergebnisse mit den bereitgestellten Filtern filtern möchten.

Siehe auch:

CREATE CONNECTION, DROP CONNECTION

Syntax

SHOW CONNECTIONS [ LIKE '<pattern>' ]

Parameter

LIKE 'Muster'

Filtert die Befehlsausgabe nach dem Objektnamen. Der Filter verwendet eine Mustererkennung 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%' ...

Nutzungshinweise

  • Für die Ausführung des Befehl ist kein aktives Warehouse erforderlich.

  • Zur Weiterverarbeitung der Ausgabe dieses Befehls können Sie die Funktion RESULT_SCAN verwenden, die die Ausgabe wie eine abfragbare Tabelle behandelt.

  • Dieser SQL-Befehl kann nur von Kontoadministratoren (d. h. Benutzer mit der Rolle ACCOUNTADMIN) ausgeführt werden.

Ausgabe

Die Befehlsausgabe stellt Eigenschaften und Metadaten der Verbindung in den folgenden Spalten bereit:

| snowflake_region | created_on | account_name | name | comment | is_primary | primary | failover_allowed_to_acounts | connection_url | organization_name | account_locator

Die Befehlsausgabe für Organisationen, die sich über mehrere Regionsgruppen erstrecken, enthält eine zusätzliche Spalte region_group:

| region_group | snowflake_region | created_on | account_name | name | comment | is_primary | primary | failover_allowed_to_acounts | connection_url | organization_name | account_locator

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, der von anderen Snowflake-Regionen isoliert ist. Eine Snowflake-Region kann entweder für Einzelmandanten oder für mehrere Mandanten sein (für ein Virtual Private Snowflake-Konto).

created_on

Datum und Zeit der Erstellung der Verbindung

account_name

Name des Kontos. Der Kontoname kann von einem Organisationsadministrator (d. h. ein Benutzer mit der Rolle ORGADMIN) geändert werden.

name

Name der Verbindung

comment

Kommentar zu der Verbindung

is_primary

Gibt an, ob es sich bei der Verbindung um eine Primärverbindung handelt.

primary

Organisationsname, Kontoname und Verbindungsname der Primärverbindung. Dieser Wert kann bei der Erstellung von Sekundärverbindungen in die AS REPLICA OF-Klausel des CREATE CONNECTION-Befehls kopiert werden.

failover_allowed_to_accounts

Eine Liste aller Konten, zu denen die Primärverbindung umgeleitet werden kann.

connection_url

Verbindungs-URL, die Benutzer an einen Client übergeben, um eine Verbindung zu Snowflake herzustellen.

organization_name

Name Ihrer Snowflake-Organisation

account_locator

Konto-Locator in einer Region.

Weitere Informationen zu den Eigenschaften, die zu einer Verbindung angegeben werden können, finden Sie unter CREATE CONNECTION.

Beispiele

Anzeigen aller globalen Konten, deren Name mit test beginnt:

SHOW CONNECTIONS LIKE 'test%';