CREATE NOTEBOOK

Erstellt ein neues Snowflake Notebook oder ersetzt ein vorhandenes Notebook.

Syntax

CREATE [ OR REPLACE ] NOTEBOOK [ IF NOT EXISTS ] <name>
  [ VERSION '<version_alias_name>' ]
  [ FROM '<source_location>' ]
  [ MAIN_FILE = '<main_file_name>' ]
  [ COMMENT = '<string_literal>' ]
  [ DEFAULT_VERSION = '<version_name>' ]
  [ QUERY_WAREHOUSE = <warehouse_to_run_nb_and_sql_queries_in> ]
  [ IDLE_AUTO_SHUTDOWN_TIME_SECONDS = <number_of_seconds> ]
Copy

Erforderliche Parameter

name

Zeichenfolge, die den Bezeichner (d. h. den Namen) für das Notebook angibt. Der Wert muss für das Schema, in dem das Notebook erstellt wird, eindeutig sein.

Darüber hinaus muss der Bezeichner mit einem Buchstaben beginnen und darf keine Leer- oder Sonderzeichen enthalten, es sei denn, die gesamte Bezeichnerzeichenfolge wird in doppelte Anführungszeichen gesetzt (z. B. "My object"). Bei Bezeichnern, die in doppelte Anführungszeichen eingeschlossen sind, ist auch die Groß-/Kleinschreibung zu beachten.

Weitere Informationen dazu finden Sie unter Anforderungen an Bezeichner.

Optionale Parameter

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 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

FROM 'source_location

Speicherort, von dem aus die Datei kopiert werden soll. Dies muss der Speicherort eines Snowflake-Stagingbereichs sein.

Falls angegeben, wird auf der Grundlage der kopierten Datei ein Notebook-Objekt erstellt. Wenn nicht angegeben, wird das Notebook-Objekt aus einer Notebook-Vorlage erstellt.

Falls angegeben, muss der Parameter MAIN_FILE auf den Namen der Datei gesetzt werden, die Sie kopieren möchten. Diese Datei muss eine ipynb-Datei sein.

MAIN_FILE = 'main_file_name'

Vom Benutzer festgelegter Bezeichner für den Notebook-Dateinamen. Dieser Name ist unabhängig vom Namen des Notebook-Objekts, der im Parameter name angegeben wird. Diese Datei muss eine ipynb-Datei sein.

COMMENT = 'string_literal'

Gibt einen Kommentar zum Notebook oder zur Notebook-Version an.

Standard: Kein Wert

DEFAULT_VERSION = 'version_name'

Legt die Standardversion des Notebooks fest (die Version, die für EXECUTE NOTEBOOK aufgerufen wird). 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.

Anforderungen an die Zugriffssteuerung

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

Berechtigung

Objekt

USAGE

Datenbank

USAGE oder OWNERSHIP

Schema

CREATE NOTEBOOK

Schema

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.

  • CREATE OR REPLACE <Objekt>-Anweisungen sind atomar. Das heißt, wenn ein Objekt ersetzt wird, erfolgt das Löschen des alten Objekts und das Erstellen des neuen Objekts in einer einzigen Transaktion.

Beispiele

Im Folgenden wird ein Notebook mit dem Namen mynotebook erstellt:

CREATE NOTEBOOK mynotebook;
Copy

Der Parameter QUERY_WAREHOUSE ist zwar optional, aber es wird empfohlen, ihn beim Erstellen eines neuen Notebooks anzugeben, damit EXECUTE NOTEBOOK auf dem Notebook ausgeführt werden kann.

CREATE NOTEBOOK mynotebook
 QUERY_WAREHOUSE = my_warehouse;
Copy

Das folgende Beispiel erstellt ein Notebook aus einer ipynb-Datei im Stagingbereich:

CREATE NOTEBOOK mynotebook
 FROM '@my_db.my_schema.my_stage'
 MAIN_FILE = 'my_notebook_file.ipynb'
 QUERY_WAREHOUSE = my_warehouse;
Copy
Sprache: Deutsch