ALTER NOTEBOOK

Ändert die Eigenschaften eines vorhandenen Notebooks.

Syntax

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

ALTER NOTEBOOK [ IF EXISTS ] <name> SET
  [ COMMENT = '<string_literal>' ]
  [ QUERY_WAREHOUSE = <warehouse_to_run_nb_and_sql_queries_in> ]
  [ IDLE_AUTO_SHUTDOWN_TIME_SECONDS = <number_of_seconds> ]
  [ SECRETS = ('<secret_variable_name>' = <secret_name>) [ , ... ] ]
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.

Sie können den Parameter RENAME TO nicht verwenden, um ein privates Notebook in eine andere Datenbank zu verschieben. Wenn Sie Ihr Notebook in eine andere Datenbank verschieben möchten, um es anderen zur Verfügung zu stellen (z. B. zur gemeinsamen Nutzung), erstellen Sie ein neues Notebook in einer anderen Datenbank und verwenden Sie dabei Ihr privates Notebook als Vorlage. Siehe Ein privates Notebook für den allgemeinen Gebrauch zur Verfügung stellen.

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:

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.

Anforderungen an die Zugriffssteuerung

Eine Rolle, die zur Ausführung dieser Operation 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.

USAGE-Berechtigung für die übergeordnete Datenbank und das Schema ist erforderlich, um Operationen an einem beliebigen Objekt in einem Schema durchzuführen.

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 TO notebook_v2;
Copy

Das folgende Beispiel hebt die Einstellung der Eigenschaft QUERY_WAREHOUSE auf:

ALTER NOTEBOOK my_notebook UNSET QUERY_WAREHOUSE;
Copy