Gérer les fournisseurs Delta Sharing (pour les destinataires de données)
Cet article explique comment utiliser Unity Catalog pour obtenir des informations sur les fournisseurs de données qui partagent des données avec vous à l’aide de Delta Sharing. Il décrit également ce qu’est un objet fournisseur et quand vous devrez peut-être créer un objet fournisseur dans votre metastore Unity Catalog, tâche que la plupart des destinataires ne doivent jamais avoir à effectuer.
Important
Les destinataires de données doivent avoir accès à un espace de travail Databricks activé pour qu’Unity Catalog utilise les fonctionnalités décrites dans cet article. Cet article ne s’applique pas aux destinataires qui ne disposent pas d’espaces de travail compatibles Unity Catalog.
Les destinataires doivent-ils créer des objets fournisseur ?
Dans Delta Sharing sur Databricks, le terme « fournisseur » peut désigner à la fois l’organisation qui partage des données avec vous et un objet sécurisable dans le metastore Unity Catalog d’un destinataire qui représente cette organisation. L’existence de cet objet sécurisable dans le metastore Unity Catalog d’un destinataire permet aux destinataires de gérer l’accès de leur équipe aux données partagées à l’aide de Unity Catalog.
En tant que destinataire ayant accès à un metastore Unity Catalog, vous n’avez généralement pas besoin de créer d’objets fournisseur. En effet, les données doivent être partagées avec vous via le partage Databricks-to-Databricks. Les objets fournisseur sont créés automatiquement dans votre metastore Unity Catalog.
Remarque
Si vous êtes l’un des rares destinataires sur Unity Catalog à recevoir des données d’un fournisseur qui ne les partage pas à partir d’un espace de travail Databricks compatible Unity Catalog, vous pouvez créer des objets fournisseur dans Unity Catalog pour pouvoir gérer les données partagées avec Unity Catalog. Si vous faites partie de cette catégorie, vous pouvez utiliser l’appel d’API REST POST /api/2.1/unity-catalog/providers ou l’interface CLI Databricks pour créer l’objet fournisseur Unity Catalog. Vous devez être administrateur ou utilisateur du metastore, et disposer du privilège CREATE_PROVIDER pour le metastore.
Avant de commencer
Pour gérer des fournisseurs dans votre espace de travail Azure Databricks :
- Vous devez activer votre espace de travail pour Unity Catalog.
- Pour voir un fournisseur, vous devez être administrateur de metastore ou un administrateur de metastore doit vous accorder le privilège
USE PROVIDER. - Pour créer un fournisseur, vous devez être administrateur de metastore ou un administrateur de metastore doit vous accorder le privilège
CREATE PROVIDER. - Pour mettre à jour un fournisseur, vous devez être le propriétaire de l’objet de fournisseur et disposer du privilège
CREATE PROVIDER. Pour plus d’informations, consultez Mettre à jour un fournisseur (renommer, changer le propriétaire, commenter).
Pour cette raison, si votre espace de travail a été créé sans administrateur de metastore, un administrateur de compte Azure Databricks doit accorder à un utilisateur ou un groupe le rôle d’administrateur de metastore pour vous permettre d’utiliser des objets de fournisseur dans Azure Databricks. Consultez Activation automatique de Unity Catalog et (Facultatif) Attribuer le rôle d’administrateur de metastore.
Afficher les fournisseurs
Pour consulter une liste des fournisseurs de données, vous pouvez utiliser Catalog Explorer, l’interface CLI de Databricks Unity Catalog ou la commande SQL SHOW PROVIDERS dans un notebook Azure Databricks ou dans l’éditeur de requête SQL Databricks.
Autorisations requises : Vous devez être administrateur de metastore ou avoir le privilège USE PROVIDER afin d’afficher tous les fournisseurs dans le metastore. Les autres utilisateurs n’ont accès qu’aux fournisseurs qu’ils possèdent.
Explorateur de catalogues
Dans votre espace de travail Azure Databricks, cliquez sur
Catalogue.En haut du volet Catalogue, cliquez sur l’icône d’engrenage
, puis sélectionnez Delta Sharing.Vous pouvez également, dans la page Accès rapide, cliquer sur le bouton Delta Sharing >.
Sous l’onglet Partagés avec moi, visualisez tous les fournisseurs disponibles.
SQL
Exécutez la commande suivante dans un notebook ou dans l’éditeur de requête SQL Databricks. Si vous le souhaitez, remplacez <pattern> par un prédicat LIKE.
SHOW PROVIDERS [LIKE <pattern>];
INTERFACE DE LIGNE DE COMMANDE
Exécutez la commande suivante dans l’interface CLI Databricks.
databricks providers list
Voir les détails du fournisseur
Pour consulter les détails d’un fournisseur, vous pouvez utiliser Catalog Explorer, l’interface CLI de Databricks Unity Catalog ou la commande SQL DESCRIBE PROVIDER dans un notebook Azure Databricks ou dans l’éditeur de requête SQL Databricks.
Autorisations requises : administrateur de metastore, utilisateur disposant du privilège USE PROVIDER ou propriétaire de l’objet fournisseur.
Les détails sont les suivants :
- Partages partagés par le fournisseur (consultez Afficher les partages qu’un fournisseur a partagés avec vous).
- Le créateur, le timestamp de création, les commentaires et le type d’authentification du fournisseur (
TOKENouDATABRICKS).TOKENreprésente les fournisseurs qui ont partagé des données avec vous à l’aide du protocole de partage ouvert Delta Sharing.DATABRICKSreprésente les fournisseurs qui ont partagé des données avec vous à l’aide du protocole de partage Databricks à Databricks. - Si le fournisseur utilise le partage Databricks à Databricks : le cloud, la région et l’ID de metastore du metastore Unity Catalog du fournisseur.
- Si le fournisseur utilise le partage ouvert : point de terminaison de votre profil de destinataire, qui est l’emplacement où le serveur de partage Delta Sharing est hébergé.
Explorateur de catalogues
Dans votre espace de travail Azure Databricks, cliquez sur
Catalogue.En haut du volet Catalogue, cliquez sur l’icône d’engrenage
, puis sélectionnez Delta Sharing.Vous pouvez également, dans la page Accès rapide, cliquer sur le bouton Delta Sharing >.
Sous l’onglet Partagés avec moi, recherchez et sélectionnez le fournisseur.
SQL
Exécutez la commande suivante dans un notebook ou dans l’éditeur de requête SQL Databricks.
DESC PROVIDER <provider-name>;
INTERFACE DE LIGNE DE COMMANDE
Exécutez la commande suivante dans l’interface CLI Databricks.
databricks providers get <provider-name>
Afficher les partages qu’un fournisseur a partagés avec vous
Pour consulter les partages qu’un fournisseur a effectués avec vous, vous pouvez utiliser Catalog Explorer, l’interface CLI de Databricks Unity Catalog ou la commande SQL SHOW SHARES IN PROVIDER dans un notebook Azure Databricks ou dans l’éditeur de requête SQL Databricks.
Autorisations requises : administrateur de metastore, utilisateur disposant du privilège USE PROVIDER ou propriétaire de l’objet fournisseur.
Explorateur de catalogues
Dans votre espace de travail Azure Databricks, cliquez sur
Catalogue.En haut du volet Catalogue, cliquez sur l’icône d’engrenage
, puis sélectionnez Delta Sharing.Vous pouvez également, dans la page Accès rapide, cliquer sur le bouton Delta Sharing >.
Sous l’onglet Partagés avec moi, recherchez et sélectionnez le fournisseur.
SQL
Exécutez la commande suivante dans un notebook ou dans l’éditeur de requête SQL Databricks. Si vous le souhaitez, remplacez <pattern> par un prédicat LIKE.
SHOW SHARES IN PROVIDER [LIKE <pattern>];
INTERFACE DE LIGNE DE COMMANDE
Exécutez la commande suivante dans l’interface CLI Databricks.
databricks providers list-shares <provider-name>
Mettre à jour un fournisseur (renommer, modifier le propriétaire, commenter)
Vous pouvez utiliser Catalog Explorer, l’interface CLI de Databricks Unity Catalog ou la commande SQL ALTER PROVIDER dans un notebook Azure Databricks ou dans l’éditeur de requêtes SQL Databricks pour modifier l’objet fournisseur dans votre metastore Unity Catalog :
- Renommez le fournisseur pour modifier la façon dont les utilisateurs voient l’objet fournisseur dans leurs interfaces Databricks.
- Modifiez le propriétaire de l’objet fournisseur.
- Ajoutez ou modifiez les commentaires.
Autorisations requises : vous devez être propriétaire de l’objet de fournisseur pour mettre à jour le propriétaire. Vous devez être un administrateur du metastore (ou utilisateur disposant du privilège CREATE_PROVIDER) et propriétaire fournisseur pour mettre à jour le nom du fournisseur. Vous devez être le propriétaire pour mettre à jour le commentaire. Le propriétaire initial est l’administrateur du metastore.
Explorateur de catalogues
Dans votre espace de travail Azure Databricks, cliquez sur
Catalogue.En haut du volet Catalogue, cliquez sur l’icône d’engrenage
, puis sélectionnez Delta Sharing.Vous pouvez également, dans la page Accès rapide, cliquer sur le bouton Delta Sharing >.
Sous l’onglet Partagés avec moi, recherchez et sélectionnez le fournisseur.
Dans la page de détails, mettez à jour le propriétaire, le commentaire ou le nom du fournisseur.
Pour renommer un fournisseur, cliquez sur le menu kebab
, puis sélectionnez Renommer.
SQL
Exécutez la commande suivante dans un notebook ou dans l’éditeur de requête SQL Databricks.
ALTER PROVIDER <provider-name> RENAME TO <new-provider-name>
OWNER TO <new-owner>
COMMENT "<comment>";
INTERFACE DE LIGNE DE COMMANDE
Exécutez la commande suivante dans l’interface CLI Databricks. Remplacez <provider-name> par le nom du fournisseur actuel et <new-provider-name> par le nouveau nom.
databricks providers update <provider-name> /
--new-name <new-provider-name> /
--comment "<new comment>" /
--owner <new-owner-name>
Supprimer un fournisseur
Pour supprimer un fournisseur, vous pouvez utiliser Catalog Explorer, l’interface CLI de Databricks Unity Catalog ou la commande SQL DROP PROVIDER dans un notebook Azure Databricks ou l’éditeur de requêtes SQL Databricks. Vous devez être le propriétaire de l’objet du fournisseur pour supprimer le fournisseur.
Lorsque vous supprimez un fournisseur, vous et les utilisateurs de votre organisation (le destinataire) ne pouvez plus accéder aux données partagées par le fournisseur.
Autorisations requises : propriétaire de l’objet fournisseur.
Explorateur de catalogues
Dans votre espace de travail Azure Databricks, cliquez sur
Catalogue.En haut du volet Catalogue, cliquez sur l’icône d’engrenage
, puis sélectionnez Delta Sharing.Vous pouvez également, dans la page Accès rapide, cliquer sur le bouton Delta Sharing >.
Sous l’onglet Partagés avec moi, recherchez et sélectionnez le fournisseur.
Cliquez sur le menu kebab
et 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 PROVIDER [IF EXISTS] <provider-name>;
INTERFACE DE LIGNE DE COMMANDE
Exécutez la commande suivante dans l’interface CLI Databricks.
databricks providers delete <provider-name>
Si l’opération réussit, aucun résultat n’est retourné.