Creación de destinatarios de datos para OpenSharing (uso compartido de Databricks a Databricks)

Esta página explica cómo crear destinatarios en OpenSharing, cuando los destinatarios están en un espacio de trabajo de Azure Databricks habilitado para Unity Catalog. Para ver, actualizar, eliminar, conceder acceso a recursos compartidos, administrar propiedades o restringir el acceso con listas IP para un destinatario existente, consulte Administración de destinatarios de datos para OpenSharing.

Un destinatario es el objeto con nombre que representa la identidad de un usuario o grupo de usuarios que consumen datos compartidos. La forma en que creas destinatarios varía dependiendo de si tu destinatario tiene acceso o no a un espacio de trabajo de Azure Databricks habilitado para Unity Catalog:

Para obtener más información sobre estos dos modos de uso compartido y cuándo elegir, consulte Uso compartido de Databricks a Open frente al uso compartido de Databricks a Databricks.

Requisitos

Para crear un destinatario:

  • Debe tener el CREATE RECIPIENT privilegio para el metastore del catálogo de Unity donde se registran los datos que desea compartir.
  • Es necesario crear el destinatario mediante un área de trabajo de Azure Databricks que tenga asociado ese metastore de Unity Catalog.
  • Si usa un cuaderno de Databricks para crear el destinatario, su computación debe usar Databricks Runtime 11.3 LTS o superior y el modo de acceso estándar o dedicado (anteriormente modos de acceso compartido y de usuario único).

Para obtener los permisos necesarios para otras operaciones de destinatarios (ver, actualizar, eliminar, conceder acceso a recursos compartidos, administrar propiedades), consulte Administración de destinatarios de datos para OpenSharing.

Crear un objeto de destinatario para los usuarios de Azure Databricks

Si tu destinatario de datos tiene acceso a un espacio de trabajo de Azure Databricks habilitado para Unity Catalog, puedes crear un objeto destinatario con un tipo de autenticación de DATABRICKS.

Un objeto de destinatario con un tipo de autenticación de DATABRICKS representa un receptor de datos en un metastore determinado del Catálogo de Unity, identificado en la definición del objeto destinatario por una cadena de identificador de uso compartido que consta de la nube, la región y el UUID del metastore. Solo se puede acceder a los datos compartidos con este destinatario en ese metastore.

Para crear un destinatario para compartir Databricks a Databricks, utiliza el Explorador de Catálogos, la CLI de Databricks o el CREATE RECIPIENT comando SQL en un cuaderno de Azure Databricks o el editor de consultas SQL de Databricks. Para crear un destinatario con la API REST, incluyendo un destinatario de correo electrónico, consulte Crear un destinatario en la referencia de la API REST.

Permisos requeridos: Administrador del metastore o usuario con el privilegio de CREATE RECIPIENT para el metastore de Unity Catalog donde están registrados los datos que quiere compartir.

Explorador de catálogos

  1. En el área de trabajo de Azure Databricks, haga clic en Data icon.Catalog.

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

    Como alternativa, en la esquina superior derecha, haga clic en Compartir > openSharing.

  3. En la pestaña Compartido por mí, haga clic en Nuevo destinatario.

  4. Elige cómo tu destinatario puede acceder a sus acciones:

    • Compartir usando correo electrónico (Beta): Esto envía un correo electrónico al destinatario, pidiéndole que inicie sesión en su cuenta de Azure Databricks y seleccione la metastore deseada. El destinatario debe iniciar sesión con una cuenta de Azure Databricks que utilice la dirección de correo electrónico invitada. Para más información y limitaciones, consulta compartición por correo electrónico.

      1. Escriba el nombre del destinatario.
      2. Escriba la dirección de correo electrónico del destinatario.
      3. Para configurar cómo se puede consumir este recurso, seleccione Cualquier cliente OpenSharing compatible o Limitar a destinatarios de Databricks. Cualquier cliente OpenSharing compatible permite que tu destinatario descargue un archivo de credenciales y acceda al recurso compartido en Azure Databricks.
      4. (Opcional) En Metastores permitidos (mediante ID de uso compartido), haz clic en Añadir metastore e introduce un identificador de uso compartido para limitar qué metastores de Azure Databricks pueden aceptar la invitación.

      Note

      Cuando añades un destinatario a un compartido, OpenSharing envía un enlace de activación seguro al destinatario y envía un correo nuevo cada vez que lo añades a otro compartido. Volver a compartir un elemento que el destinatario ya tiene no genera un correo electrónico duplicado. Consulte Administración del acceso a recursos compartidos de datos de OpenSharing (para proveedores).

    • Compartir mediante identificador de uso compartido: Debes solicitar e introducir el identificador de uso compartido del destinatario.

      1. Escriba el nombre del destinatario.

      2. En Tipo de destinatario, seleccione Databricks.

      3. Escriba el identificador de uso compartido del destinatario.

        Use toda la cadena de identificador de uso compartido con el formato <cloud>:<region>:<uuid>. Por ejemplo: aws:us-west-2:19a84bee-54bc-43a2-87de-023d0ec16016.

      4. (Opcional) Escriba un comentario.

  5. Haga clic en Crear.

  6. (Opcional) Cree propiedades de Destinatario personalizadas.

    En la pestaña Información general del destinatario, haga clic en el icono Editar icono de edición situado junto a Propiedades del destinatario. A continuación, agregue un nombre de propiedad (Clave) y un Valor. Para obtener más información, consulte Administrar las propiedades del destinatario.

SQL

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

CREATE RECIPIENT [IF NOT EXISTS] <recipient-name>
USING ID '<sharing-identifier>'
[COMMENT "<comment>"];

Use toda la cadena de identificador de uso compartido con el formato <cloud>:<region>:<uuid>. Por ejemplo: aws:eu-west-1:g0c979c8-3e68-4cdf-94af-d05c120ed1ef.

También es posible agregar propiedades personalizadas para el destinatario. Para obtener más información, consulte Administrar las propiedades del destinatario.

CLI

Ejecute el siguiente comando mediante la CLI de Databricks. Reemplace los valores de marcador de posición:

  • <recipient-name>: el nombre del destinatario.
  • <sharing-identifier>: La cadena completa del identificador de uso compartido en el formato <cloud>:<region>:<uuid>. Por ejemplo: aws:eu-west-1:g0c979c8-3e68-4cdf-94af-d05c120ed1ef.
  • <authentication-type>: se establece en DATABRICKS cuando se proporciona una cadena de identificador de uso compartido en el formato <cloud>:<region>:<uuid> para <sharing-identifier>.
databricks recipients create <recipient-name> <authentication-type> --sharing-code <sharing-identifier>

También es posible agregar propiedades personalizadas para el destinatario. Para obtener más información, consulte Administrar las propiedades del destinatario.

El destinatario se crea con el authentication_type de DATABRICKS.

Recursos adicionales

  • Last updated on