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