air grupo de comando

O air grupo de comandos dentro da CLI Databricks submete e gere cargas de trabalho da GPU, como treino e inferência, com AI Runtime.

Para campos de configuração de carga de trabalho, consulte referência Workload YAML. Para submeter a sua primeira carga de trabalho, consulte o quickstart da CLI do Databricks para AI Runtime.

Databricks Air Run

Submeter uma carga de trabalho a partir de uma configuração YAML. A saída inclui o ID de execução do trabalho e o URL de execução do trabalho.

databricks air run --file YAML_PATH [flags]

Arguments

None

Opções

-f, --file string

    Caminho para a configuração YAML da carga de trabalho. Esta opção é obrigatória.

--watch

    Fluxo do nó 0 registo até a execução atingir um estado terminal. Padrão: false.

--override stringArray

    Sobrescrita um campo YAML usando FIELD_PATH=VALUE. Repita esta opção para sobrescrever vários campos.

--dry-run

    Valida a configuração sem submeter uma carga de trabalho. Padrão: false.

--idempotency-key string

    Devolva uma execução existente quando a chave foi usada anteriormente. Sobrescrições idempotency_token no YAML. Máximo: 64 caracteres.

Bandeiras globais

Examples

O exemplo seguinte apresenta uma carga de trabalho a partir de train.yaml:

databricks air run --file train.yaml

Passe um caminho de configuração como argumento separado para -h mostrar ajuda na configuração da carga de trabalho:

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

Databricks Air Get

Obtenha detalhes para uma corrida.

databricks air get JOB_RUN_ID [flags]

Arguments

JOB_RUN_ID

    Um ID de execução de trabalho devolvido por databricks air run.

Opções

Bandeiras globais

Databricks Air List

A lista é executada. Por defeito, o comando lista as execuções ativas submetidas pelo utilizador atual.

databricks air list [flags]

Arguments

None

Opções

--limit int

    Número máximo de corridas para mostrar. Padrão: 20.

--all-status

    Incluir corridas em estados terminais. Padrão: false.

--all-users

    Inclua sequências submetidas por outros utilizadores. Padrão: false.

--filter stringArray

    O filtro executa usando KEY=VALUE. Repita esta opção para exigir múltiplas condições. As teclas suportadas são accelerator_type, experiment, num_accelerators, e user.

Bandeiras globais

Databricks Air Logs

Transmite ou recolhe registos para uma corrida.

databricks air logs JOB_RUN_ID [flags]

Arguments

JOB_RUN_ID

    Um ID de execução de trabalho devolvido por databricks air run.

Opções

--node int

    Selecione um índice de nós baseado em zero. Padrão: 0.

--tail int

    Número de linhas de registo existentes para imprimir. Padrão: 10000.

--minutes int

    Vai buscar registos dos últimos minutos. Não pode ser combinado com --tail. Padrão: 0.

--retry int

    Selecione uma tentativa de retentativa. 0 é a tentativa inicial e -1 é a mais recente. Padrão: -1.

--download-to string

    Descarregue os registos completos para um diretório. Descarrega todos os nós a menos que --node esteja definido. Não pode ser combinado com --tail ou --minutes.

Bandeiras globais

Databricks Air Cancel

Cancele uma ou mais execuções pelo ID da execução do trabalho, ou cancele todas as execuções ativas submetidas pelo utilizador atual.

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

Arguments

JOB_RUN_ID

    Um ou mais IDs de execução de trabalho. Não pode ser combinado com --all.

Opções

--all

    Cancelar todas as execuções ativas submetidas pelo utilizador atual. Padrão: false.

-y, --yes

    Ignora o prompt de confirmação usado por --all. Padrão: false.

Bandeiras globais

Lista de piscinas aéreas Databricks

Liste a capacidade da GPU provisionada disponível para o espaço de trabalho atual.

Use o ID de capacidade provisionado em compute.pool_id.

databricks air pools list [flags]

Arguments

None

Opções

Bandeiras globais

Databricks Air Pools obtêm

Obtenha detalhes sobre a capacidade da GPU provisionada.

databricks air pools get [POOL_ID] [flags]

Arguments

POOL_ID

    O ID de capacidade provisionado. O argumento é opcional apenas quando o espaço de trabalho tem exatamente uma capacidade provisionada.

Opções

Bandeiras globais

Databricks Air Images Push

Envie uma imagem de contentor para o Registo de Artefactos.

Para pré-requisitos e instruções para empurrar uma imagem, veja Push imagens com a Cis Databricks.

databricks air images push [flags]

Arguments

None

Opções

-s, --source string

    A imagem do contentor de origem como um nome com uma etiqueta opcional (NAME[:TAG]) ou um digest (NAME@DIGEST). Se omitido num terminal interativo, o prompt de comandos para o valor.

--catalog string

    O catálogo do Catálogo Unity de destino. Se omitido num terminal interativo, o prompt de comandos para o valor.

--schema string

    O esquema do Catálogo Unity de destino. Se omitido num terminal interativo, o prompt de comandos para o valor.

--artifact string

    O artefacto de destino como ARTIFACT[:TAG]. Por defeito, o nome e a etiqueta da imagem de origem são atribuídos, ou a latest etiqueta quando a fonte não tem etiqueta.

--pull

    Retira a imagem de origem do seu registo antes de fazer push em vez de reutilizar uma imagem local disponível. Padrão: false.

Bandeiras globais

Databricks Air Convert-to-DABs

Converta uma configuração YAML de carga de trabalho num Databricks Asset Bundle. Este comando local escreve databricks.yml e lança ficheiros em generated_artifacts/.

Este comando é uma ponte opcional para um fluxo de trabalho avançado de produção. Podes continuar a usar databricks air run sem converter a configuração.

Para o fluxo de trabalho do bundle, veja Agendar cargas de trabalho da GPU e compor tarefas.

databricks air convert-to-dabs YAML_PATH [flags]

Arguments

YAML_PATH

    O caminho para a configuração YAML da carga de trabalho.

Opções

--output-dir string

    Diretório onde o comando escreve o pacote. A fonte do código deve estar dentro deste diretório. Padrão: o diretório que contém o ficheiro YAML de entrada.

--force

    Sobrescreva ficheiros bundle gerados que já existem. Padrão: false.

Bandeiras globais

Bandeiras globais

--debug

  Se o log de depuração deve ser habilitado.

-h ou --help

    Exiba a ajuda para a CLI do Databricks ou para o grupo de comandos relacionado ou para o comando relacionado.

--log-file String

    Uma cadeia de caracteres que representa o ficheiro onde os registos de saída são gravados. Se esse sinalizador não for especificado, o padrão é gravar logs de saída no stderr.

--log-format Formato

    O tipo de formato de log, text ou json. O valor predefinido é text.

--log-level String

    Uma cadeia de caracteres que representa o nível de formato de log. Se não for especificado, o nível de formato de log será desativado.

-o, --output tipo

    O tipo de saída do comando, text ou json. O valor predefinido é text.

-p, --profile String

    O nome do perfil no arquivo ~/.databrickscfg a usar para executar o comando. Se esse sinalizador não for especificado, se ele existir, o perfil nomeado DEFAULT será usado.

--progress-format Formato

    O formato para exibir logs de progresso: default, append, inplace, ou json

-t, --target String

    Se aplicável, o destino do pacote a ser usado

Migrar a partir da antiga CLI Python

A CLI Databricks e a CLI obsoleta baseada air em Python usam nomes e flags de comandos diferentes. Atualize scripts usando os seguintes mapeamentos:

Recursos adicionais

• Databricks CLI quickstart para IA Runtime
• Referência YAML de carga de trabalho
• Acompanhar execuções com o MLflow e a página de execução de trabalhos