Dela via

Skapa en parametriserad notebook-fil med hjälp av åtgärden Kör med parametrar

  • Artikel

Parameterisering i Azure Data Studio kör samma notebook-fil med en annan uppsättning parametrar.

Den här artikeln visar hur du skapar och kör en parametriserad notebook-fil i Azure Data Studio med hjälp av Python-kerneln.

Kommentar

För närvarande kan du använda parameterisering med Python, PySpark, PowerShell och .NET Interaktiva kernels.

Förutsättningar

Åtgärden Kör med parametrar

När du använder åtgärden Kör med parametrar kan användaren ange nya parametrar i användargränssnittet för att snabbt ange nya parametrar för notebook-filen. Användaren kan sedan köra notebook-filen med de nya parametrarna.

Kommentar

Det är viktigt att formatera parametercellen med varje ny parameter på en ny rad.

Exempel på parameterisering

Du kan använda en notebook-exempelfil för att gå igenom stegen i den här artikeln:

  1. Gå till notebook-filen i GitHub. Välj Rå.
  2. Välj Ctrl+S eller högerklicka och spara sedan filen med tillägget .ipynb.
  3. Öppna filen i Azure Data Studio.

Konfigurera en notebook-fil för parameterisering

Du kan börja med att öppna exempelanteckningsboken i Azure Data Studio eller utföra följande steg för att skapa en notebook-fil. Försök sedan använda olika parametrar. Alla steg körs i en Azure Data Studio-anteckningsbok.

  1. Skapa en ny anteckningsbok. Ändra Kernel till Python 3:

    Skärmbild som visar menyalternativet Ny anteckningsbok och anger kernelvärdet till Python 3.

  2. Om du uppmanas att uppgradera dina Python-paket när paketen behöver uppdateras väljer du Ja:

    Skärmbild som visar dialogrutan för att uppdatera Python-paket.

  3. Kontrollera att Kernel är inställt på Python 3:

    Skärmbild som visar kernelvärdet för Python 3.

  4. Skapa en ny kodcell. Välj Parametrar för att tagga cellen som en parametercell.

    x = 2.0
y = 5.0

    Skärmbild som visar hur du skapar en ny parametercell med Parametrar valda.

  5. Lägg till andra celler för att testa olika parametrar:

    addition = x + y
multiply = x * y

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

    Utdata ser ut ungefär som i det här exemplet:

    Skärmbild som visar utdata från celler som lagts till för att testa nya parametrar.

  6. Spara notebook-filen som Input.ipynb:

    Skärmbild som visar hur du sparar notebook-filen.

Kör notebook-filen med parametrar

  1. I notebook-verktygsfältet väljer du ikonen Kör med parametrar :

    Skärmbild som visar ikonen Kör med parametrar markerad i verktygsfältet.

  2. En serie nya dialogrutor uppmanar dig att ange nya parametrar för x och y:

    Skärmbild som visar hur du anger en ny parameter för x.

    Skärmbild som visar hur du anger en ny parameter för y.

  3. När du har angett de nya parametrarna visar du den nya parametriserade notebook-filen. I verktygsfältet väljer du Kör alla för att köra alla celler och se de nya utdata. En ny cell med etiketten # Injected-Parameters innehåller de nya parametervärdena som skickades in:

    Skärmbild som visar utdata för nya parametrar.

Nästa steg

Läs mer om notebook-filer och parameterisering: