ALTER COMPUTE POOL¶

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> ]
                                            [ PLACEMENT_GROUP = '<placement_group_name>' ]
                                            [ INSTANCE_FAMILY = <instance_family_name> ]
                                            [ TAG <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' , ... ] ]
                                            [ COMMENT = '<string_literal>' ]

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

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.

TAG tag_name = 'tag_value' [ , tag_name = 'tag_value' , ... ]

Gibt den Namen des Tags und den Wert der Tag-Zeichenfolge an.

Der Tag-Wert ist immer eine Zeichenfolge, die maximale 256 Zeichen lang sein kann.

Weitere Informationen zur Angabe von Tags in einer Anweisung finden Sie unter Tag quotas.

PLACEMENT_GROUP = placement_group_name

Gibt die Platzierungsgruppe des Computepools an. Verwenden Sie die Befehle SHOW COMPUTE POOLS und DESCRIBE COMPUTE POOL, um die Zuweisung des Computepools zu Platzierungsgruppen zu überprüfen.

INSTANCE_FAMILY = instance_family_name

Gibt den Maschinentyp an, den Sie für die Knoten im Computepool bereitstellen möchten. Der Maschinentyp bestimmt über die Anzahl der Computeressourcen im Computepool und damit über die Anzahl der verbrauchten Credits während des Computepool-Betriebs. Eine Liste der verfügbaren Namen der Instanzfamilien finden Sie unter Instanzfamilien.

INSTANCE_FAMILY kann nur geändert werden, wenn ein Computepool vollständig angehalten ist. Beim Fortsetzen verwendet Snowflake den neuen Instanztyp, um den Computepool bereitzustellen.

COMMENT = 'string_literal'

Gibt einen Kommentar zum Computepool an.

UNSET ...

Specifies one or more properties and/or parameters to unset for the compute pool, which resets them to the defaults. For more information, see CREATE COMPUTE POOL:

• AUTO_SUSPEND_SECS

• AUTO_RESUME

• PLACEMENT_GROUP: Die Angabe der Platzierungsgruppe kann nur aufgehoben werden, wenn der Computepool vollständig angehalten ist.

• COMMENT

Anforderungen an die Zugriffssteuerung¶

Eine Rolle, die zur Ausführung dieser Operation verwendet wird, muss mindestens die folgenden Berechtigungen haben:

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

Im folgenden Beispiel wird für einen Computepool CPU_X64_S als INSTANCE_FAMILTY festgelegt. Da der Computepool angehalten werden muss, um die Instanzfamilie zu ändern, wird der Computepool zunächst angehalten:

ALTER COMPUTE POOL tutorial_compute_pool SUSPEND;
ALTER COMPUTE POOL tutorial_compute_pool SET
  INSTANCE_FAMILY = CPU_X64_S;
ALTER COMPUTE POOL tutorial_compute_pool RESUME;