Snowflake Python Demos API¶

Snowflake Demos-Bibliothek installieren¶

Sie können die Snowflake Demos-Bibliothek zur Verwendung mit conda oder einer virtuellen Umgebung installieren. Um die Bibliothek einzurichten, gehen Sie folgendermaßen vor:

1. Aktivieren Sie eine Python-Umgebung.

2. Um die Bibliothek zu installieren, führen Sie den folgenden pip install-Befehl aus:

   pip install snowflake.demos
   

   Copy

Standard-Snowflake-Verbindung einrichten¶

Die Snowflake Demos-API verwendet die Standardverbindung für den Snowflake Python Connector. Um diese Verbindung zu konfigurieren, folgen Sie den Anweisungen unter Einstellen einer Standardverbindung.

Um beispielsweise eine benannte Verbindung als Standardverbindung in Ihrer Snowflake config.toml-Datei festzulegen, fügen Sie den Namen Ihrer Standardverbindung wie folgt in die config.toml Datei ein:

default_connection_name = '<connection_name>'

Informationen zur Angabe von Verbindungsdefinitionen in einer TOML-Konfigurationsdatei finden Sie unter Verbinden mit der Datei connections.toml.

snowflake.demos importieren¶

Um die Bibliothek in Ihrem Terminal zu verwenden, können Sie eine interaktive Shell wie die Standard-Python-Shell REPL öffnen.

1. Führen Sie den folgenden Befehl aus (der je nach Ihrer Python-Umgebung variieren kann):

   python3
   

   Copy

2. Führen Sie in der REPL-Sitzung den folgenden Code aus, um die Bibliothek und die entsprechenden Funktionen zu importieren:

   from snowflake.demos import help, load_demo, teardown
   

   Copy

Aktuelle Liste der verfügbaren Demos¶

Die Snowflake Demos-API funktioniert derzeit mit der folgenden Liste von Demos:

Eine Demo laden und erkunden¶

• Um eine bestimmte Demo zu laden und die zugehörigen Ressourcen in Snowflake einzurichten, rufen Sie load_demo() mit einem Argument auf, das den demo_name einer verfügbaren Demo angibt, wie in der Ausgabe von help() zu finden.

  Beispiel:

  load_demo('get-started-snowflake-ml')
  

  Copy

Diese Funktion macht Folgendes:

• Stellt eine Verbindung zu Snowflake her, wenn Sie zum ersten Mal eine Demo laden.

• Erzeugt die erforderlichen Notebooks.

• Zeigt die Notebook-URL für den ersten Schritt der Demo (Schritt 1) an, wenn Sie load_demo() nicht einer Variablen zuweisen.

  • Wenn Sie load_demo() einer Variablen zuweisen, müssen Sie demo.show() aufrufen, um die erste Notebook-URL zu erhalten.

Die Ausgabe sollte ungefähr wir folgt aussehen:

Connecting to Snowflake...✅
Using ACCOUNTADMIN role...✅
Creating Database SNOWFLAKE_DEMO_DB...✅
Creating Schema SNOWFLAKE_DEMO_SCHEMA...✅
Creating Warehouse SNOWFLAKE_DEMO_WH...✅
Creating Stage SNOWFLAKE_DEMO_STAGE...✅
Uploading files to stage SNOWFLAKE_DEMO_STAGE/get-started-snowflake-ml and creating notebooks...
Creating notebook get_started_snowflake_ml_start_here...✅
Creating notebook get_started_snowflake_ml_sf_nb_snowflake_ml_feature_transformations...✅
Creating notebook get_started_snowflake_ml_sf_nb_snowflake_ml_model_training_inference...✅
Creating notebook get_started_snowflake_ml_sf_nb_snowpark_ml_adv_mlops...✅
Running setup for this demo...✅

Die Demo-URL anzeigen¶

Sie können die Funktion show() verwenden, um die URL zu einem bestimmten Schritt in der Demo anzuzeigen.

• Um die URL für den aktuellen Schritt anzuzeigen, weisen Sie zunächst das Ergebnis von load_demo() einer Variablen zu, z. B. demo, und rufen dann show() ohne Argumente auf:

  demo.show()
  

  Copy

  Die Ausgabe sollte in etwa so aussehen:

  Showing step 1.
  Please copy and paste this url in your web browser to open the notebook:
  https://app.snowflake.com/myorg/myaccount/#/notebooks/SNOWFLAKE_DEMO_DB.SNOWFLAKE_DEMO_SCHEMA.GET_STARTED_SNOWFLAKE_ML_START_HERE
  

• Um die Notebook-URL für einen bestimmten Schritt in der Demo zu erhalten, übergeben Sie das Argument step mit einer bestimmten Schrittnummer an show():

  demo.show(step=1)
  

  Copy

• Um die Notebook-URL für den nächsten Schritt in einer mehrstufigen Demo zu erhalten, verwenden Sie die Funktion show_next():

  demo.show_next()
  

  Copy

Eine Demo und ihre Ressourcen löschen¶

Wenn Sie mit der Erkundung der von Ihnen eingerichteten Demos fertig sind, möchten Sie vielleicht alle erstellten Ressourcen, Datensätze und Notebooks bereinigen.

• Um eine einzelne Demo und die damit verbundenen Ressourcen zu löschen, weisen Sie das Ergebnis von load_demo() zunächst einer Variablen wie demo zu und rufen dann teardown() darauf auf:

  demo.teardown()
  

  Copy

• Um alle Demos und alle damit verbundenen Ressourcen, die eingerichtet wurden, zu löschen, rufen Sie teardown() als Top-Level-Funktion auf.

  teardown()
  

  Copy