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 Informationen 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            |
+--------------------+---------------+-------------+----------+-----------------------+-----------------------------------------------------------------------+---------------+---------------+-------------+--------------------------------+-------------------------------+--------------------------------+------------+---------+-----------------+-----------------+