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 that shows the New notebook menu option and setting the Kernel value to Python 3.

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

    Screenshot that shows the dialog prompt to update Python packages.

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

    Screenshot that shows the Kernel value to Python 3.

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

    x = 2.0
y = 5.0

    Screenshot that shows creating a new parameters cell with Parameters selected.

  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 that shows the output of cells added to test new parameters.

  6. Speichern Sie das Notebook als Input.ipynb:

    Screenshot that shows saving the notebook file.

Ausführen des Notebooks mit Parametern

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

    Screenshot that shows the Run with Parameters icon selected on the toolbar.

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

    Screenshot that shows entering a new parameter for x.

    Screenshot that shows entering a new parameter for 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 that shows the output for new parameters.

Nächste Schritte

Weitere Informationen zu Notebooks und zur Parametrisierung: