Créer des destinataires de données pour OpenSharing (partage Databricks-to-Databricks).

Cette page explique comment créer des destinataires dans OpenSharing, lorsque les destinataires sont sur un espace de travail Azure Databricks activé pour Unity Catalog. Pour afficher, mettre à jour, supprimer, accorder l’accès au partage, gérer les propriétés ou restreindre l’accès avec des listes IP pour un destinataire existant, consultez Gérer les destinataires de données pour OpenSharing.

Un destinataire est l’objet nommé qui représente l’identité d’un utilisateur ou d’un groupe d’utilisateurs qui consomment des données partagées. La manière de créer des destinataires varie selon que votre destinataire a ou non accès à un espace de travail Azure Databricks activé pour Unity Catalog :

Pour plus d’informations sur ces deux modes de partage et dans quels cas choisir l’un ou l’autre, consultez la section Partage Databricks vers Open ou partage Databricks vers Databricks.

Exigences

Pour créer un destinataire :

  • Vous devez disposer du privilège CREATE RECIPIENT pour le metastore Unity Catalog où les données que vous souhaitez partager sont enregistrées.
  • Vous devez créer le destinataire à l’aide d’un espace de travail Azure Databricks dont le metastore Unity Catalog est attaché.
  • Si vous utilisez un notebook Databricks pour créer le destinataire, votre calcul doit utiliser Databricks Runtime 11.3 LTS ou version ultérieure, et soit le mode d’accès standard ou dédié (anciennement les modes d’accès partagé et mono-utilisateur).

Pour obtenir les autorisations requises pour d’autres opérations de destinataire (affichage, mise à jour, suppression, octroi d’accès au partage, gestion des propriétés), consultez Gérer les destinataires des données pour OpenSharing.

Créer un objet destinataire pour les utilisateurs Azure Databricks

Si votre destinataire de données a accès à un espace de travail Azure Databricks activé pour Unity Catalog, vous pouvez créer un objet destinataire avec un type d’authentification de DATABRICKS.

Un objet destinataire avec le type d'authentification de DATABRICKS représente un destinataire de données sur un metastore particulier de Unity Catalog, identifié dans la définition de l'objet destinataire par une chaîne d’identification de partage sharing identifier composée du cloud, de la région et de l’UUID du metastore. Les données partagées avec ce destinataire ne sont accessibles que sur ce metastore.

Pour créer un destinataire pour le partage Databricks-à-Databricks, utilisez l’Explorateur de catalogue, la ligne de contrôle de Databricks, ou la CREATE RECIPIENT commande SQL dans un notebook Azure Databricks ou l’éditeur de requêtes SQL de Databricks. Pour créer un destinataire avec l’API REST, y compris un destinataire par email, voir Créer un destinataire dans la référence de l’API REST.

Autorisations requises : administrateur de metastore ou utilisateur disposant du CREATE RECIPIENT privilège pour le metastore du catalogue Unity où les données que vous souhaitez partager sont inscrites.

Explorateur de catalogues

  1. Dans votre espace de travail Azure Databricks, cliquez sur l’icône Données.Catalogue.

  2. En haut du volet Catalogue, cliquez sur l’icône d’engrenage, puis sélectionnez OpenSharing.

    Sinon, dans le coin supérieur droit, cliquez sur Partager openSharing>.

  3. Sous l’onglet Partagé par moi, cliquez sur Nouveau destinataire.

  4. Choisissez comment votre destinataire peut accéder à ses parts :

    • Partager par email (Bêta) : Cela envoie un e-mail au destinataire, l’invitant à se connecter à son compte Azure Databricks et à sélectionner le métastore souhaité. Le destinataire doit se connecter avec un compte Azure Databricks utilisant l’adresse e-mail invitée. Pour plus d’informations et de limitations, voir partage par email.

      1. Entrez le nom du destinataire.
      2. Entrez l’adresse e-mail du destinataire.
      3. Pour configurer comment ce partage peut être consommé, sélectionnez Tout client OpenSharing supporté ou Limiter aux destinataires Databricks. Tout client OpenSharing pris en charge permet à votre destinataire de télécharger un fichier d’identifiants et d’accéder au partage sur Azure Databricks.
      4. (Optionnel) Dans Métastores autorisés (via l’ID de partage), cliquez sur Ajouter un métastore et saisissez un identifiant de partage pour limiter quels métastores Azure Databricks peuvent accepter l’invitation.

      Note

      Lorsque vous ajoutez un destinataire à un partage, OpenSharing envoie un lien d’activation sécurisé au destinataire, et envoie un nouvel e-mail à chaque fois que vous l’ajoutez à un autre partage. Réattribuer un partage qu’un destinataire possède déjà ne déclenche pas un double email. Consultez Gérer l’accès aux partages de données OpenSharing (pour les fournisseurs).

    • Partager en utilisant l’identifiant de partage : Vous devez demander et entrer l’identifiant de partage du destinataire.

      1. Entrez le nom du destinataire.

      2. Pour Type de destinataire, sélectionnez Databricks.

      3. Entrez l’identificateur de partage du destinataire.

        Utilisez la chaîne d’identificateur de partage entière au format <cloud>:<region>:<uuid>. Par exemple : aws:us-west-2:19a84bee-54bc-43a2-87de-023d0ec16016.

      4. (Facultatif) Entrez un commentaire.

  5. Cliquez sur Créer.

  6. (Facultatif) Créez des propriétés de destinataire personnalisées.

    Sous l’onglet Vue d’ensemble du destinataire, cliquez sur l'icône de modification en regard des propriétés du destinataire. Ajoutez ensuite un nom de propriété (Clé) et une Valeur. Pour plus d’informations, consultez Gérer les propriétés du destinataire.

SQL

Exécutez la commande suivante dans un notebook ou dans l’éditeur de requête Databricks SQL :

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

Utilisez la chaîne d’identificateur de partage entière au format <cloud>:<region>:<uuid>. Par exemple : aws:eu-west-1:g0c979c8-3e68-4cdf-94af-d05c120ed1ef.

Vous pouvez également ajouter des propriétés personnalisées pour le destinataire. Pour plus d’informations, consultez Gérer les propriétés du destinataire.

Interface de ligne de commande (CLI)

Exécutez la commande suivante dans l’interface CLI Databricks. Remplacez les valeurs d’espace réservé :

  • <recipient-name> : nom du destinataire.
  • <sharing-identifier>: chaîne d’identificateur de partage entière au format <cloud>:<region>:<uuid>. Par exemple : aws:eu-west-1:g0c979c8-3e68-4cdf-94af-d05c120ed1ef.
  • <authentication-type>: défini sur DATABRICKS lorsqu’une chaîne d’identificateur de partage est fournie au format <cloud>:<region>:<uuid> pour <sharing-identifier>.
databricks recipients create <recipient-name> <authentication-type> --sharing-code <sharing-identifier>

Vous pouvez également ajouter des propriétés personnalisées pour le destinataire. Pour plus d’informations, consultez Gérer les propriétés du destinataire.

Le destinataire est créé avec le authentication_type de DATABRICKS.

Ressources supplémentaires

  • Dernière mise à jour :