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 del lavoro?
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 parametri diversi.
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 lavoro
Usare la finestra di dialogo parametri di lavoro per aggiungere nuovi parametri, modificare chiavi e valori 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:
- Fare clic su
Flussi di lavoro nella barra laterale. - Nella colonna Nome, fare clic sul nome del lavoro.
- Nella barra laterale dettagli lavoro, selezionare Modifica parametri. Viene visualizzata la finestra di dialogo Parametri Processo.
- Aggiungere o modificare i parametri usando i campi chiave e valore .
- Fare clic sul
per rimuovere un parametro. - 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 di lavoro vengono automaticamente trasmessi come chiave-valore a tutte le attività che accettano questo tipo di parametri, comprendendo i seguenti tipi di attività:
- Notebook
- Python wheel (solo se configurato con argomenti di parole chiave)
- Query SQL, dashboard legacy o file
- Eseguire processo
I parametri di lavoro passati alle attività sono visibili nella configurazione delle attività nell'interfaccia utente insieme ai parametri delle attività configurati.
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 dei parametri del lavoro
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 parametri diversi
È possibile eseguire l'override dei parametri di processo configurati o aggiungerne di nuovi quando si esegue un processo con parametri diversi. Consulta Esegui un'attività con parametri diversi.
È anche possibile eseguire l'override dei parametri del processo quando si ripristina un'esecuzione del processo. Vedere Rieseguire le attività non riuscite e ignorate.