Grupo de comandos de configure

Nota:

Esta información se aplica a las versiones 0.205 y posteriores de la CLI de Databricks, que se encuentran en Versión preliminar pública. Para encontrar su versión de la CLI de Databricks, ejecute databricks -v.

El grupo de comandos configure de la CLI de Databricks le permite autenticar la CLI de Databricks con Azure Databricks mediante tokens de acceso personal de Azure Databricks o tokens de Microsoft Entra ID (antes Azure Active Directory).

Nota:

Como procedimiento recomendado de seguridad, cuando se autentique con herramientas, sistemas, scripts y aplicaciones automatizados, Databricks recomienda usar los tokens de acceso personal pertenecientes a las entidades de servicio en lugar de a los usuarios del área de trabajo. Para crear tókenes para entidades de servicio, consulte Administración de tokens de acceso para una entidad de servicio.

Observe que en este artículo solo se habla de la autenticación con el token de acceso personal de Azure Databricks y el token de Microsoft Entra ID (antes Azure Active Directory) para permitir la llamada de comandos de nivel de área de trabajo. Para obtener opciones de configuración de autenticación adicionales, consulte Autenticación para la CLI de Databricks.

Importante

Antes de ejecutar este comando, asegúrese de configurar la CLI de Databricks.

Los comandos configure se ejecutan añadiéndolos a databricks configure. Para mostrar la ayuda para el comando configure, ejecute databricks configure -h.

Creación de un perfil de configuración

Un perfil de configuración es una colección de valores que contiene información de autenticación, como una dirección URL del área de trabajo de Azure Databricks y un valor de token de acceso. Un perfil de configuración tiene un nombre mediante programación, como DEFAULT, DEV o PROD.

Para crear un perfil de configuración, ejecute el comando configure de la siguiente manera:

databricks configure --host <workspace-url>

Para <workspace-url>, introduce tu URL por área de trabajo, con el formato https://adb-<workspace-id>.<random-number>.azuredatabricks.net. Para obtener la dirección URL por área de trabajo, consulte Dirección URL por área de trabajo.

El comando le pide que escriba el token de acceso personal de Azure Databricks o el token de Microsoft Entra ID (antes Azure Active Directory) que se asigna al valor de <workspace-url> especificado:

✔ Databricks Token:

Después de escribir el token de acceso, el token de acceso se almacena en el archivo ~/.databrickscfg en Linux o macOS, o %USERPROFILE%\.databrickscfg en Windows de forma predeterminada. El archivo contiene una entrada de perfil de conexión predeterminada denominada DEFAULT:

[DEFAULT]
host  = <workspace-url>
token = <access-token>

Para usar un nombre diferente para el perfil de conexión en lugar de DEFAULT, agregue la opción --profile al comando configure, por ejemplo:

databricks configure --host <workspace-url> --profile <profile-name>

Sugerencia

Puede presionar Tab después de --profile o -p para mostrar una lista de perfiles de configuración disponibles entre los que elegir, en lugar de escribir manualmente el nombre del perfil de configuración.

Cualquier información de token y host existente dentro del perfil de conexión especificado se sobrescribe con la nueva información de host y token.

Agregar varios perfiles de conexión al archivo .databrickscfg le permite ejecutar rápidamente comandos en varias áreas de trabajo especificando el nombre del perfil de conexión de destino en la opción del comando --profile. Si no especifica la opción --profile en un comando que admite esta opción, el comando usará el perfil de conexión DEFAULT de forma predeterminada.

Por ejemplo, podría tener un perfil de conexión denominado DEV que haga referencia a un área de trabajo de Azure Databricks que use para cargas de trabajo de desarrollo y un perfil de conexión independiente denominado perfil de conexión PROD que haga referencia a un área de trabajo de Azure Databricks diferente que use para cargas de trabajo de producción.

Puede cambiar la ruta predeterminada del archivo .databrickscfg configurando la variable de entorno DATABRICKS_CONFIG_FILE. Para aprender cómo establecer estas variables de entorno, consulte la documentación del sistema operativo.

Para obtener información sobre los perfiles de configuración existentes, use el grupo de comandos de autenticación.