Gérer les partages pour OpenSharing

Cette page explique comment afficher, mettre à jour et supprimer des partages OpenSharing existants dans Azure Databricks. Un partage est un objet sécurisable dans le catalogue Unity qui regroupe des tables, des vues, des volumes, des notebooks, des modèles IA et d’autres ressources de données pour le partage avec un ou plusieurs destinataires.

Pour créer un partage ou ajouter des ressources de données à un partage existant, consultez Créer des partages pour OpenSharing. Pour accorder à un destinataire l’accès à 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 que 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.

Requirements

Vérifiez que vous répondez aux exigences répertoriées pour chaque tâche que vous souhaitez terminer.

Tâche	Requirements
Accorder l’accès à un partage à un utilisateur	Être administrateur du metastore. OU Être un utilisateur disposant d’autorisations déléguées ou de propriété sur le partage et les objets 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 Avoir le privilège `USE RECIPIENT` OU être le propriétaire du destinataire
Voir les partages	Être un administrateur de Metastore (peut tout afficher). OR Être un utilisateur disposant du `USE SHARE` privilège (peut afficher tout). OR Être le propriétaire de l’objet de partage.
Mettre à jour le propriétaire du partage	Être un administrateur de metastore.
Mettre à jour le nom du partage	Vous avez le `CREATE SHARE` privilège. être le propriétaire du partage.
Mettre à jour d’autres propriétés de partage	être le propriétaire du partage.
Supprimer des partages	Être le propriétaire de l’objet de partage.

Affichage des partages et des informations associées

Vérifiez que vous répondez aux exigences avant d’afficher les partages et les détails du partage.

Pour afficher une liste de partages ou de détails sur un partage, utilisez l’Explorateur de catalogues, l’interface CLI de catalogue Databricks Unity ou les commandes SQL dans un notebook Azure Databricks ou l’éditeur de requête SQL Databricks.

Les détails du partage sont les suivants :

Propriétaire du partage, créateur, horodatage de création, auteur de la mise à jour, horodatage mis à jour et commentaires.
Ressources de données dans le partage.
Destinataires ayant accès au contenu partagé

Explorateur de catalogues

Dans votre espace de travail Azure Databricks, cliquez sur Catalogue.
En haut du volet Catalogue, cliquez sur l’, puis sélectionnez OpenSharing.

Sinon, depuis la page Accès rapide, cliquez sur le bouton OpenSharing >.
Ouvrez l’onglet Partages pour afficher la liste des partages.
Consultez le détail du partage dans l’onglet Détail.

SQL

Pour afficher la liste des partages, exécutez la commande suivante dans un notebook ou dans l’éditeur de requête Databricks SQL. Si vous le souhaitez, remplacez <pattern> par un prédicat LIKE.

SHOW SHARES [LIKE <pattern>];

Pour afficher le détail d’un partage spécifique, exécutez la commande suivante.

DESCRIBE SHARE <share-name>;

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

SHOW ALL IN SHARE <share-name>;

Interface de ligne de commande (CLI)

Pour afficher la liste des partages, exécutez la commande suivante à l’aide de l’interface CLI Databricks.

databricks shares list

Pour afficher le détail d’un partage spécifique, exécutez la commande suivante.

databricks shares get <share-name>

Affichage des destinataires disposant d’autorisations sur un partage

Vérifiez que vous répondez aux exigences avant d’afficher les destinataires.

Pour afficher la liste des partages auxquels un destinataire a été autorisé à accéder, utilisez l’Explorateur de catalogues, l’interface CLI du catalogue Databricks Unity ou la commande SHOW GRANTS TO RECIPIENT SQL dans un bloc-notes Azure Databricks ou l’éditeur de requête Databricks SQL.

Explorateur de catalogues

Dans votre espace de travail Azure Databricks, cliquez sur Catalogue.
En haut du volet Catalogue, cliquez sur l’, puis sélectionnez OpenSharing.

Vous pouvez également, depuis la page Accès rapide, cliquer sur le bouton OpenSharing >.
Sous l’onglet Partagé par moi, recherchez et sélectionnez le destinataire.
Accédez à l’onglet Destinataires pour afficher la liste des destinataires qui peuvent accéder au partage.

SQL

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

SHOW GRANTS ON SHARE <share-name>;

Interface de ligne de commande (CLI)

Exécutez la commande suivante dans l’interface CLI Databricks.

databricks shares share-permissions <share-name>

Mise à jour des partages

Vérifiez que vous répondez aux exigences avant d’effectuer des mises à jour d’un partage.

Vous pouvez mettre à jour un partage de la manière suivante :

Renommez un partage.
supprimer des tables, des vues, des volumes et des schémas d’un partage.
Ajoutez ou mettez à jour un commentaire sur un partage.
Renommez l’alias d’une table (le nom de la table affiché au destinataire).
Activez ou désactivez l’accès aux données d’historique d’une table, ce qui permet aux destinataires d’effectuer des requêtes de voyage dans le temps ou de diffuser en continu des lectures de la table.
Ajoutez, mettez à jour ou supprimez des définitions de partition.
Modifiez le propriétaire du partage.

Pour effectuer ces mises à jour pour les partages, utilisez l’Explorateur de catalogues, l’interface CLI de catalogue Databricks Unity ou les commandes SQL dans un notebook Azure Databricks ou l’éditeur de requête SQL Databricks. Toutefois, vous ne pouvez pas utiliser l’Explorateur de catalogue pour renommer le partage réseau.

Explorateur de catalogues

Dans votre espace de travail Azure Databricks, cliquez sur Catalogue.
En haut du volet Catalogue, cliquez sur l’, puis sélectionnez OpenSharing.

Vous pouvez également, depuis la page Accès rapide, cliquer sur le bouton OpenSharing >.
Sous l’onglet Partagé par moi, recherchez le partage que vous voulez mettre à jour, puis cliquez sur son nom.

Dans la page des détails du partage, effectuez les actions suivantes :

Cliquez sur l’icône Modifier située en regard du champ Propriétaire ou Commentaire pour mettre à jour ces valeurs.
Cliquez sur l’icône du menu Kebab dans la ligne d’une ressource pour la supprimer.
Cliquez sur Gérer les ressources > Modifier les ressources pour mettre à jour toutes les autres propriétés :
- Pour supprimer une ressource, décochez la case en regard de la ressource.
- Pour ajouter, mettre à jour ou supprimer des définitions de partition, cliquez sur Options avancées.

SQL

Exécutez la commande suivante dans un notebook ou dans l’éditeur Databricks SQL.

Renommez un partage :

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

Supprimez des tables d’un partage :

ALTER SHARE share_name REMOVE TABLE <table-name>;

Supprimer des volumes d’un partage :

ALTER SHARE share_name REMOVE VOLUME <volume-name>;

Ajoutez ou mettez à jour un commentaire sur un partage :

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

Ajoutez ou modifiez des partitions d’une table dans un partage :

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

Modifiez le propriétaire du partage :

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 :

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

Pour plus d’informations sur les paramètres ALTER SHARE, consultez ALTER SHARE.

Interface de ligne de commande (CLI)

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

Renommez un partage :

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

Supprimez des tables d’un partage :

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 l’interface CLI Databricks 0.210 ou ultérieure) :

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

Note

Utilisez la propriété name s’il n’existe aucun alias pour le volume. Utilisez string_shared_as s’il existe un alias.

Ajoutez ou mettez à jour un commentaire sur un partage :

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

Modifiez le propriétaire du partage :

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

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

Qui est le propriétaire du partage affecte la façon dont les fonctionnalités d’autorisation et de sécurité, telles que les stratégies ABAC, sont évaluées. Le transfert de propriété de partage vers un utilisateur sur-privilégié permet aux destinataires d’avoir un accès sur-privilégié si vous disposez d’une table ou d’un schéma sécurisé par des stratégies ABAC.

Supprimer des partages

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

Pour supprimer un partage, utilisez l’Explorateur catalogue, l’interface CLI du catalogue Databricks Unity ou la DELETE SHARE commande SQL dans un notebook Azure Databricks ou l’éditeur de requête Databricks SQL. Vous devez être un propriétaire du partage.

Explorateur de catalogues

Dans votre espace de travail Azure Databricks, cliquez sur Catalogue.
En haut du volet Catalogue, cliquez sur l’, puis sélectionnez OpenSharing.

Vous pouvez également, depuis la page Accès rapide, cliquer sur le bouton OpenSharing >.
Sous l’onglet Partagé par moi, recherchez le partage que vous voulez supprimer, puis cliquez sur son nom.
Cliquez sur , puis sélectionnez Supprimer.
Dans la boîte de dialogue de confirmation, cliquez sur Supprimer.

SQL

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

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

Interface de ligne de commande (CLI)

Exécutez la commande suivante dans l’interface CLI Databricks.

databricks shares delete <share-name>

Commentaires

Est-ce que cette page vous a été utile?

Last updated on 2026-06-24

Gérer les partages pour OpenSharing

Requirements

Affichage des partages et des informations associées

Explorateur de catalogues

SQL

Interface de ligne de commande (CLI)

Affichage des destinataires disposant d’autorisations sur un partage

Explorateur de catalogues

SQL

Interface de ligne de commande (CLI)

Mise à jour des partages

Explorateur de catalogues

SQL

Interface de ligne de commande (CLI)

Considérations relatives à la mise à jour du propriétaire du partage

Supprimer des partages

Explorateur de catalogues

SQL

Interface de ligne de commande (CLI)

Commentaires

Ressources supplémentaires