Configurare il processo parameters

Questo articolo descrive la funzionalità dei parametri del processo e la configurazione del processo parameters con l'interfaccia utente dell'area di lavoro di Databricks. È anche possibile aggiungere il lavoro parameters alle definizioni JSON e YAML usate con l'API REST, CLI e DABs. 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 lavori parameters?

I processi parameters sono coppie chiave-valore che consentono di parametrizzare i processi con valuesstatici o dinamici predefiniti. Facoltativamente, è possibile eseguire l'override di parameters configurata in un processo quando si attiva una nuova esecuzione. Vedere Eseguire un processo con parametersdiverso.

Le chiavi dei parametri del processo possono contenere solo caratteri _ - . o alfanumerici. I parametri values sono set 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 il lavoro parameters

Usare la finestra di dialogo Processo parameters per aggiungere nuove parameters, modificare le chiavi dei parametri esistenti e values, o eliminare parameters.

Per modificare parameters con l'interfaccia utente dell'area di lavoro, select un processo esistente seguendo questa procedura:

1. Fare clic su Flussi di lavoro nella barra laterale.
2. Nella Nomecolumn, fare clic sul nome dell'attività.
3. Nella barra laterale dettagli lavoro, fare clic su Modifica parameters. Viene visualizzata la finestra di dialogo parameters.
4. Aggiungere o modificare usando chiave e campi Valore.
5. Fare clic sul per remove un parametro.
6. Fare clic su Salva per applicare le modifiche.

Nota

Fare clic su { } per list riferimenti a valori dinamici disponibili. Select un'opzione da list a insert nel campo Valore .

Pushdown dei parametri del processo

Job parameters vengono automaticamente inseriti come chiave-valore parameters verso tutte le attività che accettano la coppia chiave-valore parameters, che includono i seguenti tipi di attività:

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

Il job parameters passato ai task è visibile nella configurazione dei task nell'interfaccia utente accanto al task configurato parameters.

Importante

Lavoro parameters ha la precedenza sull'attività parameters. 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 al lavoro parameters

Tutte le attività che accettano riferimenti a valori dinamici possono accedere all'attività parameters.

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

Esegui un lavoro con diversi parameters

È possibile sostituire i processi configurati parameters o aggiungerne di nuovi quando si esegue un processo con parametri diversi parameters. Vedere Eseguire un processo con parametersdiverso.

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