Pular para o conteúdo principal

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 o senhor já tenha instalado o Databricks CLI e configurado o CLI para autenticação. Consulte Instalar ou atualizar a CLI da Databricks e Autenticação para a CLI da Databricks.

Lista CLI grupos de comando

O senhor lista os grupos de comando usando a opção --help ou -h. Por exemplo:

Bash
databricks -h

Lista CLI comando

O senhor lista o comando de qualquer grupo de comandos usando a opção --help ou -h. Por exemplo, para listar o clusters comando:

Bash
databricks clusters -h

Exibir a ajuda do comando da CLI

O senhor exibe a ajuda de um comando usando a opção --help ou -h. Por exemplo, para exibir a ajuda do comando clusters list:

Bash
databricks clusters list -h

execução a comando

Informações completas sobre o uso e a sintaxe de cada comando podem ser encontradas na ajuda da linha de comando, mas Databricks CLI comando geralmente obedece à seguinte sintaxe:

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

Nem todo comando tem subcomandos adicionais. Estão disponíveis sinalizadores globais, e alguns comandos têm sinalizadores adicionais. Por exemplo, o comando a seguir gera o clustering disponível, usando um sinalizador específico do comando:

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

O senhor pode executar Databricks CLI comando de dentro de um Databricks workspace usando o terminal da Web. O terminal da Web pode ser usado por vários usuários em um único compute e não requer configuração de chave. Consulte execução shell comando em Databricks web terminal.

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:

You must enclose JSON string parameters in double quotes, and you must enclose the entire JSON payload in single quotes. Some examples:

'{"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 no computador em que a CLI da Databricks está instalada para o URL do servidor proxy.

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