Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Il air gruppo di comandi all'interno della CLI Databricks invia e gestisce i carichi di lavoro GPU, come l'addestramento e l'inferenza, con AI Runtime.
Per i campi di configurazione del carico di lavoro, vedi riferimento Workload YAML. Per inviare il tuo primo carico di lavoro, consulta AI Runtime quickstart.
Databricks Air Run
Invia un carico di lavoro da una configurazione YAML. L'output include l'ID di esecuzione del lavoro e l'URL di esecuzione del lavoro.
databricks air run --file YAML_PATH [flags]
Arguments
None
Options
-f, --file string
Percorso verso la configurazione YAML del carico di lavoro. Questa opzione è obbligatoria.
--watch
Trasmetti i log dal primo nodo (nodo 0) fino a quando la corsa raggiunge uno stato terminale. Impostazione predefinita: false.
--override stringArray
Sovrascrivi un campo YAML usando FIELD_PATH=VALUE. Ripeti questa opzione per sovrascrivere più campi.
--dry-run
Valida la configurazione senza inviare un carico di lavoro. Impostazione predefinita: false.
--idempotency-key string
Restituire una run esistente quando la chiave è stata precedentemente utilizzata. Sovrascrizioni idempotency_token nello YAML. Massimo: 64 caratteri.
Examples
Il seguente esempio invia un carico di lavoro da train.yaml e trasmette i log dal primo nodo (nodo 0) fino alla fine dell'esecuzione:
databricks air run --file train.yaml --watch
Per inviare in background, ometti --watch. Il comando ritorna dopo la sottomissione. Usa l'ID di esecuzione del lavoro restituito per controllare lo stato e i log dello streaming:
databricks air get <job-run-id>
databricks air logs <job-run-id>
Usa lo stesso profilo workspace per invio, stato e log. Vedi Profili di configurazione per la CLI Databricks.
Passa un percorso di configurazione come argomento separato per -h mostrare l'aiuto nella configurazione del carico di lavoro:
databricks air run -h config
databricks air run -h config.compute
databricks air run -h config.compute.accelerator_type
Databricks Air Get
Ottieni i dettagli per una corsa.
databricks air get JOB_RUN_ID [flags]
Arguments
JOB_RUN_ID
Un ID eseguito del lavoro restituito da databricks air run.
Options
Lista di Trasmissione Databricks
Elencare le esecuzioni. Di default, il comando elenca le esecuzioni attive inviate dall'utente corrente.
databricks air list [flags]
Arguments
None
Options
--limit int
Numero massimo di corse da mostrare. Impostazione predefinita: 20.
--all-status
Includere le corse negli stati terminali. Impostazione predefinita: false.
--all-users
Includere le run inviate da altri utenti. Impostazione predefinita: false.
--filter stringArray
Il filtro viene eseguito usando KEY=VALUE. Ripeti questa opzione per aggiungere condizioni. Una run deve soddisfare ogni condizione.
Vedi tasti filtro.
Chiavi filtro
Ogni --filter opzione prevede una KEY=VALUE condizione.
= è l'unico operatore. Non puoi annullare una condizione, confrontare le distanze o combinare condizioni con la OR.
| Key | Corrispondenze | Example |
|---|---|---|
accelerator_type |
La famiglia degli acceleratori, come A10 o H100, o il valore pieno accelerator_type del carico di lavoro YAML, come GPU_8xH100. I cognomi non sono sensibili alla maiuscula. |
accelerator_type=H100 |
experiment |
Un motivo a massa rispetto all'intero nome dell'esperimento. La corrispondenza non è distinta dalla maiuscolo e l'altro.
* corrisponde a qualsiasi sequenza di caratteri, ? a un personaggio e [abc] a un personaggio del set. Le espressioni regolari non sono supportate. Un valore senza wildcard corrisponde solo a un esperimento con esattamente quel nome. |
'experiment=qwen*' |
num_accelerators |
Il numero totale di GPU per la run. Il valore deve essere un intero positivo e deve corrispondere esattamente. | num_accelerators=8 |
user |
Il nome utente dell'utente che ha inviato la run. Il valore deve corrispondere esattamente. Questa chiave sostituisce la restrizione predefinita alle tue partite, quindi non hai bisogno --all-usersdi . |
user=person@example.com |
Per i valori supportati accelerator_type , vedi Tipi di acceleratore.
I filtri restringono le esecuzioni che il comando già elenca. Senza --all-status, solo le corse attive possono essere abbinate.
Metti virgolette singole attorno a una condizione che contiene *, ?, o [ in modo che il tuo shell passi il pattern alla CLI invariato.
Il comando restituisce un errore se una condizione non è nel KEY=VALUE modulo, usa una chiave che non è nella tabella o ha un valore vuoto o invalido.
Examples
Il seguente esempio elenca le tue corse attive che utilizzano acceleratori H100:
databricks air list --filter accelerator_type=H100
Il seguente esempio elenca le esecuzioni in qualsiasi stato inviato person@example.com , dove il nome dell'esperimento inizia con qwen e l'esecuzione utilizza otto GPU in totale:
databricks air list --all-status \
--filter 'experiment=qwen*' \
--filter num_accelerators=8 \
--filter user=person@example.com
Data bricks Air Log
Trasmetti o recupera log per una partita.
databricks air logs JOB_RUN_ID [flags]
Arguments
JOB_RUN_ID
Un ID eseguito del lavoro restituito da databricks air run.
Options
--node int
Seleziona un nodo indice basato su zero. Impostazione predefinita: 0.
--tail int
Numero di logline esistenti da stampare. Impostazione predefinita: 10000.
--minutes int
Prendi i tronchi degli ultimi minuti. Non è possibile combinare con --tail. Impostazione predefinita: 0.
--retry int
Seleziona un tentativo di ritento.
0 è il tentativo iniziale ed -1 è l'ultimo. Impostazione predefinita: -1.
--download-to string
Scarica i log completi in una directory. Scarica tutti i nodi a meno che --node non sia impostato. Non può essere combinato con --tail o --minutes.
Databricks Air Cancel
Annulla una o più run tramite l'ID del job, oppure annulla tutte le run attive inviate dall'utente corrente.
databricks air cancel [JOB_RUN_ID...] [flags]
Arguments
JOB_RUN_ID
Uno o più ID eseguiti da lavoro. Non è possibile combinare con --all.
Options
--all
Annulla tutte le run attive inviate dall'utente corrente. Impostazione predefinita: false.
-y, --yes
Salta il prompt di conferma usato da --all. Impostazione predefinita: false.
Databricks Air Images push
Invia un'immagine contenitore al Registro degli Artefatti.
Per i prerequisiti e le istruzioni per il push di un'immagine, vedi Push immagini con la Cli di Databricks.
databricks air images push [flags]
Arguments
None
Options
-s, --source string
L'immagine del contenitore sorgente come nome con un tag opzionale (NAME[:TAG]) o un digest (NAME@DIGEST). Se omesso in un terminale interattivo, il prompt dei comandi mostra il valore.
--catalog string
Il catalogo di destinazione Unity Catalog. Se omesso in un terminale interattivo, il prompt dei comandi mostra il valore.
--schema string
Lo schema di destinazione del Catalogo Unity. Se omesso in un terminale interattivo, il prompt dei comandi mostra il valore.
--artifact string
L'artefatto di destinazione come ARTIFACT[:TAG]. Predefinito si usa il nome e il tag dell'immagine sorgente, oppure il latest tag quando la sorgente non ha un tag.
--pull
Estrai l'immagine sorgente dal suo registro prima di inviare invece di riutilizzare un'immagine locale disponibile. Impostazione predefinita: false.
Databricks Air Convert-to-DABs
Converti una configurazione YAML del carico di lavoro in un Databricks Asset Bundle. Questo comando locale scrive e avvia databricks.yml file sotto generated_artifacts/.
Questo comando è un ponte opzionale verso un flusso di lavoro di produzione avanzato. Puoi continuare a usarla databricks air run senza convertire la configurazione.
Per il flusso di lavoro bundle, vedi Schedule GPU Workloads e compose tasks.
databricks air convert-to-dabs YAML_PATH [flags]
Arguments
YAML_PATH
Il percorso verso la configurazione YAML del carico di lavoro.
Options
--output-dir string
Directory dove il comando scrive il bundle. La sorgente del codice deve trovarsi all'interno di questa directory. Predefinito: la directory che contiene il file YAML di input.
--force
Sovrascrivi i file bundle generati che già esistono. Impostazione predefinita: false.
Bandiere globali
--debug
Indica se abilitare la registrazione di debug.
-h oppure --help
Mostra la guida per il Databricks CLI, il gruppo di comandi correlato o il comando correlato.
--log-file Stringa
Stringa che rappresenta il file in cui scrivere i log di output. Se questo flag non viene specificato, l'impostazione predefinita prevede la scrittura dei log di output su stderr.
--log-format Formato
Tipo di formato del log, text o json. Il valore predefinito è text.
--log-level Stringa
Stringa che rappresenta il livello di formato del log. Se non specificato, il livello di formato del log è disabilitato.
-o, --output Tipo
Tipo di output del comando, text o json. Il valore predefinito è text.
-p, --profile Stringa
Nome del profilo nel ~/.databrickscfg file da usare per eseguire il comando . Se questo flag non viene specificato, se esiste, viene usato il profilo denominato DEFAULT .
--progress-format Formato
Formato per visualizzare i log di stato: default, append, inplaceo json
-t, --target Stringa
Se applicabile, la destinazione del bundle da utilizzare
Migrazione dalla CLI legacy di Python
La CLI Databricks e la CLI obsoleta basata air su Python usano nomi e flag di comando diversi. Aggiorna gli script utilizzando le seguenti mappature:
| CLI Python | Interfaccia a riga di comando di Databricks |
|---|---|
air run -f train.yaml |
databricks air run -f train.yaml |
air run -f train.yaml --override A=X B=Y |
databricks air run -f train.yaml --override A=X --override B=Y |
air get run <run-id> |
databricks air get <run-id> |
air list runs |
databricks air list --all-status |
air list runs --active |
databricks air list |
air -h config |
databricks air run -h config |
air logs <run-id> |
databricks air logs <run-id> |
air cancel <run-id> |
databricks air cancel <run-id> |