Ausführen von Notebooks in Workspaces mit SQL

Snowsight unterstützt die nicht interaktive (headless) Ausführung von Notebooks. Damit können Sie eine programmgesteuerte Ausführung eines Notebooks auslösen, ohne die |sf-web-interface|öffnen zu müssen und ohne dass ein wiederkehrender Zeitplan erforderlich ist.

Die Headless-Ausführung ist für Aufgaben, geplante Aufgaben oder Workflows gedacht, die von Tools wie Airflow, Prefect, Dagster, CI/CD-Pipelines oder externen Systemen orchestriert werden, die ein Notebook programmgesteuert ausführen müssen.

Notebook-Projekt erstellen

Wenn noch kein Notebook-Projekt existiert, erstellen Sie eines mit dem Befehl CREATE NOTEBOOK PROJECT:

CREATE NOTEBOOK PROJECT <database_name>.<schema_name>.<project_name>
  FROM 'snow://workspace/<workspace_path>'
  COMMENT = 'Notebook project for this workflow';
Copy

So finden Sie den Pfad zum Arbeitsbereich:

  1. Melden Sie sich bei Snowsight an.

  2. Wählen Sie im Navigationsmenü die Option Projects » Workspaces aus.

  3. Wählen Sie den Arbeitsbereich aus.

  4. Wählen Sie das Pin-Symbol aus.

  5. Kopieren Sie den Speicherort (z. B. snow://workspace/USER$.schema."workspacename"/versions/head).

Ausführen eines Notebooks mit SQL

Sie können ein Notebook über ein Arbeitsblatt, eine SQL-Datei oder einen beliebigen SQL-Client ausführen, indem Sie den Befehl EXECUTE NOTEBOOK PROJECT verwenden:

EXECUTE NOTEBOOK PROJECT <database_name>.<schema_name>.<project_name>
  MAIN_FILE = '<notebook_file_name>.ipynb'
  COMPUTE_POOL = '<compute_pool_name>'
  RUNTIME = '<runtime_version>'      -- e.g., 'V2.2-CPU-PY3.12'
  QUERY_WAREHOUSE = '<warehouse_name>'
  EXTERNAL_ACCESS_INTEGRATIONS = ('<integration_name>');
Copy

Beispiel

EXECUTE NOTEBOOK PROJECT "sales_detection_db"."schema"."DEFAULT_PROJ_B32BCFD4"
  COMPUTE_POOL = "test_X_CPU"
  MAIN_FILE = 'notebook_file.ipynb'
  RUNTIME = 'V2.2-CPU-PY3.10'
  QUERY_WAREHOUSE = "ENG_INFRA_WH"
  EXTERNAL_ACCESS_INTEGRATIONS = ('test_EAI');
Copy

Anzeigen von Ausführungen

Dieser Befehl führt das Notebook und seine Abhängigkeiten unter Verwendung der Version aus, die im zugehörigen Notebook-Projekt gespeichert ist. Um die Ergebnisse der Ausführung anzuzeigen, navigieren Sie in der entsprechenden Datenbank und dem entsprechenden Schema in Snowsight zum Notebook-Projekt.

Sprache: Deutsch