ALTER SERVICE¶

Ändert die Konfiguration von Snowpark Container Services-Diensten, aktualisiert den Code von Diensten und ermöglicht Ihnen das Anhalten oder Fortsetzen eines Dienstes. Sie können Folgendes tun:

Anwenden von Änderungen auf einen aktiven Dienst. Sie können zum Beispiel einen Dienst anhalten oder fortsetzen und die Anzahl der in Ausführung befindlichen Dienstinstanzen aktualisieren.
Anwenden von Änderungen, die erst nach dem Neustart des Dienstes wirksam werden. Geben Sie beispielsweise ein Standard-Warehouse für Abfragen an.
Anwenden von Änderungen, die dazu führen, dass Snowflake den Dienst herunterfährt und ihn mit neuem Code neu startet. Sie könnten so beispielweise aktualisierten Dienstcode bereitstellen.

Siehe auch:: CREATE SERVICE, DESCRIBE SERVICE, DROP SERVICE, SHOW SERVICES

Syntax¶

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

ALTER SERVICE [ IF EXISTS ] <name>
  {
    FROM @<stage>
    SPECIFICATION_FILE = '<yaml_file_stage_path>'
    |
    FROM SPECIFICATION <specification_text>
  }

ALTER SERVICE [ IF EXISTS ] <name> SET [ MIN_INSTANCES = <num> ]
                                       [ MAX_INSTANCES = <num> ]
                                       [ QUERY_WAREHOUSE = <warehouse_name> ]
                                       [ AUTO_RESUME = { TRUE | FALSE } ]
                                       [ COMMENT = '<string_literal>' ]

ALTER SERVICE [ IF EXISTS ] <name> UNSET { MIN_INSTANCES      |
                                           MAX_INSTANCES      |
                                           QUERY_WAREHOUSE    |
                                           AUTO_RESUME        |
                                           COMMENT
                                         }
                                         [ , ... ]

Copy

Parameter¶

name

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

{ SUSPEND | RESUME }

Gibt an, ob der Dienst angehalten oder fortgesetzt werden soll.

Wenn Sie einen Dienst anhalten, wird Snowflake heruntergefahren und die Container werden gelöscht. Wenn Sie später einen angehaltenen Dienst wieder fortsetzen, erstellt Snowflake die Container neu. Das heißt, Snowflake verwendet das Image aus Ihrem Repository und startet die Container. Wenn das Image im Repository aktualisiert wurde, verwendet Snowflake das aktualisierte Image, um die Container neu zu erstellen.

Wenn Sie einen angehaltenen Dienst entweder über eine Dienstfunktion oder über den öffentlichen Endpunkt (Dateneingang) aufrufen, setzt Snowflake den Dienst automatisch fort.

FROM stage

Gibt den Snowflake-internen Stagingbereich an, in dem die Spezifikationsdatei gespeichert ist, z. B. „@tutorial_stage“.

SPECIFICATION_FILE = 'yaml_file_stage_path'

Gibt den Pfad zur Dienstspezifikationsdatei im Stagingbereich an, z. B. „/some-dir/echo_spec.yaml“.

FROM SPECIFICATION specification_text

Gibt die Dienstspezifikation an. Sie können doppelte Dollarzeichen ($$) verwenden, um den Anfang und das Ende der Spezifikationszeichenfolge abzugrenzen.

SET ...

Legt eine oder mehrere angegebene Eigenschaften oder Parameter für den Dienst fest:

MIN_INSTANCES = num: Gibt die minimale Anzahl von Dienstinstanzen an.
MAX_INSTANCES = num: Gibt die maximale Anzahl von Dienstinstanzen an.
QUERY_WAREHOUSE = warehouse_name: Zu verwendendes Warehouse, wenn ein Dienstcontainer eine Verbindung zu Snowflake herstellt, um eine Abfrage auszuführen, aber das zu verwendende Warehouse nicht ausdrücklich angibt.
AUTO_RESUME = { TRUE | FALSE }: Gibt an, ob der Dienst automatisch fortgesetzt werden soll, wenn die Dienstfunktion aufgerufen wird oder eine Anforderung eingeht.
COMMENT = 'string_literal': Gibt einen Kommentar zum Computepool an.

UNSET ...

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

MIN_INSTANCES
MAX_INSTANCES
QUERY_WAREHOUSE
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	Dienst

Beachten Sie, dass für die Bearbeitung eines Objekts in einem Schema auch die Berechtigung USAGE für die übergeordnete Datenbank und das Schema erforderlich ist.

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¶

Halten Sie einen Dienst an.

ALTER SERVICE echo_service SUSPEND;

Copy

Ändern Sie die Eigenschaften MIN_INSTANCES und MAX_INSTANCES eines bestehenden Dienstes.

ALTER SERVICE echo_service SET MIN_INSTANCES=3 MAX_INSTANCES=5;

Copy