Configurare i parametri del processo

Questo articolo descrive la funzionalità dei parametri del processo e la configurazione dei parametri del processo con l'interfaccia utente dell'area di lavoro di Databricks. È anche possibile aggiungere parametri di processo alle definizioni JSON e YAML usate con l'API REST, l'interfaccia della riga di comando e i database. Vedere API processi, Che cos'è l'interfaccia della riga di comando di Databricks? e Che cosa sono i bundle di asset di Databricks?.

Che cosa sono i parametri di processo?

I parametri del processo sono coppie chiave-valore che consentono di parametrizzare i processi con valori statici o dinamici predefiniti. Facoltativamente, è possibile eseguire l'override dei parametri configurati in un processo quando si attiva una nuova esecuzione. Vedere Eseguire un processo con diversi parametri.

Le chiavi dei parametri del processo possono contenere solo caratteri _ - . o alfanumerici. I valori dei parametri vengono impostati come stringhe o riferimenti a valori dinamici. Vedere Che cos'è un valore dinamico di riferimento?.

Nota

È possibile usare qualsiasi JSON valido come valore di parametro. Ad esempio, il tipo di attività For each può analizzare elenchi come i seguenti:

[1, 2, 3]
['a', 'b', 'c']

Aggiungere o modificare i parametri del processo

Usare la finestra di dialogo Parametri processo per aggiungere nuovi parametri, modificare i valori e le chiavi dei parametri esistenti o eliminare i parametri.

Per modificare i parametri con l'interfaccia utente dell'area di lavoro, selezionare un processo esistente seguendo questa procedura:

1. Fare clic su Flussi di lavoro nella barra laterale.
2. Nella colonna Nome, cliccare il nome di un processo.
3. Nella barra laterale Dettagli processo fare clic su Modifica parametri. Viene visualizzata la finestra di dialogo dei parametri del processo.
4. Aggiungere o modificare parametri usando i campi Chiave e Valore.
5. Fare clic su per rimuovere un parametro.
6. Fare clic su Salva per applicare le modifiche.

Nota

Fare clic su { } per elencare i riferimenti a valori dinamici disponibili. Selezionare un'opzione dall'elenco per inserirla nel campo Valore.

Pushdown dei parametri del processo

I parametri del processo vengono automaticamente inseriti come parametri chiave-valore in tutte le attività che accettano parametri chiave-valore, che includono i tipi di attività seguenti:

• Notebook
• Python wheel (solo se configurato con argomenti di parole chiave)
• Query SQL, dashboard legacy o file
• Eseguire processo

I parametri del processo passati alle attività sono visibili nella configurazione dell'attività nell’interfaccia utente, insieme a tutti i parametri configurati nell'attività.

Importante

I parametri del processo hanno la precedenza sui parametri dell'attività. Se un parametro di processo e un parametro dell'attività hanno la stessa chiave, il parametro del processo prevale sul parametro dell'attività.

Riferimenti a valori dinamici ai parametri del processo

Tutte le attività che accettano riferimenti a valori dinamici possono accedere ai parametri del processo.

Usare il riferimento al valore dinamico {{job.parameters.<name>}}, sostituendo <name> con key che identifica il parametro.

Eseguire un processo con diversi parametri

È possibile eseguire l'override dei parametri del processo configurati o aggiungerne di nuovi quando si esegue un processo con parametri diversi. Vedere Eseguire un processo con diversi parametri.

È anche possibile eseguire l'override dei parametri del processo quando si ripristina un'esecuzione del processo. Vedere Rieseguire le attività non riuscite e ignorate.