DESCRIBE SERVICE¶

Beschreibt die Eigenschaften eines Snowpark Container Services-Dienstes.

DESCRIBE kann mit DESC abgekürzt werden.

Siehe auch:: CREATE SERVICE, ALTER SERVICE, DROP SERVICE, SHOW SERVICES

Syntax¶

DESC[RIBE] SERVICE <name>

Copy

Parameter¶

name

Gibt den Bezeichner für den zu beschreibenden Dienst 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ß- und Kleinschreibung zu beachten.

Weitere Details dazu finden Sie unter Anforderungen an Bezeichner.

Ausgabe¶

Die Befehlsausgabe enthält Eigenschaften und Metadaten in den folgenden Spalten:

Spalte	Beschreibung
`name`	Snowpark Container Services-Dienstname.
`database_name`	Datenbank, in der der Dienst erstellt wird.
`schema_name`	Schema, in dem der Dienst erstellt wird.
`owner`	Rolle, die Eigentümer des Dienstes ist.
`compute_pool`	Name des Computepools, in dem Snowflake den Dienst ausführt.
`spec`	Dienstspezifikationsdatei. Die Ausgabe enthält diese Spalte nur, wenn Sie bei der Ausführung des Befehls die Rolle des Diensteigentümers verwenden.
`dns_name`	Von Snowflake zugewiesener DNS-Name des Dienstes. Der DNS-Name ermöglicht die Dienst-zu-Dienst-Kommunikation (siehe Tutorial 3).
`min_instances`	Minimale Anzahl von Dienstinstanzen, die Snowflake ausführen kann.
`max_instances`	Maximale Anzahl von Dienstinstanzen, die Snowflake bei Bedarf skalieren kann.
`auto_resume`	Bei „true“ setzt Snowflake den angehaltenen Dienst automatisch fort, wenn die Dienstfunktion aufgerufen oder eine eingehende Anfrage (Dateneingang) empfangen wird (siehe Verwenden eines Dienstes).
`external_access_integrations`	Liste der Integrationen für den externen Zugriff, die mit dem Dienst verbunden sind. Weitere Informationen dazu finden Sie unter Ausgehender Netzwerk-Datenverkehr.
`created_on`	Zeitstempel, wann der Dienst erstellt wurde.
`updated_on`	Zeitstempel, wann der Dienst zuletzt aktualisiert wurde.
`resumed_on`	Zeitstempel, wann der Dienst zuletzt fortgesetzt wurde.
`comment`	Kommentar zum Dienst.
`owner_role_type`	Typ der Rolle, die Eigentümer des Objekts ist, entweder ROLE oder DATABASE_ROLE.
`query_warehouse`	Wenn ein Dienstcontainer eine Verbindung zu Snowflake herstellt, um eine Abfrage auszuführen, und nicht ausdrücklich ein zu verwendendes Warehouse angibt, verwendet Snowflake dieses Warehouse als Standard.

Anforderungen an die Zugriffssteuerung¶

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

Berechtigung	Objekt	Anmerkungen
MONITOR	Dienst

Beachten Sie, dass für die Bearbeitung eines Objekts in einem Schema auch die Berechtigung USAGE für die übergeordnete Datenbank und das Schema erforderlich ist.

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¶

Das folgende Beispiel beschreibt den Dienst namens echo_service:

DESCRIBE SERVICE echo_service;

Copy

+--------------------+---------------+-------------+----------+-----------------------+-----------------------------------------------------------------------+---------------+---------------+-------------+--------------------------------+-------------------------------+--------------------------------+------------+---------+-----------------+-----------------+
| name               | database_name | schema_name | owner    | compute_pool          | dns_name                                                              | min_instances | max_instances | auto_resume | external_access_integrations   | created_on                    | updated_on                     | resumed_on | comment | owner_role_type | query_warehouse |
|--------------------+---------------+-------------+----------+-----------------------+-----------------------------------------------------------------------+---------------+---------------+-------------+--------------------------------+-------------------------------+--------------------------------+------------+---------------------------+-----------------|
| ECHO_SERVICE       | TUTORIAL_DB   | DATA_SCHEMA | TST_ROLE | TUTORIAL_COMPUTE_POOL | echo-service.data-schema.tutorial-db.snowflakecomputing.internal      |             1 |             1 | true        | ["example_access_integration"] |2023-10-26 10:53:32.150 -0700  | 2023-10-31 23:56:49.041 -0700  | NULL       | NULL    | ROLE            | NULL            |
+--------------------+---------------+-------------+----------+-----------------------+-----------------------------------------------------------------------+---------------+---------------+-------------+--------------------------------+-------------------------------+--------------------------------+------------+---------+-----------------+-----------------+