DESCRIBE INTEGRATION¶
Beschreibt die Eigenschaften einer Integration.
DESCRIBE kann mit DESC abgekürzt werden.
- Siehe auch:
CREATE INTEGRATION, DROP INTEGRATION, ALTER INTEGRATION, SHOW INTEGRATIONS
- API-Integrationen:
- Katalogintegrationen:
- Integration für externen Zugriff:
ALTER EXTERNAL ACCESS INTEGRATION, CREATE EXTERNAL ACCESS INTEGRATION
- Benachrichtigungsintegrationen:
ALTER NOTIFICATION INTEGRATION, CREATE NOTIFICATION INTEGRATION
- Sicherheitsintegrationen:
- Speicherintegrationen:
Syntax¶
{ DESC | DESCRIBE } [ { API | CATALOG | EXTERNAL ACCESS | NOTIFICATION | SECURITY | STORAGE } ] INTEGRATION <name>
Parameter¶
{ API | CATALOG | EXTERNAL ACCESS | NOTIFICATION | SECURITY | STORAGE }Beschreibt eine Integration des angegebenen Typs.
Weitere Informationen zu einigen dieser Typen finden Sie in den folgenden Themen:
nameGibt den Bezeichner für die zu beschreibende Integration an.
Wenn der Bezeichner Leerzeichen oder Sonderzeichen enthält, muss die gesamte Zeichenfolge in doppelte Anführungszeichen gesetzt werden. Bei Bezeichnern, die in doppelte Anführungszeichen eingeschlossen sind, ist auch die Groß-/Kleinschreibung zu beachten.
Weitere Informationen dazu finden Sie unter Anforderungen an Bezeichner.
Nutzungshinweise¶
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
typeauszuwählen, geben SieSELECT "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.
Wenn die Integration eine API-Integration ist, enthält die Ausgabe die Spalte API_KEY. API_KEY zeigt einen maskierten Wert an, wenn ein API-Schlüssel eingegeben wurde. (Dabei wird weder der unverschlüsselte Originalschlüssel noch die verschlüsselte Version des Schlüssels angezeigt).
Wenn die Eigenschaft
TYPEder Sicherheitsintegration aufOAUTHgesetzt ist (d. h. Snowflake OAuth), gibt Snowflake zwei zusätzliche Sicherheitsintegrationseigenschaften im Abfrageergebnis zurück, die weder mit einem CREATE SECURITY INTEGRATION- noch mit einem ALTER SECURITY INTEGRATION-Befehl eingestellt werden können:OAUTH_ALLOWED_AUTHORIZATION_ENDPOINTSEine Liste aller unterstützten Endpunkte einer Clientanwendung, um einen Autorisierungscode von Snowflake zu erhalten.
OAUTH_ALLOWED_TOKEN_ENDPOINTSEine Liste aller unterstützten Endpunkte einer Clientanwendung, um den Autorisierungscode für ein Zugriffstoken auszutauschen oder ein Aktualisierungstoken zu erhalten.
Beispiele¶
Beschreiben Sie die Eigenschaften einer Integration namens my_int:
DESC INTEGRATION my_int;