Configurar la autorización para la extensión del IDE Databricks

Este artículo describe cómo configurar la autorización y autenticación entre la extensión del IDE de Databricks y tu espacio de trabajo de Azure Databricks si aún no has configurado la extensión a través de la configuración del proyecto. Consulta la extensión del IDE Databricks.

La extensión IDE de Databricks implementa partes del estándar unificado de autenticación Databricks, que permite configurar una autorización basada en Azure Databricks OAuth 2.0 una vez y luego usar esa configuración en múltiples herramientas y SDKs de Azure Databricks sin más cambios en la configuración de autorización y autenticación. También proporciona actualizaciones automáticas de tokens de acceso activos, lo que reduce la complejidad del proceso al desarrollar.

Databricks recomienda la autorización de usuario interactiva OAuth, que es fácil de configurar usando la extensión del IDE de Databricks. Consulte Configuración de la autorización y autenticación de OAuth.

De lo contrario, si usa Autenticar Azure Databricks con tokens de acceso personal (heredado), Autorizar el acceso a Azure Databricks con OAuth o Autenticar con las principales entidades de servicio de Microsoft Entra, consulte Configurar la autenticación con un perfil de configuración. Para autenticarse con el CLI de Azure, consulte Configurar la autenticación del CLI de Azure.

Configuración de la autenticación y la autorización de OAuth

Azure Databricks admite la autenticación y autorización basada en OAuth 2.0 y simplifica la administración de tokens de acceso con Databricks unified authentication. Para obtener más información sobre la autorización de usuario y entidad de servicio con Azure Databricks, consulte Authorize access to Azure Databricks resources.

Para completar la configuración de la autorización OAuth, abre tu proyecto VSCode con la extensión IDE Databricks activada:

1. En la vista Configuración, haga clic en Tipo de autenticación y, a continuación, haga clic en el icono de engranaje (Inicio de sesión en el área de trabajo de Databricks).

   

2. Si ya tiene un perfil de configuración de autenticación en la lista que tiene la etiqueta Autenticar con OAuth (usuario a equipo) y que sabe que corresponde al host de Databricks de destino, selecciónelo en la lista y haga lo siguiente:

   1. Si se le solicita, complete las instrucciones en pantalla del explorador web para terminar de autenticarse con Azure Databricks.
   2. Si también se le solicita, permita el acceso a todas las API.
   3. Vaya directamente a Seleccionar computación para ejecutar código y tareas.

3. En Paleta de comandos, para Seleccionar método de autenticación, haga clic en OAuth (usuario a máquina).

4. Para Seleccionar método de autenticación, seleccione OAuth (usuario a máquina).

5. Escriba algún nombre para el perfil de autenticación de Azure Databricks asociado.

6. En la vista Configuración, haga clic en Iniciar sesión en Databricks.

   

7. En Paleta de comandos, para Seleccionar método de autenticación, seleccione el nombre del perfil de configuración de autenticación que acaba de crear.

8. Si se le solicita, complete las instrucciones en pantalla del explorador web para terminar de autenticarse con Azure Databricks. Si también se le solicita, permita el acceso a todas las API.

9. Una vez que haya iniciado sesión correctamente, vuelva a Visual Studio Code.

Configurar la autenticación con un perfil de configuración

En las instrucciones siguientes se supone que ya ha configurado un perfil de configuración de Azure Databricks con los campos necesarios para el tipo de autenticación de Azure Databricks. Para crear un perfil, consulte los perfiles de configuración de Azure Databricks. Para configurar las opciones del perfil, consulte la pestaña Profile o la sección del tipo de autenticación en Authorize access to Azure Databricks resources.

Para seleccionar el perfil de configuración que desea que use la extensión, con el proyecto y la extensión abierta, haga lo siguiente:

1. En la vista Configuración, haga clic en Tipo de autenticación y, a continuación, haga clic en el icono de engranaje (Inicio de sesión en el área de trabajo de Databricks).

   

2. En el Paleta de comandos, seleccione el perfil de configuración de destino Azure Databricks en la lista.

   Sugerencia

   El host del área de trabajo de destino se puede cambiar más adelante modificando la configuración de workspace de destino en el archivo de configuración databricks.yml asociado al proyecto. Consulte destinos.

Si no tiene un perfil de configuración, puede crear uno que se autentique mediante un token de acceso personal de Azure Databricks por ejemplo, como se indica a continuación:

1. Con el proyecto y la extensión abiertas, en la vista Configuración, haga clic en Tipo de autenticación o Inicio de sesión en Databricks y, a continuación, haga clic en el engranaje (Inicio de sesión en el área de trabajo de Databricks).

   

2. En la Paleta de comandos, seleccione Token de acceso personal.

3. Complete las indicaciones en pantalla para hacer lo siguiente:

   1. Escriba algún nombre para el perfil de autenticación de Azure Databricks asociado.
   2. Genere el token de acceso personal en el área de trabajo de Azure Databricks y, a continuación, copie el valor del token.
   3. Vuelva a la extensión y escriba el valor del token copiado.

La extensión crea una carpeta en el proyecto denominado .databricks con un archivo denominado databricks.env, si aún no existe. Este archivo contiene el host del espacio de trabajo que introduciste, junto con otros detalles de configuración de Azure Databricks usados por la extensión IDE de Databricks.

La extensión también agrega un archivo .gitignore oculto al proyecto si el archivo no existe o si no se encuentra un .gitignore existente en ninguna carpeta primaria. Si se crea un nuevo archivo .gitignore, la extensión agrega una entrada .databricks/ a este nuevo archivo. Si la extensión encuentra un archivo .gitignore existente, agrega una entrada .databricks/ al archivo existente.

Configurar la autenticación del CLI de Azure

Azure Databricks admite la autenticación con el CLI de Azure instalado localmente. Esto le permite generar tokens de corta vigencia (una hora) de Microsoft Entra ID, lo que elimina el riesgo de exponer accidentalmente tokens de larga vigencia, como los tokens de acceso personal de Azure Databricks, a través de integraciones en control de versiones u otros medios.

Con el proyecto y la extensión abierta, y el CLI de Azure instalado localmente, haga lo siguiente:

1. En la vista Configuración, haga clic en Configurar Databricks.

   Nota

   Si Configurar Databricks no está visible, haga clic en el icono de engranaje (Configurar área de trabajo) junto a Configuración en su lugar.

   

2. En la Paleta de comandos, para Host de Databricks, introduzca su URL de área de trabajo individual, por ejemplo https://adb-1234567890123456.7.azuredatabricks.net. A continuación, presione Entrar.

3. Seleccione CLI de Azure.