Pular para o conteúdo principal

jobs grupo de comando

nota

Esta informação se aplica a Databricks CLI versões 0.205 e acima. A CLI do Databricks está em pré-visualização pública.

Databricks CLI O uso está sujeito à LicençaDatabricks e à Política de PrivacidadeDatabricks, incluindo qualquer disposição sobre Dados de Uso.

O grupo de comandos jobs dentro do Databricks CLI permite criar, editar e excluir tarefas. Consulte as vagas disponíveis emLakeFlow.

databricks Cancelar todas as execuções

Cancelar todas as execuções ativas de um trabalho. As execuções são canceladas de forma assíncrona, portanto, isso não impede que novas execuções sejam iniciadas.

databricks jobs cancel-all-runs [flags]

Argumentos

Nenhuma

Opções

--all-queued-runs

Parâmetro booleano opcional para cancelar todas as execuções em fila.

--job-id int

O identificador canônico da tarefa cuja execução deve ser cancelada.

--json JSON

As cadeias de caracteres JSON ou o caminho @path para o arquivo JSON com o corpo da solicitação.

Bandeiras globais

Cancelamento da execução de tarefas no Databricks

Cancelar uma execução.

Cancela uma execução de trabalho ou uma execução de tarefa. A execução é cancelada de forma assíncrona, portanto, ainda pode estar em andamento quando esta solicitação for concluída.

databricks jobs cancel-run RUN_ID [flags]

Argumentos

RUN_ID

Esse campo é obrigatório.

Opções

--json JSON

As cadeias de caracteres JSON ou o caminho @path para o arquivo JSON com o corpo da solicitação.

--no-wait

não espere para atingir o estado ENCERRADO ou IGNORADO

--timeout duration

tempo máximo para atingir o estado TERMINADO ou IGNORADO (default 20m0s)

Bandeiras globais

Tarefa do Databricks criada

Crie uma nova tarefa.

databricks jobs create [flags]

Argumentos

Nenhuma

Opções

--json JSON

As cadeias de caracteres JSON ou o caminho @path para o arquivo JSON com o corpo da solicitação.

Bandeiras globais

Exclusão de tarefa do Databricks

Excluir uma tarefa.

databricks jobs delete JOB_ID [flags]

Argumentos

JOB_ID

O identificador canônico da tarefa a ser excluída. Esse campo é obrigatório.

Opções

--json JSON

As cadeias de caracteres JSON ou o caminho @path para o arquivo JSON com o corpo da solicitação.

Bandeiras globais

Tarefa do Databricks: exclusão de execução

Exclua uma execução não ativa. Retorna um erro se a execução estiver ativa.

databricks jobs delete-run RUN_ID [flags]

Argumentos

RUN_ID

ID da execução a ser excluída.

Opções

--json JSON

As cadeias de caracteres JSON ou o caminho @path para o arquivo JSON com o corpo da solicitação.

Bandeiras globais

Exportação de tarefas do Databricks - execução

Exportar e recuperar a tarefa de execução do trabalho.

databricks jobs export-run RUN_ID [flags]

Argumentos

RUN_ID

O identificador canônico para a execução. Esse campo é obrigatório.

Opções

--views-to-export ViewsToExport

Qual visualização exportar. Valores suportados: ALL, CODE, DASHBOARDS

Bandeiras globais

databricks Obter trabalho

Recupera os detalhes de um único trabalho.

Matrizes grandes nos resultados serão paginadas quando excederem 100 elementos. Uma solicitação para um único trabalho retornará todas as propriedades desse trabalho e os primeiros 100 elementos das propriedades da matriz (tarefa, job_clusters, ambientes e parâmetros). Use o campo next_page_token para verificar mais resultados e passar seu valor como page_token nas solicitações subsequentes. Se alguma propriedade da matriz tiver mais de 100 elementos, resultados adicionais serão retornados nas solicitações subsequentes. As matrizes sem resultados adicionais ficarão vazias nas páginas posteriores.

databricks jobs get JOB_ID [flags]

Argumentos

JOB_ID

O identificador canônico da tarefa sobre a qual se deseja obter informações. Esse campo é obrigatório.

Opções

--page-token string

Utilize next_page_token retornado da resposta GetJob anterior para solicitar a próxima página das propriedades da matriz do Job.

Bandeiras globais

Tarefa do Databricks obter execução

Recupera os metadados de uma execução de tarefa.

Matrizes grandes nos resultados serão paginadas quando excederem 100 elementos. Uma solicitação para uma única execução retornará todas as propriedades para essa execução e os primeiros 100 elementos das propriedades da matriz (tarefa, job_clusters, job_parameters e repair_history). Use o campo next_page_token para verificar mais resultados e passar seu valor como page_token nas solicitações subsequentes. Se alguma propriedade da matriz tiver mais de 100 elementos, resultados adicionais serão retornados nas solicitações subsequentes. As matrizes sem resultados adicionais ficarão vazias nas páginas posteriores.

databricks jobs get-run RUN_ID [flags]

Argumentos

RUN_ID

O identificador canônico da execução para a qual os metadados devem ser recuperados. Esse campo é obrigatório.

Opções

--include-history

Inclua o histórico de reparos na resposta.

--include-resolved-values

Inclua valores de parâmetros resolvidos na resposta.

--page-token string

Utilize next_page_token retornado da resposta GetRun anterior para solicitar a próxima página das propriedades da matriz da execução.

Bandeiras globais

Tarefa do Databricks obter-execução-saída

Recuperar a saída e os metadados de uma única tarefa execução. Quando uma tarefa do Notebook retorna um valor por meio do dbutils.Notebook.exit() chamada, é possível utilizar este comando para recuperar esse valor. A Databricks restringe esta API ao retorno dos primeiros 5 MB da saída. Para retornar um resultado maior, é possível armazenar os resultados da tarefa em um serviço de armazenamento em nuvem.

Este comando valida se o parâmetro run_id é válido e retorna um código de status HTTP 400 se o parâmetro run_id for inválido. As execuções são automaticamente removidas após 60 dias. Caso deseje fazer referência a eles após 60 dias, é necessário salvar os resultados de execução antigos antes que eles expirem.

databricks jobs get-run-output RUN_ID [flags]

Argumentos

RUN_ID

O identificador canônico para a execução.

Opções

Bandeiras globais

Lista de vagas na Databricks

Recuperar uma lista de tarefas.

databricks jobs list [flags]

Argumentos

Nenhuma

Opções

--expand-tasks

Se deve incluir detalhes de tarefa e agrupamento na resposta.

--limit int

O número de tarefas a serem retornadas.

--name string

Um filtro na lista com base no nome exato (sem distinção entre maiúsculas e minúsculas) do trabalho.

--offset int

O deslocamento da primeira tarefa a retornar, em relação à tarefa criada mais recentemente.

--page-token string

Utilize next_page_token ou prev_page_token retornado da solicitação anterior para listar a próxima ou a página anterior do Trabalho, respectivamente.

Bandeiras globais

Lista de tarefas do Databricks - execução

Listar a execução do trabalho em ordem decrescente pela hora de início.

databricks jobs list-runs [flags]

Argumentos

Nenhuma

Opções

--active-only

Se active_only for verdadeiro, apenas as execuções ativas serão incluídas nos resultados; caso contrário, serão listadas tanto as execuções ativas quanto as concluídas.

--completed-only

Se completed_only for verdadeiro, apenas as execuções concluídas serão incluídas nos resultados; caso contrário, serão listadas tanto as execuções ativas quanto as concluídas.

--expand-tasks

Se deve incluir detalhes de tarefa e agrupamento na resposta.

--job-id int

A tarefa para a qual listar execução.

--limit int

O número de execução a retornar.

--offset int

O deslocamento da primeira execução a retornar, em relação à execução mais recente.

--page-token string

Utilize next_page_token ou prev_page_token retornado da solicitação anterior para listar a próxima ou a página anterior de execução, respectivamente.

--run-type RunType

O tipo de execução a ser retornada. Valores suportados: [JOB_RUN, SUBMIT_RUN, WORKFLOW_RUN]

--start-time-from int

Mostrar execuções que começam neste valor ou após ele.

--start-time-to int

Mostrar execuções que começam neste valor ou antes dele.

Bandeiras globais

Reparação de tarefas do Databricks - execução

Reexecutar uma ou mais tarefas do trabalho. As tarefas são reexecutadas como parte da execução original do trabalho. Eles utilizam as configurações atuais de Job e tarefa e podem ser visualizados no histórico da execução original do Job.

databricks jobs repair-run RUN_ID [flags]

Argumentos

RUN_ID

O ID de execução da tarefa a ser reparada. A execução não deve estar em andamento.

Opções

--json JSON

As cadeias de caracteres JSON ou o caminho @path para o arquivo JSON com o corpo da solicitação.

--latest-repair-id int

O ID do reparo mais recente.

--no-wait

não espere para atingir o estado ENCERRADO ou IGNORADO

--performance-target PerformanceTarget

O modo desempenho em uma tarefa do serverless. Valores suportados: [PERFORMANCE_OPTIMIZED, STANDARD]

--rerun-all-failed-tasks

Se for verdadeiro, repare todas as tarefas com falha.

--rerun-dependent-tasks

Se for verdadeiro, repare todas as tarefas que dependem da tarefa em rerun_tasks, mesmo que tenham sido bem-sucedidas anteriormente.

--timeout duration

tempo máximo para atingir o estado TERMINADO ou IGNORADO (default 20m0s)

Bandeiras globais

Redefinição de tarefas do Databricks

Substitua todas as configurações para o trabalho especificado. Utilize o comando “ databricks jobs update ” para atualizar parcialmente as configurações da tarefa.

databricks jobs reset [flags]

Argumentos

Nenhuma

Opções

--json JSON

As cadeias de caracteres JSON ou o caminho @path para o arquivo JSON com o corpo da solicitação.

Bandeiras globais

databricks Execução de tarefa agora

Executa uma tarefa e retorna o run_id da execução acionada.

databricks jobs run-now JOB_ID [flags]

Argumentos

JOB_ID

A identificação da tarefa a ser executada.

Opções

--idempotency-token string

Tokens opcionais para garantir a idempotência das solicitações de execução de tarefas.

--json JSON

As cadeias de caracteres JSON ou o caminho @path para o arquivo JSON com o corpo da solicitação.

--no-wait

não espere para atingir o estado ENCERRADO ou IGNORADO

--performance-target PerformanceTarget

O modo desempenho em uma tarefa do serverless. Valores suportados: [PERFORMANCE_OPTIMIZED, STANDARD]

--timeout duration

tempo máximo para atingir o estado TERMINADO ou IGNORADO (default 20m0s)

Bandeiras globais

Envio de tarefa no Databricks

Crie e acione uma execução única. Isso permite que você envie uma carga de trabalho diretamente, sem criar uma tarefa.

databricks jobs submit [flags]

Argumentos

Nenhuma

Opções

--budget-policy-id string

A identificação especificada pelo usuário da política orçamentária a ser utilizada para esta execução única.

--idempotency-token string

Um token opcional que pode ser utilizado para garantir a idempotência das solicitações de execução de tarefas.

--json JSON

As cadeias de caracteres JSON ou o caminho @path para o arquivo JSON com o corpo da solicitação.

--no-wait

não espere para atingir o estado ENCERRADO ou IGNORADO

--run-name string

Um nome opcional para a execução.

--timeout duration

tempo máximo para atingir o estado TERMINADO ou IGNORADO (default 20m0s)

--timeout-seconds int

Um tempo limite opcional aplicado a cada execução deste trabalho.

Bandeiras globais

Atualização de vagas na Databricks

Adicione, atualize ou remova configurações específicas de um trabalho existente. Utilize “ reset ” para substituir todas as configurações do trabalho.

databricks jobs update JOB_ID [flags]

Argumentos

JOB_ID

O identificador canônico da tarefa a ser atualizada. Esse campo é obrigatório.

Opções

--json JSON

As cadeias de caracteres JSON ou o caminho @path para o arquivo JSON com o corpo da solicitação.

Bandeiras globais

databricks Tarefa obter-níveis-de-permissão

Obter níveis de permissão de trabalho.

databricks jobs get-permission-levels JOB_ID [flags]

Argumentos

JOB_ID

A tarefa para a qual se deseja obter ou gerenciar permissões.

Opções

Bandeiras globais

Tarefa do Databricks obter permissões

Obter as permissões de um trabalho. Os trabalhos podem herdar permissões de seu objeto raiz.

databricks jobs get-permissions JOB_ID [flags]

Argumentos

JOB_ID

A tarefa para a qual se deseja obter ou gerenciar permissões.

Opções

Bandeiras globais

databricks Definir permissões de tarefa

Defina as permissões do trabalho.

Define as permissões em um objeto, substituindo as permissões existentes, se elas existirem. Exclui todas as permissões diretas se nenhuma for especificada. Os objetos podem herdar permissões do objeto raiz.

databricks jobs set-permissions JOB_ID [flags]

Argumentos

JOB_ID

A tarefa para a qual se deseja obter ou gerenciar permissões.

Opções

--json JSON

As cadeias de caracteres JSON ou o caminho @path para o arquivo JSON com o corpo da solicitação.

Bandeiras globais

databricks Atualização de permissões de trabalho

Atualize as permissões em uma tarefa. Os trabalhos podem herdar permissões de seu objeto raiz.

databricks jobs update-permissions JOB_ID [flags]

Argumentos

JOB_ID

A tarefa para a qual se deseja obter ou gerenciar permissões.

Opções

--json JSON

As cadeias de caracteres JSON ou o caminho @path para o arquivo JSON com o corpo da solicitação.

Bandeiras globais

Bandeiras globais

--debug

Se deve habilitar o registro de depuração.

-h ou --help

Exibir ajuda para o comando Databricks CLI ou para o grupo de comandos relacionado ou para o comando relacionado.

--log-file string

Uma string que representa o arquivo no qual a saída logs deve ser gravada. Se este sinalizador não for especificado, o default deverá gravar a saída logs no stderr.

--log-format Formato

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

--log-level string

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

-o, --output Tipo

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

-p, --profile string

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

--progress-format Formato

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

-t, --target string

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