Compartir a través de

Grupo de comandos de configure

Nota:

Esta información se aplica a las versiones 0.205 y posteriores de la CLI de Databricks. La CLI de Databricks está en versión preliminar pública.

El uso de la CLI de Databricks está sujeto a la licencia de Databricks y al aviso de privacidad de Databricks, incluidas las disposiciones de datos de uso.

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 tokens para entidades de servicio, consulte Administrar tokens para una entidad de servicio.

Tenga en cuenta que este artículo solo trata sobre el token de acceso personal de Azure Databricks y la autenticación de tokens de Microsoft Entra ID para permitir la ejecución 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 solicita que introduzca su token de acceso personal de Azure Databricks o el token de Microsoft Entra ID (anteriormente Azure Active Directory) que se asigna al valor especificado de <workspace-url>:

✔ 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 .databrickscfg archivo 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 --profile comando. 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 obtener información sobre cómo establecer 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 auth comandos.