ALTER COMPUTE POOL

Ändert die Eigenschaften eines vorhandenen Computepools.

Siehe auch:

CREATE COMPUTE POOL, DESCRIBE COMPUTE POOL, DROP COMPUTE POOL, SHOW COMPUTE POOLS

Syntax

ALTER COMPUTE POOL [ IF EXISTS ] <name> { SUSPEND | RESUME }

ALTER COMPUTE POOL [ IF EXISTS ] <name> STOP ALL;

ALTER COMPUTE POOL [ IF EXISTS ] <name> SET [ MIN_NODES = <num> ]
                                            [ MAX_NODES = <num> ]
                                            [ AUTO_RESUME = { TRUE | FALSE } ]
                                            [ AUTO_SUSPEND_SECS = <num> ]
                                            [ COMMENT = '<string_literal>' ]

ALTER COMPUTE POOL [ IF EXISTS ] <name> UNSET { AUTO_SUSPEND_SECS |
                                                AUTO_RESUME       |
                                                COMMENT
                                              }
                                              [ , ... ]
Copy

Parameter

name

Gibt den Bezeichner für den zu ändernden 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.

{ SUSPEND | RESUME }

Hält einen Computepool an oder setzt einen zuvor angehaltenen Computepool wieder fort. Wenn Sie einen Computepool anhalten, hält Snowflake alle Dienste in diesem Computepool an, aber die Jobs werden weiter ausgeführt, bis sie einen Endstatus (DONE oder FAILED) erreicht haben, nach dem die Computepool-Knoten freigegeben werden.

STOP ALL

Löscht alle Dienste an und bricht Jobs ab, die im Computepool ausgeführt werden. Snowflake entfernt dann alle Container aus dem Computepool.

SET ...

Legt eine oder mehrere spezifizierte Eigenschaften oder Parameter für den Computepool fest:

MIN_NODES = num

Gibt die minimale Anzahl von Knoten im Computepool an.

MAX_NODES = num

Gibt die maximale Anzahl von Knoten im Computepool an.

AUTO_RESUME = { TRUE | FALSE }

Gibt an, ob ein Computepool automatisch fortgesetzt werden soll, wenn ein Dienst oder Job an ihn übermittelt wird. Wenn AUTO_RESUME gleich FALSE ist, müssen Sie den Computepool explizit fortsetzen (mit ALTER COMPUTE POOL <name> RESUME), bevor Sie einen Dienst oder Job im Computepool starten können.

AUTO_SUSPEND_SECS = num

Anzahl der Sekunden der Inaktivität, nach denen Snowflake den Computepool automatisch anhalten soll. Inaktivität bedeutet, dass auf keinem Knoten im Computepool Dienste oder Jobs ausgeführt werden.

COMMENT = 'string_literal'

Gibt einen Kommentar zum Computepool an.

UNSET ...

Gibt eine (oder mehrere) Eigenschaften und/oder Parameter an, deren Einstellungen für den Computepool wieder aufgehoben werden sollen, wodurch sie auf die Standardwerte (siehe CREATE COMPUTE POOL) zurückgesetzt werden:

  • AUTO_SUSPEND_SECS

  • AUTO_RESUME

  • COMMENT

Anforderungen an die Zugriffssteuerung

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

Berechtigung

Objekt

Anmerkungen

OPERATE

Computepool

Um einen Computepool anzuhalten oder fortzusetzen, benötigt die Rolle diese Berechtigungen.

MODIFY

Computepool

Um den Computepool zu ändern und Eigenschaften festzulegen, benötigt die Rolle diese Berechtigung.

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

  • Metadaten:

    Achtung

    Kunden müssen sicherstellen, dass bei der Nutzung des Snowflake-Dienstes keine personenbezogenen Daten (außer für ein Objekt „Benutzer“), sensible Daten, exportkontrollierte Daten oder andere regulierte Daten als Metadaten eingegeben werden. Weitere Informationen dazu finden Sie unter Metadatenfelder in Snowflake.

Beispiele

Im folgenden Beispiel werden für einen Computepool die Eigenschaften MAX_NODES und AUTO_RESUME festgelegt:

ALTER COMPUTE POOL tutorial_compute_pool SET
  MAX_NODES = 5
  AUTO_RESUME = FALSE
Copy