Configurare i parametri del lavoro

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 bundle di asset di Databricks. Consultare API processi, Cos'è la CLI di Databricks?, e Cosa sono i Databricks Asset Bundles?.

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 riferimento di valore dinamico?.

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 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. Nella barra laterale dell'area di lavoro di Azure Databricks fare clic su Processi e pipeline.
2. Opzionalmente, selezionare i filtri Attività e Di mia proprietà.
3. Fare clic sul Nome del collegamento del proprio lavoro.
4. Nella barra laterale dettagli lavoro, selezionare Modifica parametri. Viene visualizzata la finestra di dialogo Parametri Processo.
5. Aggiungere o modificare i parametri usando i campi chiave e valore .
6. Fare clic sul per rimuovere un parametro.
7. 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 lavoro

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à:

• Taccuino
• Python wheel (solo se configurato con argomenti di parole chiave)
• Query SQL, cruscotto legacy o file
• Eseguire lavoro

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. Vedere Eseguire un processo con impostazioni diverse.

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