Delen via

Een geparameteriseerd notebook maken met behulp van de actie Uitvoeren met parameters

  • Artikel

Met parameters in Azure Data Studio wordt hetzelfde notebook uitgevoerd met een andere set parameters.

In dit artikel leest u hoe u een geparameteriseerd notebook maakt en uitvoert in Azure Data Studio met behulp van de Python-kernel.

Notitie

Op dit moment kunt u parameters gebruiken met Python-, PySpark-, PowerShell- en .NET Interactive-kernels.

Vereisten

Uitvoeren met de actie Parameters

Wanneer u de actie Uitvoeren met parametersnotitieblok gebruikt, kan de gebruiker nieuwe parameters invoeren in de gebruikersinterface om snel nieuwe parameters voor uw notebook in te stellen. De gebruiker kan vervolgens het notebook uitvoeren met de nieuwe parameters.

Notitie

Het is belangrijk om de parametercel op te maken met elke nieuwe parameter op een nieuwe regel.

Voorbeeld van parameterisering

U kunt een voorbeeld van een notebookbestand gebruiken om de stappen in dit artikel te doorlopen:

  1. Ga naar het notebookbestand in GitHub. Selecteer Onbewerkt.
  2. Selecteer Ctrl+S of klik met de rechtermuisknop en sla het bestand op met de extensie .ipynb.
  3. Open het bestand in Azure Data Studio.

Een notebook instellen voor parameterisatie

U kunt beginnen met het openen van het voorbeeldnotebook in Azure Data Studio of de volgende stappen uitvoeren om een notebook te maken. Probeer vervolgens verschillende parameters te gebruiken. Alle stappen worden uitgevoerd in een Azure Data Studio-notebook.

  1. Maak een nieuwe notebook. Kernel wijzigen in Python 3:

    Schermopname van de menuoptie Nieuw notitieblok en het instellen van de kernelwaarde op Python 3.

  2. Als u wordt gevraagd om uw Python-pakketten bij te werken wanneer uw pakketten moeten worden bijgewerkt, selecteert u Ja:

    Schermopname van de dialoogvensterprompt voor het bijwerken van Python-pakketten.

  3. Controleer of kernel is ingesteld op Python 3:

    Schermopname van de kernelwaarde voor Python 3.

  4. Maak een nieuwe codecel. Selecteer Parameters om de cel als parametercel te taggen.

    x = 2.0
y = 5.0

    Schermopname van het maken van een nieuwe parametercel met Parameters geselecteerd.

  5. Voeg andere cellen toe om verschillende parameters te testen:

    addition = x + y
multiply = x * y

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

    De uitvoer ziet er ongeveer als volgt uit:

    Schermopname van de uitvoer van cellen die zijn toegevoegd om nieuwe parameters te testen.

  6. Sla het notebook op als Input.ipynb:

    Schermopname van het opslaan van het notebookbestand.

Het notebook uitvoeren met parameters

  1. Selecteer op de werkbalk van het notitieblok het pictogram Uitvoeren met parameters :

    Schermopname van het pictogram Uitvoeren met parameters geselecteerd op de werkbalk.

  2. In een reeks nieuwe dialoogvensters wordt u gevraagd om nieuwe parameters voor x en y in te voeren:

    Schermopname van het invoeren van een nieuwe parameter voor x.

    Schermopname van het invoeren van een nieuwe parameter voor y.

  3. Nadat u de nieuwe parameters hebt ingevoerd, bekijkt u het nieuwe geparameteriseerde notebook. Selecteer Alles uitvoeren op de werkbalk om alle cellen uit te voeren en de nieuwe uitvoer te zien. Een nieuwe cel met # Injected-Parameters het label bevat de nieuwe parameterwaarden die zijn doorgegeven:

    Schermopname van de uitvoer voor nieuwe parameters.

Volgende stappen

Meer informatie over notebooks en parameterisatie: