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).
`idle_nodes`	Anzahl der Knoten im Computepool, die im Leerlauf sind (es wird kein Dienst oder Job ausgeführt).
`target_nodes`	Zeigt die Anzahl der Knoten an, auf die Snowflake für Ihren Computepool abzielt. Wenn `active_nodes` nicht gleich `target_nodes` ist, skaliert Snowflake den Cluster automatisch, um die Knoten hinzuzufügen oder zu entfernen. Die folgenden Beispiele zeigen, wie Sie die Werte in der Spalte `target_nodes` interpretieren können. Beispiel 1: Angenommen, Sie geben in einem CREATE COMPUTE POOL-Befehl MIN_NODES=1 und MAX_NODES=3 an. Während Snowflake einen Knoten bereitstellt, ist der Wert in den Spalten `active_nodes` und `idle_nodes` zunächst 0 und der Wert in der Spalte `target_nodes` ist 1. (Der Wert in der Spalte `target_nodes` entspricht dem Wert, den Sie für den Parameter MIN_NODES angegeben haben.) Dies zeigt an, dass es einen Knoten im Computepool geben sollte, den Snowflake bereitstellt. Nachdem Snowflake einen Knoten bereitgestellt hat, ist der Wert in der Spalte `idle_nodes` 1 (unter der Annahme, dass keine Dienste laufen). Der Wert in der Spalte `target_nodes` ist immer noch 1, was bedeutet, dass es einen Knoten im Computepool geben sollte. Beispiel 2: Snowflake könnte versuchen, aufgrund von Autoskalierung oder Änderungen der Mindestanzahl von Knoten (über ALTER COMPUTE POOL … SET MIN_NODES) einen Knoten zu einem bestehenden Computepool hinzuzufügen. Während Snowflake einen Knoten bereitstellt, lautet der Wert in der `state`-Spalte `resizing`. Um festzustellen, wie viele Knoten Snowflake hinzufügt, prüfen Sie den Wert in der Spalte `target_nodes`. Nehmen wir zum Beispiel an, der Wert in der Spalte `active_nodes` ist 1, der Wert in der Spalte `idle_nodes` ist 0 und Sie ändern die Größe des Computepools, indem Sie die Eigenschaft MIN_NODES von 1 auf 2 aktualisieren. In diesem Fall ist der Wert in der Spalte `target_nodes` 2 (die Anzahl der Knoten, die sich im Computepool befinden sollten). Daraus können Sie ableiten, dass Snowflake einen zusätzlichen Knoten bereitstellt.
`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.
`is_exclusive`	`true`, wenn der Computepool ausschließlich für eine Snowflake Native App erstellt wird; andernfalls `false`.
`application`	Name der Snowflake Native App, wenn der Computepool ausschließlich für die App erstellt wird. Ansonsten NULL.
`budget`	Der Name des Budgets zur Überwachung der Credit-Nutzung des Computepools.
`error_code`	Fehlercode, falls vorhanden, der für die STATUS_MESSAGE relevant ist. Andernfalls ist dieses Feld leer. Zum Beispiel, wenn Sie die Größe eines Computepools ändern: Wenn Snowflake auf einen Kapazitätsfehler stößt (neue Knoten können nicht bereitgestellt werden), gibt Snowflake den Fehlercode 392507 zurück. Beachten Sie, dass der Kapazitätsfehler darauf hinweist, dass der von Ihnen angefragte Instanztyp für Ihren Serverknoten beim Cloud-Anbieter derzeit nicht verfügbar ist. Sie können entweder warten, bis die Kapazität verfügbar wird, oder einen neuen Computepool mit einer anderen Instanzfamilie erstellen. Wenn Sie ausstehende Dienste (einschließlich Jobdienst) haben und Snowflake Ihren Computepool nicht aufwärts skalieren kann, gibt Snowflake den Fehlercode 392508 zurück.
`status_message`	Optionale Meldung über den Status des Computepools. Beispiel: Wenn Sie nach der Erstellung eines Computepools den Befehl DESC COMPUTE POOL ausführen, enthält die Ausgabe möglicherweise die Statusmeldung: „Der Computepool wird seit 1 Minute gestartet“. Wenn Snowflake bei der Bereitstellung eines Knotens auf einen Kapazitätsfehler stößt, kann die Ausgabe die folgende Statusmeldung enthalten: „Der Computepool wird seit 3 Minuten gestartet. Wir haben CAPACITY_ERROR beobachtet.“ Wenn Sie ausstehende Dienste (einschließlich Jobdienste) haben und Snowflake Ihren Computepool nicht hochskalieren kann, enthält die Ausgabe möglicherweise die Statusmeldung: „Der Computepool hat die maximale Knotengrenze erreicht. Erwägen Sie die Erhöhung von max_nodes mit dem Befehl ALTER COMPUTE POOL.“

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 | target_nodes | created_on                    | resumed_on                    | updated_on                    | owner     | comment | is_exclusive | application | budget | error_code | status_message |
|-----------------------+--------+-----------+-----------+-----------------+--------------+----------+-------------------+-------------+--------------+------------+--------------+-------------------------------+-------------------------------+-------------------------------+-----------+---------+--------------+-------------+--------+------------+----------------|
| TUTORIAL_COMPUTE_POOL | ACTIVE |         1 |         1 | CPU_X64_XS      |            3 |        0 |              3600 | true        |            1 |          0 |            1 | 2024-02-24 20:41:31.978 -0800 | 2024-08-08 11:27:01.775 -0700 | 2024-08-18 13:29:08.124 -0700 | TEST_ROLE | NULL    | false        | NULL        | NULL   |            |                |
+-----------------------+--------+-----------+-----------+-----------------+--------------+----------+-------------------+-------------+--------------+------------+--------------+-------------------------------+-------------------------------+-------------------------------+-----------+---------+--------------+-------------+--------+------------+----------------+