CREATE NOTEBOOK¶
Erstellt ein neues Snowflake Notebook oder ersetzt ein vorhandenes Notebook.
Syntax¶
CREATE [ OR REPLACE ] NOTEBOOK [ IF NOT EXISTS ] <name>
[ FROM '<source_location>' ]
[ MAIN_FILE = '<main_file_name>' ]
[ COMMENT = '<string_literal>' ]
[ QUERY_WAREHOUSE = <warehouse_to_run_nb_and_sql_queries_in> ]
[ IDLE_AUTO_SHUTDOWN_TIME_SECONDS = <number_of_seconds> ]
[ WAREHOUSE = <warehouse_to_run_notebook_python_runtime> ]
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¶
FROM 'source_location'
Gibt an, dass das Notebook aus einer
.ipynb
-Datei im angegebenen Stagingbereich erstellt werden soll. Um das Notebook aus einer Datei in einem Stagingbereich zu erstellen, legen Siesource_location
für den Stagingbereich-Speicherort der Datei und den Parameter MAIN_FILE für den Namen der Datei fest.Wenn dieser Parameter nicht angegeben wird, wird das Notebook-Objekt aus einer Notebook-Vorlage erstellt.
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 eineipynb
-Datei sein.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 der Container Runtime ausgeführt werden. Der Wert muss eine Ganzzahl zwischen 60 und 259.200 (72 Stunden) sein.
Standard: 3.600 Sekunden.
WAREHOUSE = warehouse_name
Warehouse, auf dem der Notebook-Kernel und der Python-Code laufen.
Wenn bei der Erstellung eines Notebook kein Warehouse angegeben wird, verwendet Snowflake das durch den schema-lineage-Parameter DEFAULT_STREAMLIT_NOTEBOOK_WAREHOUSE definierte Standard-Warehouse. Sie können diesen Parameter auf der Ebene des Schemas, der Datenbank oder der Kontenabfolge festlegen, um ein bevorzugtes Warehouse zu definieren.
Anforderungen an die Zugriffssteuerung¶
Eine Rolle, die zur Ausführung dieser Operation verwendet wird, muss mindestens die folgenden Berechtigungen haben:
Berechtigung |
Objekt |
---|---|
USAGE |
Datenbank |
USAGE oder OWNERSHIP |
Schema |
CREATE NOTEBOOK |
Schema |
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 „User“), sensible Daten, exportkontrollierte Daten oder andere regulierte Daten als Metadaten eingegeben werden. Weitere Informationen dazu finden Sie unter Metadatenfelder in Snowflake.
Die
OR REPLACE
- undIF NOT EXISTS
-Klauseln schließen sich gegenseitig aus. Sie können nicht beide in derselben Anweisung verwendet werden.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;
Der Parameter QUERY_WAREHOUSE ist zwar optional, aber es wird empfohlen, ihn beim Erstellen eines neuen Notebooks anzugeben, damit EXECUTE NOTEBOOK auf dem Warehouse ausgeführt werden kann.
CREATE NOTEBOOK mynotebook
QUERY_WAREHOUSE = my_warehouse;
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;