air Gruppo di comando

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.

Bandiere globali

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

Bandiere globali

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.

Bandiere globali

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.

Bandiere globali

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.

Bandiere globali

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.

Bandiere globali

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

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>

Risorse aggiuntive