Administrar conexiones para la federación de Lakehouse

Importante

Esta característica está en versión preliminar pública.

En este artículo se describe cómo enumerar todas las conexiones de federación de Lakehouse definidas en un metastore de Unity Catalog, obtener detalles de conexión, conceder permisos de conexión y quitar conexiones mediante Catalog Explorer e instrucciones SQL en cuadernos o el editor de consultas de Databricks SQL. Una conexión es un objeto protegible en Unity Catalog que especifica una ruta de acceso y credenciales para acceder a un sistema de base de datos externo.

Consulte también Crear una conexión.

Si prefiere usar la API REST, consulte la documentación de referencia de Azure Databricks.

Enumerar conexiones

Permisos necesarios: la lista de conexiones devueltas depende de su rol y permisos. Los usuarios con el privilegio USE CONNECTION en el metastore ven todas las conexiones. De lo contrario, solo podrá ver las conexiones de las que sea propietario del objeto de conexión o sobre las que tenga algún privilegio.

Explorador de catálogo

1. En el área de trabajo de Azure Databricks, haga clic en Catálogo.

2. En la parte superior del panel Catálogo, haga clic en el icono del engranaje y seleccione Conexiones en el menú.

   Como alternativa, en la página Acceso rápido, haga clic en el botón Datos externos > y vaya a la pestaña Conexiones.

   Se enumeran las conexiones a las que tiene permiso para ver, junto con la dirección URL, la fecha de creación, el propietario y el comentario.

SQL

Ejecute el siguiente comando en un cuaderno o en el editor de consultas de Databricks SQL. Opcionalmente, reemplace <pattern> por un predicado LIKE.

SHOW CONNECTIONS [LIKE <pattern>];

Obtener detalles de la conexión

Permisos necesarios: propietario de la conexión, privilegios USE CONNECTION en el metastore o algún privilegio en la conexión.

Explorador de catálogo

1. En el área de trabajo de Azure Databricks, haga clic en Catálogo.

2. En la parte superior del panel Catálogo, haga clic en el icono del engranaje y seleccione Conexiones en el menú.

   Como alternativa, en la página Acceso rápido, haga clic en el botón Datos externos > y vaya a la pestaña Conexiones.

3. Busque la conexión y selecciónela para ver los detalles.

SQL

Ejecute el siguiente comando en un cuaderno o en el editor de consultas de Databricks SQL.

DESCRIBE CONNECTION <connection-name>;

Conceder y revocar permisos en conexiones

Puede conceder permiso para usar una conexión para crear catálogos externos o para ver detalles sobre una conexión:

• CREATE FOREIGN CATALOG concede la capacidad de crear un catálogo externo como reflejo de solo lectura de una base de datos en el origen de datos descrito por la conexión.
• USE CONNECTION concede la capacidad de usar la conexión en Delta Live Tables para ingerir datos del origen de datos en Azure Databricks. Sin embargo, si se concede en el nivel de metastore, solo permite ver los detalles de las conexiones en el metastore. Todavía se debe conceder USE CONNECTION a los usuarios en conexiones individuales para usarlas.

Permisos necesarios: administrador del metastore o propietario de la conexión.

Explorador de catálogo

Para conceder permiso para usar una conexión:

1. En el área de trabajo de Azure Databricks, haga clic en Catálogo.

2. En la parte superior del panel Catálogo, haga clic en el icono del engranaje y seleccione Conexiones en el menú.

   Como alternativa, en la página Acceso rápido, haga clic en el botón Datos externos > y vaya a la pestaña Conexiones.

3. Busque la conexión y selecciónela.

4. En la pestaña Permisos, haga clic en Conceder.

5. En el cuadro de diálogo Conceder en <connection-name>, empiece a escribir el nombre del usuario o grupo o haga clic en el menú de usuario para examinar y seleccionar usuarios y grupos.

6. Seleccione los privilegios que desea conceder.

   Consulte las descripciones de privilegios en la sección Introducción.

7. Haga clic en Conceder.

Para revocar un privilegio de conexión:

1. Siga los pasos anteriores para ir a la pestaña Permisos de la conexión.
2. Seleccione el usuario o grupo cuyos privilegios desea revocar.
3. Haga clic en Revocar en la pestaña y en el cuadro de diálogo de confirmación.

SQL

Para conceder la capacidad de crear un catálogo externo mediante una conexión, ejecute el siguiente comando en un cuaderno o en el editor de consultas de Databricks SQL.

GRANT CREATE FOREIGN CATALOG ON CONNECTION <connection-name> TO <user-name>;

Para conceder la capacidad de ver la conexión, ejecute lo siguiente:

GRANT USE CONNECTION ON CONNECTION <connection-name> TO <user-name>;

Para revocar un privilegio, ejecute lo siguiente, donde <privilege> es uno de los privilegios de la conexión concedida al usuario:

REVOKE <privilege> ON CONNECTION <connection-name> FROM <user-name>;

Quitar conexiones

Permisos necesarios: propietario de la conexión

Explorador de catálogo

1. En el área de trabajo de Azure Databricks, haga clic en Catálogo.

2. En la parte superior del panel Catálogo, haga clic en el icono del engranaje y seleccione Conexiones en el menú.

   Como alternativa, en la página Acceso rápido, haga clic en el botón Datos externos > y vaya a la pestaña Conexiones.

3. Busque la conexión y selecciónela.

4. Haga clic en el menú de kebab y seleccione Eliminar.

5. En el cuadro de diálogo de confirmación, haga clic en Eliminar.

SQL

Ejecute el siguiente comando en un cuaderno o en el editor de consultas de Databricks SQL.

DROP CONNECTION [IF EXISTS] <connection-name>;