Snowflake Python Demos API¶
Die Snowflake Python Demos-Bibliothek (snowflake.demos) hilft Ihnen dabei, schnell Demos für Snowflake Notebooks zu erstellen, indem sie Aufgaben zur Einrichtung der Umgebung automatisiert, wie z. B. die Konfiguration der Datenbank, des Schemas, der Rolle, der Berechtigungen und des Zugriffs auf Datensets, um den Einstieg in die Arbeit mit Snowflake Notebooks zu erleichtern.
Mit dieser Bibliothek können Sie Folgendes tun:
Snowflake Notebooks-Demos in Ihre Snowflake-Umgebung laden und einrichten
Interaktive Notebooks Schritt für Schritt erkunden, um praktische Erfahrungen zu sammeln
Ressourcen einfach löschen, wenn Sie fertig sind.
Voraussetzungen¶
Bevor Sie mit der Snowflake Demos-API beginnen, führen Sie die folgenden Schritte aus:
Vergewissern Sie sich, dass Sie eine der unterstützten Python-Versionen installiert haben.
Unterstützte Python-Versionen¶
Folgende Versionen von Python werden unterstützt:
3.9
3.10
3.11
3,12
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 wie folgt vor:
Installieren Sie die Bibliothek, indem Sie den folgenden
pip install-Befehl ausführen:pip install snowflake.demos
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, indem Sie den folgenden Befehl ausführen (der je nach Ihrer Python-Umgebung variieren kann):
python3
In der REPL-Sitzung importieren Sie die Bibliothek und die entsprechenden Funktionen, indem Sie den folgenden Code ausführen:
from snowflake.demos import help, load_demo, teardown
Auflistung verfügbarer Demos¶
Nachdem Sie die Bibliothek importiert haben, können Sie die Funktion help() verwenden, um die Liste der verfügbaren Demos zu sehen, die Sie laden und erkunden können. Diese Funktion gibt eine Tabelle mit den folgenden Spalten zurück:
demo_name– Eine durch Bindestriche getrennte Zeichenfolge, die den Namen der Demo darstellt.title– Der von Menschen lesbare Titel der Demo.num_steps– Die Anzahl der Schritte in der Demo.
Aktuelle Liste der verfügbaren Demos¶
Die Snowflake-Demos API unterstützen derzeit die folgende Liste von Demos:
demo_name |
titel |
num_steps |
|---|---|---|
|
Erste Schritte mit Snowpark in Snowflake Notebooks und Python-Arbeitsblättern |
1 |
|
Erste Schritte mit Snowflake ML |
4 |
|
Datenanalyse und Vorhersage der Kundenabwanderung mit Snowflake Notebooks |
2 |
|
Erste Schritte mit Snowflake Container Runtime |
1 |
|
Einführung in den Feature Store mit Snowflake Notebooks |
1 |
|
Erste Schritte mit partitionierten Modellen und Snowflake Model Registry |
1 |
Arbeiten mit Demos¶
Nachdem Sie die Voraussetzungen erfüllt haben, können Sie die Snowflake Demos-API verwenden, um wie folgt mit den Demos zu arbeiten.
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 die demo_name einer beliebigen unterstützten Demo angibt, wie in der Ausgabe von help() zu finden. Beispiel:
load_demo('get-started-snowflake-ml')
Tipp
Um einen Verweis auf die Demo als Objekt zu speichern, können Sie das Ergebnis von load_demo() einer Variablen zuweisen:
demo = load_demo('get-started-snowflake-ml')
Die Zuweisung des Ergebnisses an eine Variable ist erforderlich, wenn Sie mit einer mehrstufigen Demo arbeiten (num_steps > 1). Sie benötigen diese Referenz, um die Nummer show_next() oder show(step=<>) aufzurufen, um zum nächsten Notebook in der Demo zu gelangen.
Sie können diese Referenz auch verwenden, um die Demo später schnell zu löschen.
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 Siedemo.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...✅
Bemerkung
Es gibt ein bekanntes Problem mit den gedruckten Notizbuch-URLs. Wenn sich die URL nicht direkt öffnet, können Sie sie kopieren und in eine neue Browser-Registerkarte einfügen oder das Notebook manuell in der Snowsight unter der Registerkarte Notebooks aufrufen.
Die Demo-URL anzeigen¶
Sie können die Funktion show() verwenden, um die URL zum aktuellen oder einem bestimmten Schritt in der Demo zu erhalten.
Um die URL für das Notebook für den aktuellen Schritt in der Demo zu erhalten, weisen Sie zunächst das Ergebnis von load_demo() einer Variablen wie demo zu und rufen dann show() ohne Argumente auf:
demo.show()
Die Ausgabe sollte ungefähr wir folgt 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)
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()
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() auf.
demo.teardown()
Um alle Demos und alle damit verbundenen Ressourcen, die eingerichtet wurden, zu löschen, rufen Sie teardown() als Top-Level-Funktion auf.
teardown()