CLI do Databricks

Observação

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.

A CLI do Databricks (interface de linha de comando) permite que você interaja com a plataforma Azure Databricks dos scripts de terminal ou automação local. Você também pode executar comandos da CLI do Databricks de dentro de um workspace do Databricks usando o terminal da Web. Consulte executar os comandos de shell no terminal web do Azure Databricks.

Para instalar e configurar a autenticação para a CLI do Databricks, consulte Instalar ou atualizar a CLI do Databricks e Autenticação para a CLI do Databricks.

Dica

A fonte da CLI do Databricks está disponível publicamente no databricks/cli GitHub repositório.

Como funciona a CLI do Databricks?

A CLI encapsula a API REST do Databricks, que fornece endpoints para modificar ou solicitar informações sobre contas e objetos de workspace do Azure Databricks. Consulte a referência da API REST Azure Databricks.

Por exemplo, para exibir informações sobre um cluster específico em um espaço de trabalho:

databricks clusters get 1234-567890-a12bcde3

Com curl, a operação equivalente é a seguinte:

curl --request GET "https://${DATABRICKS_HOST}/api/2.0/clusters/get" \
     --header "Authorization: Bearer ${DATABRICKS_TOKEN}" \
     --data '{ "cluster_id": "1234-567890-a12bcde3" }'

Tipos de versão da CLI do Databricks

O tipo de versão da CLI do Databricks corresponde à versão:

• As versões 1.0.0 e superiores estão geralmente disponíveis (GA).
• As versões 0.205 até 0.299 estão em prévia pública.
• As versões 0.18 e abaixo são a CLI herdada.

CLI legada

A CLI legada do Databricks corresponde às versões 0.18 ou anteriores.

• O Databricks não planeja oferecer suporte ou novos recursos para a CLI herdada do Databricks.
• Para obter mais informações sobre a CLI herdada do Databricks, consulte a CLI herdada do Databricks.
• Para migrar da CLI do Databricks versão 0.18 ou inferior para a CLI do Databricks versão 0.205 ou superior, consulte migração da CLI do Databricks.

Próximas etapas

• Para instalar a CLI e configurar a autenticação para começar rapidamente, consulte o tutorial da CLI do Databricks.
• Para ignorar o tutorial e apenas instalar a CLI, confira Instalar ou atualizar a CLI do Databricks.
• Para saber mais sobre todos os tipos de autenticação disponíveis entre a CLI e suas contas Azure Databricks e workspaces, consulte Authentication para a CLI do Databricks.
• Para usar perfis de configuração para alternar rapidamente entre grupos relacionados de configurações da CLI, confira Perfis de configuração da CLI do Databricks.
• Para saber mais sobre o uso básico da CLI, confira Uso básico da CLI do Databricks.
• Para obter uma lista de todos os comandos disponíveis da CLI, consulte os comandos da CLI do Databricks.