CREATE NOTEBOOK PROJECT

Erstellt ein neues Notebook-Projekt oder ersetzt ein bestehendes. Ein Notebook-Projektobjekt bindet einen Snowsight-Arbeitsbereich (gekennzeichnet durch eine snow://workspace/... URL) an eine Datenbank und ein Schema, sodass es mit EXECUTE NOTEBOOK PROJECT ausgeführt werden kann.

Siehe auch:

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

Syntax

CREATE [ OR REPLACE ] NOTEBOOK PROJECT <database_name>.<schema_name>.<project_name>
  FROM 'snow://workspace/<workspace_path>'
  [ 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'

Gibt den Snowsight-Arbeitsbereich an, der dieses Notebook-Projekt unterstützt.

Der Wert muss 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 (z. B. versions/head).

Beispiel:

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

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

LIST 'snow://workspace/USER$.PUBLIC.DEFAULT$/versions/live/';
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.

  • Ein Notebook-Projekt verweist auf die angegebene Arbeitsbereichsversion, die in der FROM-Klausel angegeben ist. Die Verwendung von versions/head verweist immer auf die neueste Version des Arbeitsbereichs; es wird eine feste Pfadreferenz als statische Version verwendet.

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

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

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/head'
  COMMENT = 'Notebook project for nightly ETL workflow';
Copy
Sprache: Deutsch