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 Details dazu finden Sie unter Anforderungen an Bezeichner.

STOP ALL

Hält 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