Condividi tramite


Creare un notebook parametrizzato usando l'azione Esegui con parametri

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 che mostra l'opzione di menu Nuovo notebook e l'impostazione del valore Kernel su Python 3.

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

    Screenshot che mostra la finestra di dialogo che richiede di aggiornare i pacchetti Python.

  3. Verificare che Kernel sia impostato su Python3:

    Screenshot che mostra il valore Kernel impostato su 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 che mostra la creazione di una nuova cella di parametri con l'opzione Parametri selezionata.

  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 che mostra l'output di celle aggiunte per testare nuovi parametri.

  6. Salvare il notebook come Input.ipynb:

    Screenshot che mostra il salvataggio del file del notebook.

Eseguire il notebook con parametri

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

    Screenshot che mostra l'icona Esegui con parametri selezionata sulla barra degli strumenti.

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

    Screenshot che mostra l'immissione di un nuovo parametro per x.

    Screenshot che mostra l'immissione di un nuovo parametro per 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 che mostra l'output per i nuovi parametri.

Passaggi successivi

Altre informazioni sui notebook e sulla parametrizzazione: