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 muss beachtet werden, wenn Sie die Ergebnisse mit den bereitgestellten Filtern filtern möchten.

Siehe auch:: CREATE CONNECTION, ALTER CONNECTION, DROP CONNECTION

Syntax¶

SHOW CONNECTIONS [ 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 Verbindung 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 Virtual Private Snowflake-Konto).
`created_on`	Datum und Zeit der Erstellung der Verbindung
`account_name`	Name des Kontos. Ein Organisationsadministrator kann den Kontonamen ändern.
`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.

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 mit dem Pipe-Operator oder der RESULT_SCAN-Funktion bestimmte Spalten aus der SHOW-Befehlsausgabe auswählen oder die Zeilen filtern.

Wenn Sie sich auf die Ausgabespalten beziehen, verwenden Sie Bezeichner mit doppelten Anführungszeichen für die Spaltennamen. Beispiel: Zur Auswahl der Ausgabespalte type geben Sie SELECT "type" an.

Sie müssen Bezeichner in doppelten Anführungszeichen verwenden, da die Ausgabespaltennamen für SHOW-Befehle in Kleinbuchstaben geschrieben werden. 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.

Beispiele¶

Anzeigen aller globalen Konten, deren Name mit test beginnt:

SHOW CONNECTIONS LIKE 'test%';

Copy