ALTER NOTEBOOK¶

Ändert die Eigenschaften eines vorhandenen Notebooks.

Syntax¶

ALTER NOTEBOOK [ IF EXISTS ] <name> RENAME TO <new_name>

ALTER NOTEBOOK [ IF EXISTS ] <name> SET
  [ VERSION = '<version_alias_name>' ]
  [ COMMENT = '<string_literal>' ]
  [ DEFAULT_VERSION = '<default_version_name_or_alias>' ]
  [ QUERY_WAREHOUSE = <warehouse_to_run_nb_and_sql_queries_in> ]
  [ IDLE_AUTO_SHUTDOWN_TIME_SECONDS = <number_of_seconds> ]
  [ SECRETS = ('<secret_variable_name>' = <secret_name>) [ , ... ] ]

ALTER NOTEBOOK [ IF EXISTS ] <name> UNSET
  [ QUERY_WAREHOUSE ]
  [ COMMENT ]

ALTER NOTEBOOK <name> ADD LIVE VERSION
  [ FROM LAST ]
  [ COMMENT = '<string_literal>' ]

ALTER NOTEBOOK <name> COMMIT [ VERSION '<live_version_alias>' ] [ COMMENT = '<string_literal>' ]

Copy

Parameter¶

name

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

RENAME TO new_name

Ändert den Namen des Notebooks in new_name. Der neue Bezeichner muss in dem Schema eindeutig sein.

Weitere Informationen zu Bezeichnern finden Sie unter Anforderungen an Bezeichner.

Sie können das Objekt in eine andere Datenbank und/oder in ein anderes Schema verschieben und dabei optional das Objekt umbenennen. Geben Sie dazu einen qualifizierten new_name-Wert an, der den neuen Datenbank- und/oder Schemanamen im Format db_name.schema_name.object_name bzw. schema_name.object_name enthält.

Bemerkung

Die Zieldatenbank und/oder das Zielschema müssen bereits vorhanden sein. Außerdem darf in der Zieldatenbank nicht bereits ein gleichnamiges Schema vorhanden sein, da die Anweisung sonst einen Fehler zurückgibt.
Das Verschieben eines Objekts in ein verwaltetes Zugriffsschema ist nicht zulässig, es sei denn, der Objekteigentümer (d. h. die Rolle mit der Berechtigung OWNERSHIP für das Objekt) ist auch Eigentümer des Zielschemas.

Wenn ein Objekt umbenannt wird, müssen andere Objekte, die darauf verweisen, mit dem neuen Namen aktualisiert werden.

SET ...

Legt eine oder mehrere spezifizierte Eigenschaften oder Parameter für das Notebook fest:

VERSION = 'version_alias_name'

Vom Benutzer angegebener Versionsalias. Ein Bezeichner, der den gleichen Namespace wie der automatisch generierte Bezeichner der Version hat. Er muss folgende Regeln einhalten:

Eindeutig für das Notebook, in dem die Version erstellt wird
Ist nicht auf FIRST, LAST, LIVE oder DEFAULT gesetzt. Dies sind reservierte Schlüsselwörter.
Beginnt nicht mit version$. Die automatisch generierten Versionsnamen beginnen mit version$.
Enthält keine Schrägstriche.

Im Folgenden finden Sie Beispiele für gültige Versionsaliasnamen.

1.0.0
prod-1.1.0

COMMENT = 'string_literal'

Legt einen Kommentar für das Notebook oder die Version des Notebook fest.

DEFAULT_VERSION = 'version_name'

Legt die Standardversion des Notebooks fest. Der Versionsname ist ein Bezeichner.

Standard: LAST

QUERY_WAREHOUSE = warehouse_name

Gibt das Warehouse an, in dem SQL-Abfragen aus dem Notebook ausgeführt werden. Dieser Parameter ist optional. Er ist jedoch erforderlich, um den Befehl EXECUTE NOTEBOOK auszuführen.

IDLE_AUTO_SHUTDOWN_TIME_SECONDS = number_of_seconds

Anzahl der Sekunden Leerlaufzeit, bevor das Notebook automatisch heruntergefahren wird. Dieser Parameter ist nur für Notebooks verfügbar, die auf Container Runtime ausgeführt werden. Der Wert muss eine Ganzzahl zwischen 60 und 259.200 (72 Stunden) sein.

Standard: 3.600 Sekunden.

SECRETS = '(secret_variable_name' = secret_name [ , ... ])

Legt Geheimnisvariablen für das Notebook fest.

secret_variable_name – Die Variable, die in der Notebookzelle beim Abrufen von Informationen aus dem Geheimnis verwendet wird.
secret_name – Der Name des Snowflake-Geheimnisses.

UNSET ...

Hebt eine oder mehrere angegebene Eigenschaften oder Parameter für das Notebook auf, wodurch die Eigenschaften auf die Standardwerte zurückgesetzt werden:

QUERY_WAREHOUSE
COMMENT

Um mehrere Eigenschaften oder Parameter mit einer einzigen ALTER-Anweisung zurückzusetzen, trennen Sie jede Eigenschaft oder jeden Parameter durch ein Komma.

Wenn Sie eine Eigenschaft oder einen Parameter zurücksetzen, geben Sie nur den Namen der Eigenschaft oder des Parameters an (es sei denn, die obige Syntax weist darauf hin, dass Sie den Wert angeben sollten). Die Angabe des Wertes gibt einen Fehler zurück.

ADD LIVE VERSION

Fügt dem Notebook eine LIVE-Version hinzu (Version, die für EXECUTE NOTEBOOK aufgerufen wird).

FROM LAST: Setzt die LIVE-Version auf die LAST-Version des Notebooks.
COMMENT = 'string_literal'': Legt einen Kommentar für das Notebook oder die Version des Notebook fest.

COMMIT

Wenn eine Git-Verbindung für das Notebook eingerichtet ist, wird die LIVE-Version des Notebooks in das Git-Repository übertragen.

Wenn für das Notebook kein Git-Repository eingerichtet ist, wird beim Ausführen dieses Befehls die LIVE-Version auf null gesetzt und der automatisch generierte Versionsalias inkrementiert.

Anforderungen an die Zugriffssteuerung¶

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

Berechtigung	Objekt	Anmerkungen
USAGE oder OWNERSHIP	Notebook	OWNERSHIP ist eine spezielle Berechtigung für ein Objekt, das automatisch der Rolle zugewiesen wird, die das Objekt erstellt hat.

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¶

Das folgende Beispiel benennt das Notebook mit dem Namen my_notebook in notebook_v2 um:

ALTER NOTEBOOK my_notebook RENAME notebook_v2;

Copy

Das folgende Beispiel hebt die Einstellung der Eigenschaft QUERY_WAREHOUSE auf:

ALTER NOTEBOOK my_notebook UNSET QUERY_WAREHOUSE;

Copy

Das folgende Beispiel setzt die aktuelle LAST-Version von my_notebook auf die LIVE-Version:

ALTER notebook my_notebook ADD LIVE VERSION FROM LAST;

Copy

Das folgende Beispiel committet die aktuelle LIVE-Version von my_notebook:

ALTER NOTEBOOK my_notebook COMMIT;

Copy