Ir al contenido principal

Databricks CLI

Databricks CLI

La Databricks CLI (interfaz de línea de comandos) te permite interactuar con la plataforma de Databricks desde tu terminal local o mediante un agente de programación. Para desarrollar apps en Databricks y ejecutar las plantillas de este sitio, es necesario instalar la CLI y autenticarte con ella.

Esta página abarca la instalación y la autenticación. Para ver la referencia completa de comandos, consulta la documentación oficial de la CLI.

Instalar o actualizar

Desde tu terminal, ejecuta los siguientes comandos para instalar o actualizar la CLI:

brew tap databricks/tap
brew install databricks

brew update && brew upgrade databricks
note

Todas las plantillas de DevHub dan por hecho que la Databricks CLI es de versión 1.0.0+.

Autenticarse

Para desarrollar apps en Databricks, debes autenticarte con la CLI. Esto le permite a la CLI interactuar con tu workspace de Databricks y realizar acciones en tu nombre.

Para autenticarte, ejecuta el siguiente comando:

databricks auth login

Esto te pide un nombre de perfil (por defecto, DEFAULT) y luego abre un navegador donde inicias sesión y eliges un workspace.

Una vez autenticado, las credenciales se guardan en ~/.databrickscfg.

Para autenticarte en un workspace específico o asignar un nombre al perfil, usa las flags --host y --profile:

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

Si tienes varios perfiles autenticados, puedes añadir --profile <PROFILE> en los comandos posteriores para dirigirlos a un perfil específico.

Para ver la lista de todos los perfiles guardados, ejecuta el siguiente comando:

databricks auth profiles

Ejemplo de salida:

Name              Host                                             Valid
DEFAULT           https://adb-1234567890.12.azuredatabricks.net    YES
my-prod-workspace https://mycompany.cloud.databricks.com           YES
  • Name es la etiqueta del perfil.
  • Host es la URL del workspace.
  • Valid es el resultado de una verificación de autenticación en tiempo real con el workspace. NO significa que la verificación falló; vuelve a ejecutar databricks auth login --profile <NAME> para volver a autenticarte.

Para CI/CD, usa credenciales de cliente de OAuth o autenticación basada en tokens (sin paso por el navegador). Consulta Autenticación de la CLI.

Qué sigue

  • Instala agent skills para que los asistentes de programación con IA conozcan la plataforma Databricks.
  • Configura el Docs MCP Server de DevHub para dar a los asistentes de programación con IA acceso a la documentación de DevHub.

Databricks Developer Hub

¿Todo listo para lanzar tu próxima aplicación basada en agentes en minutos?

Leer la documentación