Administración de proveedores de Delta Sharing (para destinatarios de datos)

Este artículo describe cómo usar Unity Catalog para obtener información sobre los proveedores de datos que comparten datos con usted usando Delta Sharing. También describe qué es un objeto de proveedor y cuándo podría necesitar crear un objeto de proveedor en su metastore de Unity Catalog, una tarea que la mayoría de los destinatarios nunca deberían tener que hacer.

Importante

Los destinatarios de los datos deben tener acceso a un área de trabajo de Databricks que esté habilitada para Unity Catalog para usar la funcionalidad descrita en este artículo. Este artículo no se aplica a los destinatarios que no tienen áreas de trabajo habilitadas para Unity Catalog.

¿Los destinatarios necesitan crear objetos de proveedor?

En Delta Sharing en Databricks, el término "proveedor" puede referirse tanto a la organización que comparte datos con usted como a un objeto protegible en el metastore de Unity Catalog de un destinatario que representa a esa organización. La existencia de ese objeto protegible en el metastore de Unity Catalog de un destinatario permite a los destinatarios administrar el acceso de su equipo a los datos compartidos usando Unity Catalog.

Como destinatario con acceso a un metastore de Unity Catalog, normalmente no es necesita crear objetos de proveedor. Esto se debe a que los datos se deben compartir con usted mediante uso compartido de Databricks-a-Databricks y los objetos de proveedor se crean automáticamente en el metastore de Unity Catalog.

Nota:

Si es el destinatario poco frecuente en Unity Catalog que recibe datos de un proveedor que no comparte desde un área de trabajo de Databricks habilitada para Unity Catalog, puede crear objetos de proveedor en Unity Catalog para administrar esos datos compartidos mediante Unity Catalog. Si está en esa categoría, puede usar la llamada API de REST POST /api/2.1/unity-catalog/providers o la CLI de Databricks para crear el objeto de proveedor de Unity Catalog. Debe ser administrador o usuario de metastore con el privilegio CREATE_PROVIDER para el metastore.

Visualización de proveedores

Para ver una lista de proveedores de datos disponibles, puede usar Catalog Explorer, la CLI de Unity Catalog de Databricks o el comando SQL SHOW PROVIDERS en un cuaderno de Azure Databricks o el editor de consultas de Databricks SQL.

Permisos necesarios: debe ser administrador de metastore o tener el privilegio USE PROVIDER de ver todos los proveedores en metastore. Otros usuarios solo tienen acceso a los proveedores que poseen.

Explorador de catálogos

1. En el área de trabajo de Azure Databricks, haga clic en el Catálogo.
2. En el panel izquierdo, expanda el menú Delta Sharing y seleccione Compartido conmigo.
3. En la pestaña Proveedores, vea todos los proveedores disponibles.

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 PROVIDERS [LIKE <pattern>];

Cli

Ejecute el siguiente comando mediante la CLI de Databricks.

databricks providers list

Ver detalles del proveedor

Para ver detalles sobre un proveedor, puede usar Catalog Explorer, la CLI de Unity Catalog de Databricks o el comando SQL DESCRIBE PROVIDER en un cuaderno de Azure Databricks o el editor de consultas de Databricks SQL.

Permisos necesarios: administrador de metastore, usuario con el privilegio USE PROVIDER o el propietario del objeto del proveedor.

Los detalles incluyen:

• Acciones compartidas por el proveedor (consulte Ver las acciones que un proveedor ha compartido con usted).
• El creador del proveedor, la marca de tiempo de creación, los comentarios y el tipo de autenticación (TOKEN o DATABRICKS). TOKEN representa a los proveedores que han compartido datos con usted mediante el protocolo de uso compartido abierto de Delta Sharing. DATABRICKS representa a los proveedores que han compartido datos con usted usando el protocolo de uso compartido de Databricks a Databricks.
• Si el proveedor usa el uso compartido de Databricks a Databricks: la nube, la región y el id. del metastore de Unity Catalog del proveedor.
• Si el proveedor utiliza el uso compartido abierto: el punto de conexión de su perfil de destinatario, que es el lugar donde se aloja el servidor de uso compartido de Delta Sharing.

Explorador de catálogos

1. En el área de trabajo de Azure Databricks, haga clic en el Catálogo.
2. En el panel izquierdo, expanda el menú Delta Sharing y seleccione Compartido conmigo.
3. En la pestaña Proveedores, busque y seleccione el proveedor.
4. Vea los detalles del proveedor en la pestaña Detalles.

Sql

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

DESC PROVIDER <provider-name>;

Cli

Ejecute el siguiente comando mediante la CLI de Databricks.

databricks providers get <provider-name>

Visualización de recursos compartidos que un proveedor ha compartido con usted

Para ver los recursos compartidos que un proveedor ha compartido con usted, puede usar Catalog Explorer, la CLI de Unity Catalog de Databricks o el comando SQL SHOW SHARES IN PROVIDER en un cuaderno de Azure Databricks o el editor de consultas de Databricks SQL.

Permisos necesarios: administrador de metastore, usuario con el privilegio USE PROVIDER o el propietario del objeto del proveedor.

Explorador de catálogos

1. En el área de trabajo de Azure Databricks, haga clic en el Catálogo.
2. En el panel izquierdo, expanda el menú Delta Sharing y seleccione Compartido conmigo.
3. En la pestaña Proveedores, seleccione el proveedor cuyos recursos compartidos quiere ver.

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 SHARES IN PROVIDER [LIKE <pattern>];

Cli

Ejecute el siguiente comando mediante la CLI de Databricks.

 databricks providers list-shares <provider-name>

Actualizar un proveedor (cambiar el nombre, cambiar propietario, comentar)

Puede usar Catalog Explorer, la CLI de Unity Catalog de Databricks o el comando SQL ALTER PROVIDER en un cuaderno Azure Databricks o el editor de consultas de Databricks SQL para modificar el objeto proveedor en su metastore de Unity Catalog:

• Cambie el nombre del proveedor para modificar la forma en que los usuarios consultan el objeto de proveedor en sus interfaces de Databricks.
• Cambie el propietario del objeto de proveedor.
• Añada o modifique comentarios.

Permisos necesarios: debe ser un administrador de metastore o propietario del objeto de proveedor para actualizar el propietario. Debe ser administrador del metastore (o usuario con el privilegio CREATE_PROVIDER) y propietario del proveedor para actualizar el nombre del proveedor. Debe ser el propietario para actualizar el comentario. El propietario inicial es el administrador del metastore.

Explorador de catálogos

1. En el área de trabajo de Azure Databricks, haga clic en el Catálogo.
2. En el panel izquierdo, expanda el menú Delta Sharing y seleccione Compartido con usted.
3. En la pestaña Proveedores, busque y seleccione el proveedor.
4. En la página de detalles, actualice el propietario, el comentario o el nombre del proveedor.

Sql

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

ALTER PROVIDER <provider-name> RENAME TO <new-provider-name>
OWNER TO <new-owner>
COMMENT "<comment>";

Cli

Ejecute el siguiente comando mediante la CLI de Databricks. Reemplace <provider-name> por el nombre del proveedor actual y <new-provider-name> por el nuevo nombre.

databricks providers update <provider-name> /
--new-name <new-provider-name> /
--comment "<new comment>" /
--owner <new-owner-name>

Eliminación de un proveedor

Para eliminar un proveedor, puede usar Catalog Explorer, la CLI de Unity Catalog de Databricks o el comando SQL DROP PROVIDER en un cuaderno de Azure Databricks o el editor de consultas de Databricks SQL. Debe ser el propietario del objeto de proveedor para eliminar el proveedor.

Al eliminar un proveedor, usted y los usuarios de su organización (el destinatario) ya no pueden acceder a los datos compartidos por el proveedor.

Permisos necesarios: propietario del objeto de proveedor.

Explorador de catálogos

1. En el área de trabajo de Azure Databricks, haga clic en el Catálogo.
2. En el panel izquierdo, expanda el menú Delta Sharing y seleccione Compartido con usted.
3. En la pestaña Proveedores, busque y seleccione el proveedor.
4. Haga clic en el menú kebab (también conocido como menú de tres puntos) 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 PROVIDER [IF EXISTS] <provider-name>;

Cli

Ejecute el siguiente comando mediante la CLI de Databricks.

databricks providers delete <provider-name>

Si la operación se realiza correctamente, no se devuelve ningún resultado.