Databricks CLI

A Databricks CLI (interface de linha de comando) permite interagir com a plataforma Databricks a partir do seu terminal local ou por meio de um agente de codificação. É necessário instalar e autenticar a CLI para desenvolver apps no Databricks e para executar os templates deste site.

Esta página aborda a instalação e a autenticação. Para a referência completa de comandos, consulte a documentação oficial da CLI.

Instalar ou atualizar

No seu terminal, execute os comandos a seguir para instalar ou atualizar a CLI:

brew tap databricks/tap
brew install databricks

brew update && brew upgrade databricks

Autenticar

Para desenvolver apps no Databricks, você precisa se autenticar na CLI. Isso permite que a CLI interaja com o seu workspace do Databricks e execute ações em seu nome.

Para se autenticar, execute o seguinte comando:

databricks auth login

O comando pede um nome de perfil (o padrão é DEFAULT) e, em seguida, abre um navegador para você fazer login e escolher um workspace.

Após a autenticação, as credenciais são salvas em ~/.databrickscfg.

Para autenticar em um workspace específico ou definir o nome do perfil, use as flags --host e --profile:

databricks auth login --host <workspace-url> --profile <PROFILE>

Se você tiver vários perfis autenticados, pode passar --profile <PROFILE> nos comandos seguintes para usar um perfil específico.

Para listar todos os perfis salvos, execute o seguinte comando:

databricks auth profiles

Exemplo de saída:

Name              Host                                             Valid
DEFAULT           https://adb-1234567890.12.azuredatabricks.net    YES
my-prod-workspace https://mycompany.cloud.databricks.com           YES

• Name é o rótulo do perfil.
• Host é a URL do workspace.
• Valid é o resultado de uma verificação de autenticação em tempo real no workspace. NO significa que a verificação falhou; execute novamente databricks auth login --profile <NAME> para se autenticar.

Para CI/CD, use credenciais de cliente OAuth ou autenticação baseada em token (sem etapa no navegador). Consulte Autenticação da CLI.

Próximos passos

• Instale as agent skills para dar aos assistentes de programação com IA conhecimento sobre a plataforma Databricks.
• Configure o Docs MCP Server do DevHub para dar aos assistentes de programação com IA acesso à documentação do DevHub.