CREATE NOTEBOOK PROJECT

Erstellt ein Notizbuch-Projektobjekt. Ein Notizbuch-Projektobjekt (NPO) verknüpft einen Snowsight-Arbeitsbereich mit einer Datenbank und einem Schema. Wenn das NPO erstellt wird, werden alle Dateien aus dem Arbeitsbereich in das Projekt in der angegebenen Datenbank und dem Schema kopiert. Das Notizbuch-Projekt kann dann mit EXECUTE NOTEBOOK PROJECT ausgeführt werden. Sie können ein Notizbuch-Projektobjekt in einem Stagingbereich oder in einem privaten Arbeitsbereich erstellen.

Bemerkung

Das Erstellen von Notizbuch-Projektobjekten aus freigegebenen Arbeitsbereichen wird derzeit nicht unterstützt.

Siehe auch:

EXECUTE NOTEBOOK PROJECT, SHOW NOTEBOOK PROJECTS, CREATE NOTEBOOK, EXECUTE NOTEBOOK

Syntax

Notizbuch-Projektobjekt aus einem privaten Arbeitsbereich erstellen:

CREATE NOTEBOOK PROJECT <database_name>.<schema_name>.<project_name>
  FROM 'snow://workspace/<workspace_path>'
  [ COMMENT = '<string_literal>' ];
Copy

Notizbuch-Projektobjekt aus einem Stagingbereich erstellen:

CREATE NOTEBOOK PROJECT [ IF NOT EXISTS ] <database_name>.<schema_name>.<project_name>
  FROM '@<database_name>.<schema_name>.<stage_name>'
  [ COMMENT = '<string_literal>' ];
Copy

Erforderliche Parameter

database_name.schema_name.project_name

Vollqualifizierter Bezeichner für das Notebook-Projekt.

Der Projektname muss innerhalb des Schemas eindeutig sein.

Bezeichner müssen mit einem Buchstaben beginnen und dürfen keine Leer- oder Sonderzeichen enthalten, es sei denn, der Bezeichner ist in doppelte Anführungszeichen eingeschlossen (z. B. "My Project").

Bei Bezeichnern, die in doppelte Anführungszeichen eingeschlossen sind, ist die Groß-/Kleinschreibung zu beachten.

FROM 'snow://workspace/{workspace_path' | '@database_name.schema_name.stage_name' }

Gibt die Quelle an, die dieses Notizbuch-Projekt unterstützt.

  • Verwenden Sie eine snow://workspace/... URL, um das Notizbuch-Projekt aus einer Version des Arbeitsbereichs in Snowsight zu erstellen.

  • Verwenden Sie eine Stagingbereichsreferenz (z. B. '@my_db.my_schema.my_stage'), um das Notizbuch-Projekt aus Notizbuch-Dateien zu erstellen, die Sie in einem internen oder temporären Stagingbereich bereitgestellt haben.

Beim Erstellen aus einem Arbeitsbereich muss der Wert eine snow://workspace/... URL sein, die auf eine Arbeitsbereichsversion verweist.

Der Pfad enthält normalerweise:

  • USER$ oder ein anderer Eigentümer.

  • Schema.

  • Name des Arbeitsbereichs.

  • Version (for example, versions/last).

Beispiel:

  • snow://workspace/USER$.MY_SCHEMA."my_notebook_workspace"/versions/last

Um den Pfad zum Arbeitsbereich zu finden, führen Sie den folgenden Befehl aus:

LIST 'snow://workspace/USER$.PUBLIC.DEFAULT$/versions/last/';
Copy

Optionale Parameter

COMMENT = 'string_literal'

Fügt dem Notebook-Projektobjekt einen Kommentar oder eine Beschreibung hinzu.

Verwenden Sie Kommentare, um den Zweck oder den Workflow zu beschreiben (z. B. COMMENT = 'Notebook project for this workflow').

Kommentare werden als Objektmetadaten gespeichert. Vermeiden Sie es, sensible Daten in Kommentare aufzunehmen.

Anforderungen an die Zugriffssteuerung

Zum Ausführen von :code:`CREATE NOTEBOOK PROJECT`muss eine Rolle über ausreichende Berechtigungen verfügen, um Objekte in der Zieldatenbank und im Schema zu erstellen. Erforderliche Berechtigungen sind:

  • USAGE oder OWNERSHIP für die Datenbank.

  • USAGE oder OWNERSHIP für das Schema.

  • CREATE NOTEBOOK PROJECT für das Schema, das das Erstellen von Objekten innerhalb dieses Schemas erlaubt.

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

  • Die Klauseln OR REPLACE und IF NOT EXISTS schließen sich gegenseitig aus. Sie können nicht beide in der gleichen 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.

  • A notebook project points to the specified workspace version indicated in the FROM clause. Using versions/last always references the latest workspace version; using a fixed path references a static version.

  • Wenn Sie das Notizbuch-Projekt aus einem Stagingbereich erstellen, können Sie es aktualisieren, indem Sie Versionen aus dem Stagingbereich hinzufügen. Weitere Details dazu finden Sie unter Ausführen und Planen von Notebooks in Workspaces.

  • Verwenden Sie beschreibende Projektnamen, um die Orchestrierung von Arbeitsabläufen zu vereinfachen.

  • Beim Ersetzen eines Projekts werden der gespeicherte Arbeitsbereichspfad und die Metadaten aktualisiert.

  • Um den Befehl CREATE NOTEBOOK PROJECT auszuführen, müssen Sie ihn aus einer SQL-Datei oder einem SQL-Arbeitsblatt in Arbeitsbereichen ausführen und nicht aus einer Notizbuch-Zelle heraus.

Beispiele

Erstellen eines Notebook-Projekts für einen Arbeitsbereich:

CREATE NOTEBOOK PROJECT analytics_db.workflow_schema.workflow_proj
  FROM 'snow://workspace/USER$.workflow_schema."etl_workflow"/versions/last'
  COMMENT = 'Notebook project for nightly ETL workflow';
Copy

Erstellen eines Notebook-Projekts aus einem Stagingbereich:

CREATE NOTEBOOK PROJECT analytics_db.workflow_schema.workflow_proj
  FROM '@NOTEBOOK_PROJECT_STAGE'
  COMMENT = 'Notebook project created from an internal or temporary stage';
Copy

Erstellen eines Notebook-Projekts aus einem Stagingbereich mit IF NOT EXISTS:

CREATE NOTEBOOK PROJECT IF NOT EXISTS ML_TRAIN_NOTEBOOK3
  FROM '@NOTEBOOK_PROJECT_STAGE1'
  COMMENT = 'Notebook project created from an internal or temporary stage';
Copy