Pular para o conteúdo principal
Última atualização em

Uso básico da CLI da Databricks

nota

Essas informações se aplicam ao site Databricks CLI versões 0.205 e superiores. A CLI da Databricks está em visualização pública.

Databricks CLI O uso está sujeito à LicençaDatabricks e ao Aviso de PrivacidadeDatabricks, incluindo qualquer provisionamento de Dados de Uso.

Este artigo mostra como listar Databricks CLI grupos de comandos e comandos, exibir Databricks CLI ajuda e trabalhar com Databricks CLI saída. Consulte O que é a CLI do Databricks?

Este artigo pressupõe que você já instalou a CLI Databricks e configurou a autenticação para a CLI. Consulte Instalar ou atualizar a CLI do Databricks e Autenticação para a CLI do Databricks.

Lista CLI grupos de comando​

Para listar os grupos de comandos CLI disponíveis, use a opção --help ou -h , por exemplo:

Bash
databricks -h

Lista CLI comando​

Para listar os comandos de qualquer grupo de comandos, use a opção --help ou -h . Por exemplo, para listar o comando clusters :

Bash
databricks clusters -h

Exibir a ajuda do comando da CLI​

Para exibir informações de uso de um comando, use a opção --help ou -h com o comando. Por exemplo, para exibir a ajuda do comando clusters list :

Bash
databricks clusters list -h

A referência de comandos também está disponível. Consulte o comando CLI Databricks.

execução a comando​

Informações completas sobre o uso e a sintaxe de cada comando podem ser encontradas na ajuda e referência da linha de comando, mas os comandos CLI Databricks geralmente seguem a seguinte sintaxe:

databricks <command-group> <command-name> <subcommand-name> [command-argument-value1] [--<flag1-name> <flag1-value>]

Nem todos os comandos possuem subcomandos adicionais. Sinalizadores globais estão disponíveis, e alguns comandos possuem sinalizadores adicionais. Por exemplo, o comando a seguir exibe os agrupamentos disponíveis, utilizando um sinalizador específico do comando:

Bash
databricks clusters list --can-use-client JOBS
dica

Você pode executar comandos CLI Databricks a partir de um workspace Databricks usando o terminal web. O terminal web workspace pode ser usado por vários usuários em um mesmo compute e não requer configuração de autenticação. Consulte o comando shell de execução no terminal web Databricks.

Use jq para filtrar a saída JSON​

Alguns Databricks CLI comando output JSON, o que significa que o senhor pode usar jq para filtrar o output. Por exemplo, para listar apenas o nome de exibição de um clustering Databricks com o ID de clustering especificado:

Bash
databricks clusters get 1234-567890-abcde123 | jq -r .cluster_name
Output
My-11.3-LTS-Cluster

O senhor pode instalar o jq no macOS usando o Homebrew com brew install jq ou no Windows usando o Chocolatey com choco install jq. Para obter mais informações sobre jq, consulte o Manual do jq.

JSON parâmetros de strings​

O formato dos parâmetros de strings é tratado de forma diferente em JSON, dependendo do seu sistema operacional:

O senhor deve colocar os parâmetros das cadeias de caracteres JSON entre aspas duplas e toda a carga útil do JSON entre aspas simples. Alguns exemplos:

'{"cluster_id": "1234-567890-abcde123"}'
'["20230323", "Amsterdam"]'

Configuração do servidor proxy​

Para rotear as solicitações e respostas da CLI da Databricks por meio de um servidor proxy, defina a variável de ambiente HTTPS_PROXY na máquina em que a CLI da Databricks está instalada para o URL do servidor proxy.

Para definir a variável de ambiente, consulte a documentação do seu sistema operacional.