air opdrachtgroep

Important

Deze functie bevindt zich in openbare preview-versie.

De air commandogroep binnen de Databricks CLI stuurt en beheert GPU-workloads, zoals training en inferentie, met AI Runtime.

Voor workloadconfiguratievelden, zie Workload YAML referentie. Om je eerste workload in te dienen, zie Databricks CLI quickstart voor AI Runtime.

Databricks Air Run

Dien een workload in vanuit een YAML-configuratie. De output bevat de job run ID en de job run URL.

databricks air run --file YAML_PATH [flags]

Arguments

None

Options

-f, --file string

    Pad naar de workload YAML-configuratie. Deze optie is vereist.

--watch

    Stream node 0 logt totdat de run een terminale toestand bereikt. Standaard: false.

--override stringArray

    Overschrijf een YAML-veld met behulp van FIELD_PATH=VALUE. Herhaal deze optie om meerdere velden te overschrijven.

--dry-run

    Valideer de configuratie zonder een workload in te dienen. Standaard: false.

--idempotency-key string

    Geef een bestaande run terug toen de sleutel eerder werd gebruikt. Overrides idempotency_token in de YAML. Maximaal: 64 tekens.

Globale vlaggen

Voorbeelden

Het volgende voorbeeld levert een werklast in van train.yaml:

databricks air run --file train.yaml

Geef een configuratiepad als apart argument door om -h workloadconfiguratiehulp weer te geven:

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

Databricks Air Get

Verzamel details voor een run.

databricks air get JOB_RUN_ID [flags]

Arguments

JOB_RUN_ID

    Een job run ID werd teruggegeven door databricks air run.

Options

Globale vlaggen

Databricks Air List

Lijstuitvoeringen. Standaard geeft het commando actieve runs weer die door de huidige gebruiker zijn ingediend.

databricks air list [flags]

Arguments

None

Options

--limit int

    Maximaal aantal runs om te laten zien. Standaard: 20.

--all-status

    Inclusief runs in terminalstaten. Standaard: false.

--all-users

    Inclusief runs die door andere gebruikers zijn ingediend. Standaard: false.

--filter stringArray

    Het filter draait met .KEY=VALUE Herhaal deze optie om meerdere voorwaarden te vereisen. Ondersteunde sleutels zijn accelerator_type, experiment, num_accelerators, en user.

Globale vlaggen

Databricks luchtlogboeken

Stream of haal logs voor een run.

databricks air logs JOB_RUN_ID [flags]

Arguments

JOB_RUN_ID

    Een job run ID werd teruggegeven door databricks air run.

Options

--node int

    Selecteer een zero-based node-index. Standaard: 0.

--tail int

    Aantal bestaande loglijnen om te printen. Standaard: 10000.

--minutes int

    Haal logs van de laatste minuten. Kan niet worden gecombineerd met --tail. Standaard: 0.

--retry int

    Selecteer een poging tot herkansing. 0 is de eerste poging en -1 is de nieuwste. Standaard: -1.

--download-to string

    Download volledige logboeken naar een directory. Downloadt alle nodes tenzij --node ingesteld. Kan niet worden gecombineerd met --tail of --minutes.

Globale vlaggen

Databricks air cancel

Annuleer één of meer runs met job run ID, of annuleer alle actieve runs die door de huidige gebruiker zijn ingediend.

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

Arguments

JOB_RUN_ID

    Eén of meer taken draaien ID's. Kan niet worden gecombineerd met --all.

Options

--all

    Annuleer alle actieve runs die door de huidige gebruiker zijn ingediend. Standaard: false.

-y, --yes

    Sla de bevestigingsprompt over die door --allwordt gebruikt. Standaard: false.

Globale vlaggen

Databricks Air Pools List

Vermeld de beschikbare GPU-capaciteit voor de huidige werkruimte.

Gebruik de provisioned capacity ID in compute.pool_id.

databricks air pools list [flags]

Arguments

None

Options

Globale vlaggen

Databricks Air Pools krijgen

Bekijk details over de geprovisioneerde GPU-capaciteit.

databricks air pools get [POOL_ID] [flags]

Arguments

POOL_ID

    De provisioned capacity ID. Het argument is alleen optioneel wanneer de werkruimte precies één geprovisioneerde capaciteit heeft.

Options

Globale vlaggen

Databricks Air Images pushen

Stuur een containerafbeelding naar het Artefactregister.

Voor vereisten en instructies voor het pushen van een image, zie Push images met de Databricks CLI.

databricks air images push [flags]

Arguments

None

Options

-s, --source string

    De broncontainerafbeelding als naam met een optionele tag (NAME[:TAG]) of een digest (NAME@DIGEST). Als het in een interactieve terminal wordt weggelaten, vraagt het commando om de waarde.

--catalog string

    De bestemming Unity Catalog catalogus. Als het in een interactieve terminal wordt weggelaten, vraagt het commando om de waarde.

--schema string

    Het bestemmingsschema Unity Catalog. Als het in een interactieve terminal wordt weggelaten, vraagt het commando om de waarde.

--artifact string

    Het bestemmingsartefact als ARTIFACT[:TAG]. Standaard gebruikt hij de naam en tag van de bronafbeelding, of de latest tag wanneer de bron geen tag heeft.

--pull

    Haal de bronimage uit het register voordat je pusht in plaats van een beschikbare lokale image opnieuw te gebruiken. Standaard: false.

Globale vlaggen

Databricks Air Convert-to-Dabs

Zet een workload YAML-configuratie om in een Databricks Asset Bundle. Dit lokale commando schrijft databricks.yml en start bestanden onder generated_artifacts/.

Dit commando is een optionele brug naar een geavanceerde productieworkflow. Je kunt blijven gebruiken databricks air run zonder de configuratie te converteren.

Voor de bundelworkflow, zie GPU-workloads plannen en taken samenstellen.

databricks air convert-to-dabs YAML_PATH [flags]

Arguments

YAML_PATH

    Het pad naar de workload YAML-configuratie.

Options

--output-dir string

    Map waarin het commando de bundel schrijft. De codebron moet zich in deze map bevinden. Standaard: de map die het invoer-YAML-bestand bevat.

--force

    Overschrijf gegenereerde bundelbestanden die al bestaan. Standaard: false.

Globale vlaggen

Globale vlaggen

--debug

  Of u logboekregistratie voor foutopsporing wilt inschakelen.

-h of --help

    Help weergeven voor de Databricks CLI, de bijbehorende opdrachtgroep of de bijbehorende opdracht.

--log-file snaar

    Een tekenreeks die het bestand aangeeft waar uitvoerlogboeken naar moeten worden geschreven. Als deze vlag niet is opgegeven, is het standaardinstelling om uitvoerlogboeken naar stderr te schrijven.

--log-format formatteren

    Het logformaat type, text of json. De standaardwaarde is text.

--log-level snaar

    Een tekenreeks die het niveau van de logboekindeling vertegenwoordigt. Als dit niet is opgegeven, wordt het niveau van de logboekindeling uitgeschakeld.

-o, --output Type

    Het type uitvoer van de opdracht, text of json. De standaardwaarde is text.

-p, --profile snaar

    De naam van het profiel in het ~/.databrickscfg bestand dat moet worden gebruikt om de opdracht uit te voeren. Als deze vlag niet is opgegeven en hij bestaat, wordt het profiel met de naam DEFAULT gebruikt.

--progress-format formatteren

    De indeling voor het weergeven van voortgangslogboeken: default, append, inplaceof json

-t, --target snaar

    Indien van toepassing, het bundeldoel dat moet worden gebruikt

Migreren vanaf de legacy Python CLI

De Databricks CLI en de verouderde Python-gebaseerde air CLI gebruiken verschillende commandonamen en vlaggen. Update-scripts met de volgende mappings:

Python CLI Databricks-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>

Aanvullende bronnen