DESCRIBE CATALOG INTEGRATION¶

Beschreibt die Eigenschaften einer Katalogintegration.

DESCRIBE kann mit DESC abgekürzt werden.

Siehe auch:: CREATE CATALOG INTEGRATION , ALTER CATALOG INTEGRATION , DROP CATALOG INTEGRATION , SHOW CATALOG INTEGRATIONS

Syntax¶

DESC[RIBE] CATALOG INTEGRATION <name>

Copy

Parameter¶

name: Gibt den Bezeichner für die zu beschreibende Katalogintegration 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.

Ausgabe¶

Die Ausgabe des Befehls enthält die folgenden Spalten, die die Eigenschaften und Metadaten des Objekts beschreiben:

Spalte	Beschreibung
`property`	Der Name der Eigenschaft. Diese Spalte kann die in der folgenden Tabelle aufgeführten Eigenschaften enthalten.
`property_type`	Der Typ der Eigenschaft.
`property_value`	Der Wert, der der Eigenschaft zugewiesen ist.
`property_default`	Der Standardwert der Eigenschaft.

Die Spalte property kann die folgenden Eigenschaften eines Katalogintegrationsobjekts enthalten:

Eigenschaft	Beschreibung
`enabled`	Gibt an, ob die Katalogintegration für Apache Iceberg™-Tabellen verfügbar ist.
`catalog_source`	Der Typ der Katalogquelle, zum Beispiel `GLUE` oder `OBJECT_STORE`.
`catalog_namespace`	(AWS Glue) Gibt den AWS Glue Data Catalog-Namespace an.
`table_format`	Gibt das vom Katalog bereitgestellte Tabellenformat an, z. B. `ICEBERG`.
`glue_aws_role_arn`	(AWS Glue) Der Amazon Resource Name (ARN) der IAM-Rolle, die Snowflake annimmt, um eine Verbindung zu AWS Glue herzustellen.
`glue_catalog_id`	(AWS Glue) Die ID Ihres AWS-Kontos.
`glue_region`	(AWS Glue) Gibt die AWS-Region Ihres AWS Glue-Datenkatalogs an.
`glue_aws_iam_user_arn`	(AWS Glue) Die ARN des AWS-IAM-Benutzers, der für Ihr Snowflake-Konto erstellt wurde, als Sie die Katalogintegration erstellt haben.
`glue_aws_external_id`	(AWS Glue) Die externe ID, die Snowflake verwendet, um eine Vertrauensstellung mit AWS einzurichten.
`comment`	Kommentar zur Katalogintegration.

Anforderungen an die Zugriffssteuerung¶

Eine Rolle, die zur Ausführung dieses SQL-Befehls verwendet wird, muss mindestens die folgenden Berechtigungen haben:

Berechtigung	Objekt	Anmerkungen
USAGE	Integration (Katalog)

Eine Anleitung zum Erstellen einer kundenspezifischen Rolle mit einer bestimmten Gruppe von Berechtigungen finden Sie unter Erstellen von kundenspezifischen Rollen.

Allgemeine Informationen zu Rollen und Berechtigungen zur Durchführung von SQL-Aktionen auf sicherungsfähigen Objekten finden Sie unter Übersicht zur Zugriffssteuerung.

Nutzungshinweise¶

Um die Ausgabe dieses Befehls nachzubearbeiten, können Sie die Funktion RESULT_SCAN verwenden, die die Ausgabe wie eine abfragbare Tabelle behandelt.

Beispiele¶

Beschreiben einer Katalogintegration:

DESC CATALOG INTEGRATION my_catalog_integration;

Copy

Die folgende Abbildung zeigt die Ausgabe von DESCRIBE CATALOG INTEGRATION für eine AWS Glue-Katalogintegration. Die Ausgabe umfasst AWS Glue-spezifische Eigenschaften (z. B. GLUE_AWS_ROLE_ARN) und allgemeine Eigenschaften der Katalogintegration.

+-----------------------+---------------+----------------------------------+------------------+
|       property        | property_type |          property_value          | property_default |
+-----------------------+---------------+----------------------------------+------------------+
| ENABLED               | Boolean       | true                             | false            |
| CATALOG_SOURCE        | String        | GLUE                             |                  |
| CATALOG_NAMESPACE     | String        | dbname                           |                  |
| TABLE_FORMAT          | String        | ICEBERG                          |                  |
| GLUE_AWS_ROLE_ARN     | String        | arn:aws:iam::123:role/dummy-role |                  |
| GLUE_CATALOG_ID       | String        | 123456789012                     |                  |
| GLUE_REGION           | String        | us-west-2                        |                  |
| GLUE_AWS_IAM_USER_ARN | String        | arn:aws:iam::123:user/example    |                  |
| GLUE_AWS_EXTERNAL_ID  | String        | exampleGlueExternalId            |                  |
| COMMENT               | String        |                                  |                  |
+-----------------------+---------------+----------------------------------+------------------+