Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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.
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
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.
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.
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.
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.
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.
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> |