Gérer les partages pour OpenSharing

Cette page décrit comment afficher, mettre à jour et supprimer les partages OpenSharing existants dans Databricks. Un *partage* est un objet sécurisable dans Unity Catalog qui regroupe des tables, des vues, des volumes, des Notebooks, des modèles d’IA et d’autres assets de données pour les partager avec un ou plusieurs destinataires.

Pour créer un nouveau partage ou ajouter des assets de données à un partage existant, consultez Créer des partages pour OpenSharing. Pour accorder l'accès d'un destinataire à un partage, consultez Gérer l'accès aux partages de données OpenSharing (pour les fournisseurs). Pour gérer les destinataires de données avec lesquels vous partagez, consultez Gérer les destinataires de données pour OpenSharing.

Pour en savoir plus sur le modèle de partage, consultez Partages, fournisseurs et destinataires.

Exigences

Vérifiez que vous remplissez les exigences énumérées pour chaque tâche que vous souhaitez effectuer.

Tâche	Exigences
Accorder l'accès au destinataire à un partage	Soyez un administrateur de métastore. OU Soyez un utilisateur avec des autorisations déléguées ou la propriété sur les objets de partage et de destinataire, ce qui signifie que l'utilisateur doit remplir les deux exigences suivantes : Avoir à la fois les privilèges USE SHARE et SET SHARE PERMISSION OU être le propriétaire du partage Ayez le privilège USE RECIPIENT OU soyez le propriétaire du destinataire
Afficher les partages	Soyez un administrateur du métastore (peut tout afficher). OU Soyez un utilisateur disposant du privilège USE SHARE (peut tout afficher). OU Soyez le propriétaire de l'objet partagé.
Mettre à jour le propriétaire du partage	Soyez un administrateur de métastore.
Mettre à jour le nom du partage	Disposez du privilège CREATE SHARE. Soyez le propriétaire du partage.
Mettre à jour d'autres propriétés de partage	Soyez le propriétaire du partage.
Supprimer les partages	Soyez le propriétaire de l'objet partagé.

Tâche	Exigences
Accorder l'accès au destinataire à un partage	Soyez un administrateur de métastore. OU Soyez un utilisateur avec des autorisations déléguées ou la propriété sur les objets de partage et de destinataire, ce qui signifie que l'utilisateur doit remplir les deux exigences suivantes : Avoir à la fois les privilèges USE SHARE et SET SHARE PERMISSION OU être le propriétaire du partage Ayez le privilège USE RECIPIENT OU soyez le propriétaire du destinataire
Afficher les partages	Soyez un administrateur du métastore (peut tout afficher). OU Soyez un utilisateur disposant du privilège USE SHARE (peut tout afficher). OU Soyez le propriétaire de l'objet partagé.
Mettre à jour le propriétaire du partage	Soyez un administrateur de métastore.
Mettre à jour le nom du partage	Disposez du privilège CREATE SHARE. Soyez le propriétaire du partage.
Mettre à jour d'autres propriétés de partage	Soyez le propriétaire du partage.
Supprimer les partages	Soyez le propriétaire de l'objet partagé.

Afficher les partages et les détails du partage

Vérifiez que vous remplissez les conditions requises avant de consulter les partages et les détails des partages.

Pour afficher une liste de partages ou les détails d'un partage, utilisez Catalog Explorer, la CLI Databricks Unity Catalog, ou des commandes SQL dans un notebook Databricks ou l'éditeur de query Databricks SQL.

Les détails du partage comprennent les éléments suivants :

• Le propriétaire, le créateur, le Timestamp de création, le modificateur, le Timestamp de modification et les commentaires du partage.
• Assets de données dans le partage.
• Destinataires ayant accès au partage.

Catalog Explorer

1. Dans votre workspace Databricks, cliquez sur Catalogue .

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

   Alternativement, depuis la page Accès rapide , cliquez sur le bouton OpenSharing > .

3. Ouvrez l'onglet Partages pour afficher une liste de partages.

4. Affichez les détails de partage dans l'onglet tab .

SQL

Pour afficher la liste des partages, exécutez la commande suivante dans un Notebook ou l’éditeur de requête Databricks SQL. Vous pouvez éventuellement remplacer <pattern> par un LIKE prédicat.

SQL

SHOW SHARES [LIKE <pattern>];

Pour afficher les détails d'un partage spécifique, exécutez la commande suivante :

SQL

DESCRIBE SHARE <share-name>;

Pour afficher les détails sur toutes les tables, vues et volumes dans un partage, exécutez la commande suivante.

SQL

SHOW ALL IN SHARE <share-name>;

CLI

Pour afficher une liste de partages, exécutez la commande suivante à l'aide de la CLI Databricks.

Bash

databricks shares list

Pour afficher les détails d'un partage spécifique, exécutez la commande suivante :

Bash

databricks shares get <share-name>

Afficher les destinataires qui ont des autorisations sur un partage

Vérifiez que vous remplissez les exigences avant de consulter les destinataires.

Pour afficher la liste des partages auxquels un destinataire a eu accès, utilisez Catalog Explorer, le CLI Databricks Unity Catalog ou la commande SQL SHOW GRANTS TO RECIPIENT dans un notebook Databricks ou l'éditeur de query Databricks SQL.

Catalog Explorer

1. Dans votre workspace Databricks, cliquez sur Catalogue .

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

   Alternativement, depuis la page Accès rapide , cliquez sur le bouton OpenSharing > .

3. Sous l'onglet **Shared by me** tab, trouvez et sélectionnez le destinataire.

4. Allez à la tab Destinataires pour afficher la liste des destinataires qui peuvent accéder au partage.

SQL

Exécutez la commande suivante dans un Notebook ou l'éditeur de requêtes Databricks SQL.

SQL

SHOW GRANTS ON SHARE <share-name>;

CLI

Exécutez la commande suivante à l'aide de l'CLI Databricks.

Bash

databricks shares share-permissions <share-name>

Mettre à jour les partages

Vérifiez que vous remplissez les conditions requises avant d'effectuer des mises à jour sur un partage.

Vous pouvez mettre à jour un partage de les manières suivantes :

• Renommer un partage.
• Supprimer les tables, les vues, les volumes et les schémas d'un partage.
• Ajouter ou mettre à jour un commentaire sur un partage.
• Renommez l'alias d'une table (le nom de table affiché au destinataire).
• Activer ou désactiver l'accès aux données historiques d'une table, permettant aux destinataires d'effectuer des query time travel ou des lectures en streaming de la table.
• Ajouter, mettre à jour ou supprimer des définitions de partition.
• Modifier le propriétaire du partage.

Pour effectuer ces mises à jour des partages, utilisez Catalog Explorer, le CLI Databricks Unity Catalog, ou les commandes SQL dans un Notebook Databricks ou l'éditeur de query Databricks SQL. Cependant, vous ne pouvez pas utiliser Catalog Explorer pour renommer le partage.

Catalog Explorer

1. Dans votre workspace Databricks, cliquez sur Catalogue .

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

   Alternativement, depuis la page Accès rapide , cliquez sur le bouton OpenSharing > .

3. Dans l'onglet Partagé par moi , recherchez le partage que vous souhaitez actualiser et cliquez sur son nom.

Sur la page des détails du partage, effectuez les opérations suivantes :

• Cliquez sur l'icône de modification à côté du champ Propriétaire ou Commentaire pour mettre à jour ces valeurs.
• Cliquez sur le bouton de menu kebab dans une ligne d'asset pour le supprimer.
• Cliquez sur Gérer les assets > Modifier les assets pour mettre à jour toutes les autres propriétés :
  • Pour supprimer un asset, décochez la case à côté de l'asset.
  • Pour ajouter, mettre à jour ou supprimer des définitions de partition, cliquez sur Options avancées .

SQL

Exécutez les commandes suivantes dans un Notebook ou l'éditeur Databricks SQL.

Renommer un partage :

SQL

ALTER SHARE <share-name> RENAME TO <new-share-name>;

Supprimer des tables d'un partage :

SQL

ALTER SHARE share_name REMOVE TABLE <table-name>;

Supprimer des volumes d'un partage :

SQL

ALTER SHARE share_name REMOVE VOLUME <volume-name>;

Ajouter ou mettre à jour un commentaire sur un partage :

SQL

COMMENT ON SHARE <share-name> IS '<comment>';

Ajouter ou modifier des partitions pour une table partagée :

SQL

ALTER SHARE <share-name> ADD TABLE <table-name> PARTITION(<clause>);

Modifier le propriétaire du partage :

SQL

ALTER SHARE <share-name> OWNER TO  '<principal>'

-- Principal must be an account-level user email address or group name.

Activer le partage d'historique pour une table :

SQL

ALTER SHARE <share-name> ADD TABLE <table-name> WITH HISTORY;

Pour plus de détails sur les paramètres ALTER SHARE, voir ALTER SHARE.

CLI

Exécutez les commandes suivantes à l’aide de l’ CLI Databricks.

Renommer un partage :

Bash

databricks shares update <share-name> --name <new-share-name>

Supprimer des tables d'un partage :

Bash

databricks shares update <share-name> \
  --json '{
    "updates": [
      {
        "action": "REMOVE",
        "data_object": {
          "name": "<table-full-name>",
          "data_object_type": "TABLE",
          "shared_as": "<table-alias>"
        }
      }
    ]
  }'

Supprimer des volumes d'un partage (à l'aide de Databricks CLI 0.210 ou version ultérieure) :

Bash

databricks shares update <share-name> \
  --json '{
    "updates": [
      {
        "action": "REMOVE",
        "data_object": {
          "name": "<volume-full-name>",
          "data_object_type": "VOLUME",
          "string_shared_as": "<volume-alias>"
        }
      }
    ]
  }'

remarque

Utilisez la propriété name s'il n'y a pas d'alias pour le volume. Utilisez string_shared_as s'il existe un alias.

Ajouter ou mettre à jour un commentaire sur un partage :

Bash

databricks shares update <share-name> --comment '<comment>'

Modifier le propriétaire du partage :

Bash

databricks  shares update <share-name> --owner '<principal>'

Le principal doit être une adresse e-mail d'utilisateur de niveau compte ou un nom de groupe.

Considérations lors de la mise à jour du propriétaire du partage

Le propriétaire du partage influe sur la manière dont les fonctionnalités d'autorisation et de sécurité, telles que les politiques ABAC, sont évaluées. Le transfert de la propriété du partage à un utilisateur sur-privilégié permet aux destinataires d'avoir un accès sur-privilégié si vous avez une table ou un schéma sécurisé par des politiques ABAC.

Supprimer les partages

Lorsque vous supprimez un partage, les destinataires ne peuvent plus accéder aux données partagées. Vérifiez que vous remplissez les exigences avant de supprimer un objet de partage.

Pour supprimer un partage, utilisez Catalog Explorer, le Databricks Unity Catalog CLI, ou la commande DELETE SHARE SQL dans un Notebook Databricks ou l'éditeur de query Databricks SQL. Vous devez être propriétaire du partage.

Catalog Explorer

1. Dans votre workspace Databricks, cliquez sur Catalogue .

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

   Alternativement, depuis la page Accès rapide , cliquez sur le bouton OpenSharing > .

3. Dans l’onglet **Partagé par moi**, trouvez le partage que vous souhaitez supprimer et cliquez sur son nom.

4. Cliquez sur le menu kebab et sélectionnez Supprimer .

5. Dans la boîte de dialogue de confirmation, cliquez sur Supprimer .

SQL

Exécutez la commande suivante dans un Notebook ou l'éditeur de requêtes Databricks SQL.

SQL

DROP SHARE [IF EXISTS] <share-name>;

CLI

Exécutez la commande suivante à l'aide de l'CLI Databricks.

Bash

databricks shares delete <share-name>