Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Note
Essas informações se aplicam às versões 0.205 e superiores da CLI do Databricks. A CLI do Databricks está em Pré-Visualização Pública.
O uso da CLI do Databricks está sujeito à Licença do Databricks e ao Aviso de Privacidade do Databricks, incluindo quaisquer disposições de Dados de Uso.
Este artigo mostra como listar grupos de comandos e comandos da CLI do Databricks, exibir a ajuda da CLI do Databricks e trabalhar com a saída da CLI do Databricks. Consulte O que é a CLI do Databricks?.
Este artigo assume que 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.
Listar grupos de comandos da CLI
Para listar os grupos de comandos CLI disponíveis, use a opção --help ou -h, por exemplo.
databricks -h
Listar comandos da CLI
Para listar os comandos de qualquer grupo de comandos, use a opção --help ou -h. Por exemplo, para listar os clusters comandos:
databricks clusters -h
Exibir ajuda do comando da CLI
Para mostrar as informações de utilização de um comando, use a opção --help ou -h com o comando. Por exemplo, para exibir a ajuda para o clusters list comando:
databricks clusters list -h
Também está disponível referência de comando. Consulte Comandos da CLI do Databricks.
Executar um comando
Informação completa de utilização e sintaxe para comandos individuais podem ser encontradas na ajuda e referência da linha de comandos, mas os comandos CLI do Databricks geralmente seguem a seguinte sintaxe:
databricks <command-group> <command-name> <subcommand-name> [command-argument-value1] [--<flag1-name> <flag1-value>]
Nem todos os comandos têm subcomandos adicionais. Sinalizadores globais estão disponíveis e alguns comandos têm sinalizadores adicionais. Por exemplo, o comando a seguir gera clusters disponíveis, usando um sinalizador específico de comando:
databricks clusters list --can-use-client JOBS
Tip
Você pode executar comandos da CLI do Databricks de dentro de um espaço de trabalho do Databricks usando o terminal da Web. O terminal web do workspace pode ser usado por muitos utilizadores num único computador e não requer que configure a autenticação. Consulte Executar comandos de shell no terminal Web do Azure Databricks.
Use jq para filtrar a saída JSON
Alguns comandos da CLI do Databricks produzem JSON, o que significa que podes usar jq para filtrar a saída. Por exemplo, para listar apenas o nome para exibição de um cluster do Azure Databricks com a ID de cluster especificada:
databricks clusters get 1234-567890-abcde123 | jq -r .cluster_name
My-11.3-LTS-Cluster
Você pode instalar jq no macOS usando Homebrew com brew install jq ou no Windows usando Chocolatey com choco install jq. Para obter mais informações sobre o jq, veja o Manual do jq.
Parâmetros da cadeia JSON
O formato dos parâmetros de cadeia de caracteres é tratado de forma diferente em JSON, dependendo do seu sistema operacional:
Linux ou macOS
Você deve colocar parâmetros de cadeia de caracteres JSON entre aspas duplas e colocar toda a carga JSON entre aspas simples. Alguns exemplos:
'{"cluster_id": "1234-567890-abcde123"}'
'["20230323", "Amsterdam"]'
Windows
Você deve incluir parâmetros de cadeia de caracteres JSON e toda a carga JSON entre aspas duplas, e os caracteres de aspas duplas dentro da carga JSON devem ser precedidos por \. Alguns exemplos:
"{\"cluster_id\": \"1234-567890-abcde123\"}"
"[\"20230323\", \"Amsterdam\"]"
Configuração do servidor proxy
Para rotear solicitações e respostas da CLI do Databricks por meio de um servidor proxy, defina a HTTPS_PROXY variável de ambiente na máquina em que a CLI do Databricks está instalada para a URL do servidor proxy.
Para definir variáveis de ambiente, consulte a documentação do seu sistema operacional.