Share via

Creare un notebook parametrizzato usando l'azione Esegui con parametri

  • Articolo

La parametrizzazione in Azure Data Studio consiste nell'eseguire lo stesso notebook con un set diverso di parametri.

Questo articolo illustra come creare ed eseguire un notebook parametrizzato in Azure Data Studio mediante il kernel di Python.

Nota

È attualmente possibile usare la parametrizzazione con i kernel di Python, PySpark, PowerShell e .NET Interactive.

Prerequisiti

Azione Esegui con parametri

Quando si usa l'azione Esegui con parametri del notebook, l'utente può immettere nuovi parametri nell'interfaccia utente per impostare rapidamente nuovi parametri per il notebook. L'utente può quindi eseguire il notebook con i nuovi parametri.

Nota

È importante formattare la cella del parametro con ogni nuovo parametro in una nuova riga.

Esempio di parametrizzazione

È possibile usare un file di notebook di esempio per eseguire i passaggi descritti in questo articolo:

  1. Passare al file del notebook in GitHub. Selezionare Non elaborato.
  2. Selezionare CTRL+S o fare clic con il pulsante destro del mouse e quindi salvare il file con estensione ipynb.
  3. Aprire il file in Azure Data Studio.

Configurare un notebook per la parametrizzazione

È possibile iniziare con il notebook di esempio aperto in Azure Data Studio o completare la procedura seguente per creare un notebook. Provare quindi a usare parametri diversi. Tutti i passaggi vengono eseguiti all'interno di un notebook di Azure Data Studio.

  1. Creare un nuovo notebook. Impostare Kernel su Python 3:

    Screenshot that shows the New notebook menu option and setting the Kernel value to Python 3.

  2. Se viene richiesto di aggiornare i pacchetti Python quando i pacchetti richiedono l'aggiornamento, selezionare Sì:

    Screenshot that shows the dialog prompt to update Python packages.

  3. Verificare che Kernel sia impostato su Python3:

    Screenshot that shows the Kernel value to Python 3.

  4. Creare una nuova cella di codice. Selezionare Parametri per contrassegnare la cella come cella di parametri.

    x = 2.0
y = 5.0

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

  5. Aggiungere altre celle per testare parametri diversi:

    addition = x + y
multiply = x * y

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

    L'output sarà simile a questo esempio:

    Screenshot that shows the output of cells added to test new parameters.

  6. Salvare il notebook come Input.ipynb:

    Screenshot that shows saving the notebook file.

Eseguire il notebook con parametri

  1. Nella barra degli strumenti del notebook selezionare l'icona Esegui con parametri:

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

  2. Una serie di nuove finestre di dialogo richiede di immettere nuovi parametri per x e y:

    Screenshot that shows entering a new parameter for x.

    Screenshot that shows entering a new parameter for y.

  3. Dopo aver immesso i nuovi parametri, visualizzare il nuovo notebook parametrizzato. Sulla barra degli strumenti selezionare Esegui tutto per eseguire tutte le celle e visualizzare il nuovo output. Una nuova cella con etichetta # Injected-Parameters contiene i nuovi valori di parametro passati:

    Screenshot that shows the output for new parameters.

Passaggi successivi

Altre informazioni sui notebook e sulla parametrizzazione: