DESCRIBE COMPUTE POOL¶

Beschreibt die Eigenschaften eines Computepools.

DESCRIBE kann mit DESC abgekürzt werden.

Siehe auch:: CREATE COMPUTE POOL, ALTER COMPUTE POOL, DROP COMPUTE POOL, SHOW COMPUTE POOLS

Syntax¶

DESC[RIBE] COMPUTE POOL <name>

Copy

Parameter¶

name

Gibt den Bezeichner für den zu beschreibenden Computepool 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 des Computepools in den folgenden Spalten:

Spalte	Beschreibung
`name`	Name des Computepools.
`state`	Aktueller Status des Computepools.
`min_nodes`	Minimale Anzahl von Knoten im Computepool.
`max_nodes`	Maximale Anzahl von Knoten im Computepool.
`instance_family`	Gibt den Maschinentyp der Knoten im Computepool an.
`num_services`	Anzahl der Dienste und Jobs, die im Computepool ausgeführt werden.
`num_jobs`	Anzahl der Jobs, die im Computepool ausgeführt werden.
`auto_suspend_secs`	Gibt die Anzahl der Sekunden der Inaktivität an, nach der der Computepool automatisch angehalten wird.
`auto_resume`	Gibt an, ob ein Computepool automatisch fortgesetzt werden soll, wenn Snowflake versucht, einen Dienst oder Job zu starten.
`active_nodes`	Anzahl der Knoten im Computepool, die aktiv sind (ein oder mehrere Dienste oder Jobs werden ausgeführt).
`created_on`	Datum und Uhrzeit der Erstellung des Computepools.
`resumed_on`	Datum und Uhrzeit, zu der der angehaltene Computepool fortgesetzt wurde.
`updated_on`	Datum und Uhrzeit, zu der der Computepool mit ALTER COMPUTE POOL aktualisiert wurde.
`owner`	Rolle, die Eigentümerin des Computepools ist.
`comment`	Gibt einen Kommentar zum Computepool an.

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	Computepool

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 Computepool namens tutorial_compute_pool:

DESCRIBE COMPUTE POOL tutorial_compute_pool;

Copy

Beispielausgabe:

+-----------------------+--------+-----------+-----------+-----------------+--------------+----------+-------------------+-------------+--------------+------------+-------------------------------+-------------------------------+-------------------------------+--------------+---------+
| name                  | state  | min_nodes | max_nodes | instance_family | num_services | num_jobs | auto_suspend_secs | auto_resume | active_nodes | idle_nodes | created_on                    | resumed_on                    | updated_on                    | owner        | comment |
|-----------------------+--------+-----------+-----------+-----------------+--------------+----------+-------------------+-------------+--------------+------------+-------------------------------+-------------------------------+-------------------------------+--------------+---------|
| TUTORIAL_COMPUTE_POOL | ACTIVE |         1 |         1 | CPU_X64_XS      |            1 |        0 |                 0 | false       |            1 |          0 | 2023-05-01 11:42:20.323 -0700 | 2023-05-01 11:42:20.326 -0700 | 2023-08-27 17:35:52.761 -0700 | ACCOUNTADMIN | NULL    |
+-----------------------+--------+-----------+-----------+-----------------+--------------+----------+-------------------+-------------+--------------+------------+-------------------------------+-------------------------------+-------------------------------+--------------+---------+