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:
Syntax¶
SHOW CONNECTIONS [ LIKE '<pattern>' ]
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 |
---|---|
|
Regionsgruppe, in der sich das Konto befindet. Hinweis: Diese Spalte wird nur für Organisationen angezeigt, die sich über mehrere Regionsgruppen erstrecken. |
|
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). |
|
Datum und Zeit der Erstellung der Verbindung |
|
Name des Kontos. Ein Organisationsadministrator kann den Kontonamen ändern. |
|
Name der Verbindung |
|
Kommentar zu der Verbindung |
|
Gibt an, ob es sich bei der Verbindung um eine Primärverbindung handelt. |
|
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. |
|
Eine Liste aller Konten, zu denen die Primärverbindung umgeleitet werden kann. |
|
Verbindungs-URL, die Benutzer an einen Client übergeben, um eine Verbindung zu Snowflake herzustellen. |
|
Name Ihrer Snowflake-Organisation |
|
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.
Zur Weiterverarbeitung der Ausgabe dieses Befehls können Sie die Funktion RESULT_SCAN verwenden, die die Ausgabe wie eine abfragbare Tabelle behandelt. Sie können auch den Pipe-Operator verwenden, um die Ausgabe dieses Befehls abzufragen.
Beispiele¶
Anzeigen aller globalen Konten, deren Name mit test
beginnt:
SHOW CONNECTIONS LIKE 'test%';