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> ]
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-Speicherort oder aus einem privaten Notebook erstellt werden soll:Um das Notebook aus einer Datei in einem Stagingbereich zu erstellen, legen Sie
source_location
für den Stagingbereich-Speicherort der Datei und den Parameter MAIN_FILE für den Namen der Datei fest.Um das Notebook aus einem privaten Notebook zu erstellen (z. B. um ein privates Notebook für die gemeinsame Nutzung verfügbar zu machen), setzen Sie diesen Parameter auf:
'snow://notebook/USER$username.schema.notebook/versions/version$1/'
Wobei:
username
ist Ihr Benutzername.schema
ist der Name des Schemas, das das private Notebook enthält.notebook
ist der Name des privaten Notebooks.
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 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 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 „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;
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;
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;