Aller au contenu principal

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

Cette page explique comment créer des destinataires dans OpenSharing, lorsque les destinataires se trouvent sur un workspace 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 d'adresses 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 dont vous créez les destinataires diffère selon que votre destinataire ait ou non accès à un Workspace Databricks activé pour Unity Catalog:

Pour plus d'informations sur ces deux modes de partage et sur le moment de choisir chacun, consultez le partage Databricks vers Open par rapport au partage Databricks-to-Databricks.

Exigences

Pour créer un destinataire :

  • Vous devez disposer du privilège CREATE RECIPIENT pour le métastore Unity Catalog où les données que vous souhaitez partager sont enregistrées.
  • Vous devez créer le destinataire à l'aide d'un Workspace Databricks auquel ce métastore Unity Catalog est attaché.
  • Si vous utilisez un notebook Databricks pour créer le destinataire, votre compute doit utiliser Databricks Runtime 11.3 LTS ou une version ultérieure, et soit le mode d’accès standard, soit le mode d’accès dédié (précédemment modes d’accès partagé et mono-utilisateur).

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

Créer un objet destinataire pour les utilisateurs ayant accès à Databricks (partage Databricks-to-Databricks)

Si votre destinataire de données a accès à un workspace Databricks qui a été 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 DATABRICKS représente un destinataire de données sur un métastore Unity Catalog particulier, identifié dans la définition de l'objet destinataire par une chaîne d'identifiant de partage composée du cloud, de la région et de l'UUID du métastore. Les données partagées avec ce destinataire ne sont accessibles que sur ce metastore.

Étape 1 : Demander l'identifiant de partage du destinataire

Demandez à un utilisateur destinataire de vous envoyer l'identifiant de partage du metastore Unity Catalog qui est attaché aux Workspace où l'utilisateur destinataire ou le groupe d'utilisateurs travaillera avec les données partagées.

L'identifiant de partage est une chaîne de caractères composée du cloud, de la région et de l'UUID du metastore (l'identifiant unique du metastore), au format <cloud>:<region>:<uuid>.

Par exemple, dans la capture d'écran suivante, la chaîne complète de l'identifiant de partage est aws:us-west-2:19a84bee-54bc-43a2-87de-023d0ec16016.

exemple de CURRENT_METASTORE

Le destinataire peut trouver l'identifiant en utilisant l'Explorateur de catalogues, le CLI Databricks Unity Catalog, ou la fonction SQL par default CURRENT_METASTORE dans un Notebook Databricks ou une query Databricks SQL qui s'exécute sur un compute compatible Unity Catalog dans le Workspace qu'il compte utiliser.

Pour obtenir l'identifiant de partage à l'aide de l'Explorateur de catalogues :

  1. Dans votre workspace Databricks, cliquez sur Icône de données. Catalogue .

  2. En haut du volet Catalog , cliquez sur l'icône en forme d'engrenage Icône d&#39;engrenage. et sélectionnez OpenSharing .

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

  3. Dans l'onglet Shared with me , cliquez sur le nom de votre organisation de partage Databricks en haut à droite, puis sélectionnez Copier l'identifiant de partage .

Vous pouvez envoyer à votre destinataire les informations contenues dans cette étape, ou vous pouvez l'orienter vers Obtenir l'accès dans le modèle Databricks-to-Databricks.

Étape 2 : créez le destinataire

Pour créer un destinataire pour le partage Databricks-to-Databricks, vous pouvez utiliser Catalog Explorer, la CLI Databricks Unity Catalog, ou la commande SQL CREATE RECIPIENT dans un notebook Databricks ou l'éditeur de query Databricks SQL.

Autorisations requises : Administrateur de métastore ou utilisateur disposant du privilège CREATE RECIPIENT pour le métastore Unity Catalog où les données que vous souhaitez partager sont enregistrées.

  1. Dans votre workspace Databricks, cliquez sur Icône de données. Catalogue .

  2. En haut du volet Catalog , cliquez sur l'icône en forme d'engrenage Icône d&#39;engrenage. et sélectionnez OpenSharing .

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

  3. Dans l'onglet Shared by me , cliquez sur Nouveau destinataire .

  4. Saisissez le Nom du destinataire .

  5. Pour **Type de destinataire** : sélectionnez **Databricks**.

  6. Saisissez l'**identifiant de partage** du destinataire.

    Utilisez l'intégralité de la chaîne d'identifiant de partage au format <cloud>:<region>:<uuid>. Par exemple, aws:us-west-2:19a84bee-54bc-43a2-87de-023d0ec16016.

  7. (Facultatif) Saisissez un commentaire.

  8. Cliquez sur Créer .

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

    Dans la tab Aperçu du destinataire, cliquez sur l'icône de modification Icône de modification à côté de Propriétés du destinataire . Ajoutez ensuite un nom de propriété ( Clé ) et une Valeur . Pour plus de détails, consultez Gérer les propriétés du destinataire.

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

Ressources supplémentaires