Teilen über

Erstellen eines parametrisierten Notebooks mithilfe der Aktion „Mit Parametern ausführen“

  • Artikel

Bei der Parametrisierung in Azure Data Studio wird das gleiche Notebook mit unterschiedlichen Parametern ausgeführt.

In diesem Artikel wird beschrieben, wie Sie in Azure Data Studio mithilfe des Python-Kernels ein parametrisiertes Notebook erstellen und ausführen können.

Hinweis

Derzeit können Sie die Parametrisierung mit Python-, PySpark-, PowerShell- und .NET Interactive-Kernels verwenden.

Voraussetzungen

Aktion „Mit Parametern ausführen“

Wenn Sie die Notebookaktion „Mit Parametern ausführen“ verwenden, kann der Benutzer auf der Benutzeroberfläche neue Parameter eingeben, um schnell neue Parameter für Ihr Notebook festzulegen. Der Benutzer kann das Notebook dann mit den neuen Parametern ausführen.

Hinweis

Es ist wichtig, die Parameterzelle mit jedem neuen Parameter in einer neuen Zeile zu formatieren.

Parametrisierungsbeispiel

Sie können eine Beispielnotebookdatei verwenden, um die Schritte in diesem Artikel auszuführen:

  1. Navigieren Sie zur Notebookdatei auf GitHub. Klicken Sie auf Raw (Roh).
  2. Drücken Sie STRG+S, oder klicken Sie mit der rechten Maustaste, und speichern Sie dann die Datei mit der .ipynb-Erweiterung.
  3. Öffnen Sie die Datei in Azure Data Studio.

Einrichten eines Notebooks für die Parametrisierung

Sie können mit dem in Azure Data Studio geöffneten Beispielnotebook beginnen oder die folgenden Schritte ausführen, um ein Notebook zu erstellen. Versuchen Sie dann, verschiedene Parameter zu verwenden. Alle Schritte werden in einem Azure Data Studio-Notebook ausgeführt.

  1. Erstellen Sie ein neues Notebook. Ändern Sie die Einstellung für Kernel in Python 3:

    Screenshot: Menüoption „Neues Notebook“ und Festlegen des Kernelwerts auf Python 3

  2. Wenn Ihre Python-Pakete ein Upgrade erfordern und Sie dazu aufgefordert werden, klicken Sie auf Ja:

    Screenshot: Dialogfeld mit Aufforderung zum Aktualisieren der Python-Pakete

  3. Stellen Sie sicher, dass der Kernel auf Python 3 festgelegt ist:

    Screenshot: „Python 3“ als Wert für den Kernel

  4. Erstellen Sie eine neue Codezelle. Klicken Sie auf Parameter, um die Zelle als Parameterzelle zu markieren.

    x = 2.0
y = 5.0

    Screenshot: Erstellen einer neuen Parameterzelle mit ausgewählter Option „Parameter“

  5. Fügen Sie weitere Zellen hinzu, um andere Parameter zu testen:

    addition = x + y
multiply = x * y

    print("Addition: " + str(addition))
print("Multiplication: " + str(multiply))

    Die Ausgabe sieht etwa wie in diesem Beispiel aus:

    Screenshot: Ausgabe der Zellen, die zum Testen neuer Parameter hinzugefügt wurden

  6. Speichern Sie das Notebook als Input.ipynb:

    Screenshot: Speichern der Notebookdatei

Ausführen des Notebooks mit Parametern

  1. Klicken Sie auf der Notebooksymbolleiste auf das Symbol Mit Parametern ausführen:

    Screenshot: Ausgewähltes Symbol „Mit Parametern ausführen“ auf der Symbolleiste

  2. Sie werden in mehreren neuen Dialogfeldern aufgefordert, neue Parameter für x und y einzugeben:

    Screenshot: Eingabe eines neuen Parameters für x

    Screenshot: Eingabe eines neuen Parameters für y

  3. Nachdem Sie die neuen Parameter eingegeben haben, zeigen Sie das neue parametrisierte Notebook an. Klicken Sie auf der Symbolleiste auf Alle ausführen, um alle Zellen auszuführen und die neue Ausgabe anzuzeigen. Eine neue Zelle mit der Bezeichnung # Injected-Parameters enthält die neuen Parameterwerte, die übergeben wurden:

    Screenshot: Ausgabe für neue Parameter

Nächste Schritte

Weitere Informationen zu Notebooks und zur Parametrisierung: