air Grupo de Comando

O air grupo de comandos dentro da CLI Databricks submete e gerencia cargas de trabalho da GPU, como treinamento e inferência, com o tempo de execução de IA.

Para campos de configuração de carga de trabalho, veja referência Workload YAML. Para enviar sua primeira carga de trabalho, veja o início rápido do AI Runtime.

Databricks Air Run

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

databricks air run --file YAML_PATH [flags]

Arguments

None

Opções

-f, --file string

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

--watch

    Faça logs de fluxo do primeiro nó (nó 0) até que a execução atinja um estado terminal. Padrão: false.

--override stringArray

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

--dry-run

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

--idempotency-key string

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

Bandeiras globais

Examples

O exemplo a seguir envia uma carga de trabalho a partir e train.yaml transmite logs do primeiro nó (nó 0) até o término da execução:

databricks air run --file train.yaml --watch

Para enviar em segundo plano, omita --watch. O comando retorna após a submissão. Use o ID de Execução de Trabalho retornado para verificar o status e os logs de fluxo:

databricks air get <job-run-id>
databricks air logs <job-run-id>

Use o mesmo perfil de espaço de trabalho para envio, status e logs. Veja Perfis de configuração para a CLI Databricks.

Passe um caminho de configuração como argumento separado para -h exibir 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 retornado por databricks air run.

Opções

Bandeiras globais

Databricks Air List

A lista é executada. Por padrão, o comando lista as execuções ativas enviadas pelo usuário atual.

databricks air list [flags]

Arguments

None

Opções

--limit int

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

--all-status

    Inclua as corridas em estados terminais. Padrão: false.

--all-users

    Inclua sequências enviadas por outros usuários. Padrão: false.

--filter stringArray

    O filtro roda usando KEY=VALUE. Repita essa opção para adicionar condições. Uma corrida deve cumprir todas as condições. Veja Teclas de Filtro.

Bandeiras globais

Teclas de filtro

Cada --filter opção tem uma KEY=VALUE condição. = é o único operador. Você não pode negar uma condição, comparar faixas ou combinar condições com OR.

Chave Partidas Example
accelerator_type A família de aceleradores, como A10 ou H100, ou o valor total accelerator_type da carga de trabalho YAML, como GPU_8xH100. Sobrenomes não são sensíveis a maiúsculas e minúsculas. accelerator_type=H100
experiment Um padrão de globos comparado ao nome inteiro do experimento. A correspondência não é sensível de maiúsculas e minúsculas. * corresponde a qualquer sequência de caracteres, ? a um personagem e [abc] a um personagem do conjunto. Expressões regulares não são suportadas. Um valor sem coringa corresponde apenas a um experimento com exatamente esse nome. 'experiment=qwen*'
num_accelerators O número total de GPUs para a execução. O valor deve ser um inteiro positivo e deve corresponder exatamente. num_accelerators=8
user O nome de usuário do usuário que enviou a execução. O valor deve corresponder exatamente. Essa chave substitui a restrição padrão para suas próprias execuções, então você não precisa --all-usersde . user=person@example.com

Para os valores suportados accelerator_type , veja Tipos de acelerador.

Filtros restringiram as execuções que o comando já lista. Sem --all-status, apenas sequências ativas podem igualar.

Coloque aspas simples em torno de uma condição que contenha *, ?, ou [ algo assim que seu shell passe o padrão para a CLI sem alterações.

O comando retorna um erro se uma condição não estiver no KEY=VALUE formulário, usar uma chave que não está na tabela ou tiver um valor vazio ou inválido.

Examples

O exemplo a seguir lista suas corridas ativas que usam aceleradores H100:

databricks air list --filter accelerator_type=H100

O exemplo a seguir lista execuções em qualquer estado que person@example.com tenha sido submetido, onde o nome do experimento começa com qwen e a execução usa oito GPUs no total:

databricks air list --all-status \
  --filter 'experiment=qwen*' \
  --filter num_accelerators=8 \
  --filter user=person@example.com

Databricks Air Logs

Transmita ou busque logs para uma corrida.

databricks air logs JOB_RUN_ID [flags]

Arguments

JOB_RUN_ID

    Um ID de execução de trabalho retornado 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 loglines existentes para imprimir. Padrão: 10000.

--minutes int

    Buscar registros dos últimos minutos. Não é possível combinar 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

    Baixe os registros completos em um diretório. Baixa todos os nós, a menos que --node esteja configurado. Não é possível combinar com --tail ou --minutes.

Bandeiras globais

Databricks Air Cancel

Cancele uma ou mais execuções pelo ID de execução do trabalho, ou cancele todas as execuções ativas enviadas pelo usuário atual.

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

Arguments

JOB_RUN_ID

    Um ou mais IDs de trabalho feitos. Não é possível combinar com --all.

Opções

--all

    Cancele todas as execuções ativas enviadas pelo usuário atual. Padrão: false.

-y, --yes

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

Bandeiras globais

Databricks Air Images Push

Envie uma imagem de contêiner para o Registro de Artefatos.

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

databricks air images push [flags]

Arguments

None

Opções

-s, --source string

    A imagem do contêiner de origem como um nome com uma tag opcional (NAME[:TAG]) ou um digest (NAME@DIGEST). Se omitido em um terminal interativo, o prompt de comando mostra o valor.

--catalog string

    O catálogo do Catálogo Unity de destino. Se omitido em um terminal interativo, o prompt de comando mostra o valor.

--schema string

    O esquema do Catálogo Unity de destino. Se omitido em um terminal interativo, o prompt de comando mostra o valor.

--artifact string

    O artefato de destino como ARTIFACT[:TAG]. O padrão é o nome da imagem de origem e a tag, ou a latest tag quando a fonte não tem tag.

--pull

    Extraia a imagem de origem do registro 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 em um Databricks Asset Bundle. Esse comando local escreve databricks.yml e lança arquivos sob generated_artifacts/.

Esse comando é uma ponte opcional para um fluxo de trabalho avançado de produção. Você pode continuar usando databricks air run sem precisar converter a configuração.

Para o fluxo de trabalho em bundles, veja Agendar cargas de trabalho da GPU e tarefas de composição.

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 bundle. A fonte do código deve estar dentro desse diretório. Padrão: o diretório que contém o arquivo YAML de entrada.

--force

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

Bandeiras globais

Sinalizadores globais

--debug

  Indica se deve habilitar o registro em log de depuração.

-h ou --help

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

--log-file String

    Uma cadeia de caracteres que representa o arquivo onde serão gravados os logs de saída. Caso esse sinalizador não seja especificado, o padrão é registrar os logs de saída no stderr.

--log-format Formato

    O tipo de formato de log, text ou json. O valor padrão é 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á desabilitado.

-o, --output Tipo

    O tipo de saída do comando, text ou json. O valor padrão é text.

-p, --profile String

    O nome do perfil no arquivo ~/.databrickscfg, que deverá ser usado para executar o comando. Se esse sinalizador não for especificado, se 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 linha de comando legada de 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:

CLI de Python CLI do 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>

Recursos adicionais