air kommandogrupp

Important

Den här funktionen finns som allmänt tillgänglig förhandsversion.

Kommandogruppen air inom Databricks CLI skickar in och hanterar GPU-arbetsbelastningar, såsom träning och inferens, med AI Runtime.

För arbetsbelastningskonfigurationsfält, se Workload YAML-referens. För att skicka in din första arbetsbelastning, se Databricks CLI quickstart för AI Runtime.

Databricks Air Run

Skicka in en arbetsbelastning från en YAML-konfiguration. Utdata inkluderar jobbkörnings-ID och jobbkörd URL.

databricks air run --file YAML_PATH [flags]

Arguments

None

Options

-f, --file string

    Väg till arbetsbelastningens YAML-konfiguration. Det här alternativet krävs.

--watch

    Strömnod 0 loggar tills körningen når ett terminalt tillstånd. Standardvärde: false.

--override stringArray

    Överstyr ett YAML-fält med hjälp av FIELD_PATH=VALUE. Upprepa detta alternativ för att åsidosätta flera fält.

--dry-run

    Validera konfigurationen utan att skicka in en arbetsbelastning. Standardvärde: false.

--idempotency-key string

    Returnera en befintlig körning när nyckeln tidigare användes. Överskrivningar idempotency_token i YAML. Max: 64 tecken.

Globala flaggor

Examples

Följande exempel skickar in en arbetsbelastning från train.yaml:

databricks air run --file train.yaml

Skicka en konfigurationssökväg som ett separat argument för -h att visa hjälp med arbetsbelastningskonfiguration:

databricks air run -h config
databricks air run -h config.compute
databricks air run -h config.compute.accelerator_type

Databricks Air Get

Få detaljer för en runda.

databricks air get JOB_RUN_ID [flags]

Arguments

JOB_RUN_ID

    Ett jobb-ID returnerades av databricks air run.

Options

Globala flaggor

Databricks Air List

Listan körs. Som standard listar kommandot aktiva körningar som skickats in av den aktuella användaren.

databricks air list [flags]

Arguments

None

Options

--limit int

    Maximalt antal runs att visa. Standardvärde: 20.

--all-status

    Inkludera körningar i terminalstater. Standardvärde: false.

--all-users

    Inkludera körningar inskickade av andra användare. Standardvärde: false.

--filter stringArray

    Filtret körs med .KEY=VALUE Upprepa detta alternativ för att kräva flera villkor. Stödda nycklar är accelerator_type, experiment, num_accelerators, och user.

Globala flaggor

Databricks luftloggar

Streama eller hämta loggar för en runda.

databricks air logs JOB_RUN_ID [flags]

Arguments

JOB_RUN_ID

    Ett jobb-ID returnerades av databricks air run.

Options

--node int

    Välj ett nollbaserat nodindex. Standardvärde: 0.

--tail int

    Antal befintliga loglinjer att skriva ut. Standardvärde: 10000.

--minutes int

    Hämta loggar från de senaste minuterna. Det går inte att kombinera med --tail. Standardvärde: 0.

--retry int

    Välj ett försök igen. 0 är det första försöket och -1 är det senaste. Standardvärde: -1.

--download-to string

    Ladda ner kompletta loggar till en katalog. Laddar ner alla noder om inte --node är inställt. Det går inte att kombinera med --tail eller --minutes.

Globala flaggor

Databricks luftavbrytning

Avbryt en eller flera körningar med jobb-run ID, eller avbryt alla aktiva körningar som skickats in av den aktuella användaren.

databricks air cancel [JOB_RUN_ID...] [flags]

Arguments

JOB_RUN_ID

    Ett eller flera jobb kör ID:n. Det går inte att kombinera med --all.

Options

--all

    Avbryt alla aktiva körningar som skickats in av den nuvarande användaren. Standardvärde: false.

-y, --yes

    Hoppa över bekräftelseprompten som används av --all. Standardvärde: false.

Globala flaggor

Databricks luftpoollista

Lista provisionerad GPU-kapacitet som är tillgänglig för det aktuella arbetsytet.

Använd det provisionerade kapacitets-ID:t i compute.pool_id.

databricks air pools list [flags]

Arguments

None

Options

Globala flaggor

Databricks luftpooler får

Få detaljer om provisionerad GPU-kapacitet.

databricks air pools get [POOL_ID] [flags]

Arguments

POOL_ID

    Den provisionerade kapacitets-ID:n. Argumentet är valfritt endast när arbetsområdet har exakt en provisionerad kapacitet.

Options

Globala flaggor

Databricks Air Images pushar

Skicka en containerbild till Artifact Registry.

För förkunskaper och instruktioner för att pusha en bild, se Pusha bilder med Databricks CLI.

databricks air images push [flags]

Arguments

None

Options

-s, --source string

    Källcontainerbilden som ett namn med en valfri tagg (NAME[:TAG]) eller en digest (NAME@DIGEST). Om det utelämnas i en interaktiv terminal, uppmanar kommandot efter värdet.

--catalog string

    Destinationskatalogen Unity Catalog. Om det utelämnas i en interaktiv terminal, uppmanar kommandot efter värdet.

--schema string

    Destinationsschemat Unity Catalog. Om det utelämnas i en interaktiv terminal, uppmanar kommandot efter värdet.

--artifact string

    Destinationsartefakten som ARTIFACT[:TAG]. Som standard används källbildens namn och tagg, eller taggen latest när källan inte har någon tagg.

--pull

    Hämta källavbilden från dess register innan du pushar istället för att återanvända en tillgänglig lokal avbild. Standardvärde: false.

Globala flaggor

Databricks Air Convert-to-DABS

Konvertera en arbetsbelastnings-YAML-konfiguration till ett Databricks Asset Bundle. Detta lokala kommando skriver databricks.yml och startar filer under generated_artifacts/.

Detta kommando är en valfri brygga till ett avancerat produktionsarbetsflöde. Du kan fortsätta använda databricks air run utan att konvertera konfigurationen.

För paketarbetsflödet, se Schemalägg GPU-arbetsbelastningar och komponera uppgifter.

databricks air convert-to-dabs YAML_PATH [flags]

Arguments

YAML_PATH

    Vägen till arbetsbelastningens YAML-konfiguration.

Options

--output-dir string

    Katalogen där kommandot skriver paketet. Kodkällan måste finnas i denna katalog. Standard: katalogen som innehåller inmatningsfilen YAML.

--force

    Skriv över genererade bundle-filer som redan finns. Standardvärde: false.

Globala flaggor

Globala flaggor

--debug

  Om felsökningsloggning ska aktiveras.

-h eller --help

    Visa hjälp för Databricks CLI eller den relaterade kommandogruppen eller det relaterade kommandot.

--log-file sträng

    En sträng som representerar filen som utdataloggarna ska skrivas till. Om den här flaggan inte anges är standardvärdet att skriva utdataloggar till stderr.

--log-format Format

    Loggformattypen, text eller json. Standardvärdet är text.

--log-level sträng

    En sträng som representerar loggformatnivån. Om det inte anges inaktiveras loggformatnivån.

-o, --output typ

    Kommandots utdatatyp, text eller json. Standardvärdet är text.

-p, --profile sträng

    Namnet på profilen i ~/.databrickscfg-filen som ska användas för att köra kommandot. Om den här flaggan inte anges används den namngivna DEFAULT profilen om den finns.

--progress-format Format

    Formatet för att visa förloppsloggar: default, append, inplaceeller json

-t, --target sträng

    Om tillämpligt, paketmålet som ska användas

Migrera från den äldre Python CLI

Databricks CLI och den föråldrade Python-baserade air CLI använder olika kommandonamn och flaggor. Uppdatera skript med följande mappningar:

Python CLI Databricks kommandoradsgränssnitt (CLI)
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>

Ytterligare resurser

  • Uppdaterades senast