Verwalten von Delta Sharing-Anbietern (für Datenempfänger)
In diesem Artikel wird beschrieben, wie Sie mithilfe von Unity Catalog Informationen zu Datenanbietern abrufen, die Daten mithilfe von Delta Sharing für Sie freigeben. Darüber hinaus erfahren Sie, was ein Anbieterobjekt ist und wann Sie möglicherweise ein Anbieterobjekt in Ihrem Unity Catalog-Metastore erstellen müssen. Dabei handelt es sich um eine Aufgabe, die die meisten Empfänger niemals ausführen müssen.
Wichtig
Datenempfänger müssen Zugriff auf einen Databricks-Arbeitsbereich haben, der für Unity Catalog aktiviert ist, um die in diesem Artikel beschriebene Funktionalität nutzen zu können. Dieser Artikel gilt nicht für Empfänger, die nicht über Unity Catalog-fähige Arbeitsbereiche verfügen.
Müssen Empfänger Anbieterobjekte erstellen?
Im Zusammenhang mit Delta Sharing in Databricks kann der Begriff „Anbieter“ sowohl die Organisation bezeichnen, die Daten für Sie freigibt, als auch ein sicherungsfähiges Objekt im Unity Catalog-Metastore eines Empfängers, das diese Organisation darstellt. Die Existenz dieses sicherungsfähigen Objekts im Unity Catalog-Metastore eines Empfängers ermöglicht es Empfängern, den Zugriff ihres Teams auf freigegebene Daten mithilfe von Unity Catalog zu verwalten.
Als Empfänger mit Zugriff auf einen Unity Catalog-Metastore müssen Sie in der Regel keine Anbieterobjekte erstellen. Dies liegt daran, dass Daten mithilfe der Databricks-zu-Databricks-Freigabefür Sie freigegeben werden sollten, und Anbieterobjekte werden automatisch in Ihrem Unity Catalog-Metastore erstellt.
Hinweis
Wenn Sie der seltene Empfänger bei Unity Catalog sind, der Daten von einem Anbieter empfängt, der diese nicht über einen Unity Catalog-fähigen Databricks-Arbeitsbereich freigibt, sollten Sie Anbieterobjekte in Unity Catalog erstellen, damit Sie diese freigegebenen Daten mithilfe von Unity Catalog verwalten können. Wenn Sie zu dieser Kategorie gehören, können Sie den REST-API-Aufruf POST /api/2.1/unity-catalog/providers oder die Databricks-CLI verwenden, um das Unity Catalog-Anbieterobjekt zu erstellen. Sie müssen ein Metastore-Administrator oder -Benutzer mit der Berechtigung CREATE_PROVIDER für den Metastore sein.
Voraussetzungen
So verwalten Sie Anbieter in Ihrem Azure Databricks-Arbeitsbereich:
- Ihr Arbeitsbereich muss für Unity Catalog aktiviert sein.
- Um einen Anbieter anzuzeigen, müssen Sie ein Metastore-Administrator sein, oder ein Metastore-Administrator muss Ihnen die
USE PROVIDER-Berechtigung gewähren. - Um einen Anbieter zu erstellen, müssen Sie ein Metastore-Administrator sein, oder ein Metastore-Administrator muss Ihnen die
CREATE PROVIDER-Berechtigung gewähren. - Um einen Anbieter zu aktualisieren, müssen Sie der Besitzer des Anbieterobjekts sein und über die
CREATE PROVIDER-Berechtigung verfügen. Weitere Informationen finden Sie unter Aktualisieren eines Anbieters (Umbenennen, Ändern des Besitzers, Kommentieren).
Aus diesem Grund muss ein Azure Databricks-Kontoadministrator einem Benutzer oder einer Gruppe die Metastore-Administratorrolle erteilen, bevor Sie mit Anbieterobjekten in Azure Databricks arbeiten können, wenn Ihr Arbeitsbereich ohne Metastore-Administrator erstellt wurde. Weitere Informationen finden Sie unter Automatische Aktivierung von Unity Catalog und (Optional) Zuweisen der Metastore-Administratorrolle.
Anzeigen von Anbietern
Um eine Liste der verfügbaren Datenanbieter anzuzeigen, können Sie den Katalog-Explorer, die Databricks Unity Catalog-Befehlszeilenschnittstelle oder den SQL-Befehl SHOW PROVIDERS in einem Azure Databricks-Notebook oder im Databricks SQL-Abfrage-Editor verwenden.
Erforderliche Berechtigungen: Sie müssen Metastore-Administrator sein oder die Berechtigung USE PROVIDER haben, um alle Anbieter im Metastore anzuzeigen. Andere Benutzer haben nur Zugriff auf die Anbieter, die sie besitzen.
Katalog-Explorer
Klicken Sie in Ihrem Azure Databricks-Arbeitsbereich auf
Katalog.Klicken Sie oben im Bereich Katalog auf das Zahnradsymbol
, und wählen Sie Delta Sharing aus.Klicken Sie alternativ auf der Seite Schnellzugriff auf die Schaltfläche Delta Sharing >.
Sehen Sie sich auf der Registerkarte Mit mir geteilt alle verfügbaren Anbieter an.
SQL
Führen Sie in einem Notebook oder im Databricks SQL-Abfrage-Editor den folgenden Befehl aus. Optional können Sie <pattern> durch ein LIKE-Prädikat ersetzen.
SHOW PROVIDERS [LIKE <pattern>];
BEFEHLSZEILENSCHNITTSTELLE (CLI)
Führen Sie über die Databricks-Befehlszeilenschnittstelle den folgenden Befehl aus:
databricks providers list
Anzeigen von Anbieterdetails
Um eine Liste der verfügbaren Datenanbieter anzuzeigen, können Sie den Katalog-Explorer, die Databricks Unity Catalog-Befehlszeilenschnittstelle oder den SQL-Befehl DESCRIBE PROVIDER in einem Azure Databricks-Notebook oder im Databricks SQL-Abfrage-Editor verwenden.
Erforderliche Berechtigungen: Metastore-Administrator, Benutzer mit der Berechtigung USE PROVIDER oder Besitzer des Anbieterobjekts.
Zu den Details gehören:
- Freigaben, die vom Anbieter freigegeben werden (siehe Anzeigen von Freigaben, die ein Anbieter für Sie freigegeben hat)
- Ersteller, Erstellungszeitstempel, Kommentare und Authentifizierungstyp des Anbieters (
TOKENoderDATABRICKS).TOKENstellt Anbieter dar, die mithilfe des Delta Sharing-Protokolls für offene Freigaben Daten für Sie freigegeben haben.DATABRICKSstellt Anbieter dar, die mithilfe des Databricks-zu-Databricks-Freigabeprotokolls Daten für Sie freigegeben haben. - Wenn der Anbieter die Databricks-zu-Databricks-Freigabe verwendet: die Cloud, Region und Metastore-ID des Unity Catalog-Metastores des Anbieters.
- Wenn der Anbieter die offene Freigabe verwendet: der Endpunkt des Empfängerprofils. Unter diesem wird der Delta Sharing-Freigabeserver gehostet.
Katalog-Explorer
Klicken Sie in Ihrem Azure Databricks-Arbeitsbereich auf
Katalog.Klicken Sie oben im Bereich Katalog auf das Zahnradsymbol
, und wählen Sie Delta Sharing aus.Klicken Sie alternativ auf der Seite Schnellzugriff auf die Schaltfläche Delta Sharing >.
Suchen Sie auf der Registerkarte Für mich freigegeben nach dem Anbieter, und wählen Sie ihn aus.
SQL
Führen Sie in einem Notebook oder im Databricks SQL-Abfrage-Editor den folgenden Befehl aus.
DESC PROVIDER <provider-name>;
BEFEHLSZEILENSCHNITTSTELLE (CLI)
Führen Sie über die Databricks-Befehlszeilenschnittstelle den folgenden Befehl aus:
databricks providers get <provider-name>
Anzeigen von Freigaben, die ein Anbieter für Sie freigegeben hat
Um die Freigaben anzuzeigen, die ein Anbieter für Sie freigegeben hat, können Sie den Katalog-Explorer, die Databricks Unity Catalog-Befehlszeilenschnittstelle oder den SQL-Befehl SHOW SHARES IN PROVIDER in einem Azure Databricks-Notebook oder im Databricks SQL-Abfrage-Editor verwenden.
Erforderliche Berechtigungen: Metastore-Administrator, Benutzer mit der Berechtigung USE PROVIDER oder Besitzer des Anbieterobjekts.
Katalog-Explorer
Klicken Sie in Ihrem Azure Databricks-Arbeitsbereich auf
Katalog.Klicken Sie oben im Bereich Katalog auf das Zahnradsymbol
, und wählen Sie Delta Sharing aus.Klicken Sie alternativ auf der Seite Schnellzugriff auf die Schaltfläche Delta Sharing >.
Suchen Sie auf der Registerkarte Für mich freigegeben nach dem Anbieter, und wählen Sie ihn aus.
SQL
Führen Sie in einem Notebook oder im Databricks SQL-Abfrage-Editor den folgenden Befehl aus. Optional können Sie <pattern> durch ein LIKE-Prädikat ersetzen.
SHOW SHARES IN PROVIDER [LIKE <pattern>];
BEFEHLSZEILENSCHNITTSTELLE (CLI)
Führen Sie über die Databricks-Befehlszeilenschnittstelle den folgenden Befehl aus:
databricks providers list-shares <provider-name>
Aktualisieren eines Anbieters (Umbenennen, Ändern des Besitzers, Kommentieren)
Sie können den Katalog-Explorer, die Databricks Unity Catalog-Befehlszeilenschnittstelle oder den SQL-Befehl ALTER PROVIDER in einem Azure Databricks-Notebook oder im Databricks SQL-Abfrage-Editor verwenden, um das Anbieterobjekt in Ihrem Unity Catalog-Metastore zu ändern:
- Benennen Sie den Anbieter um, um zu ändern, wie Benutzern das Anbieterobjekt in ihren Databricks-Schnittstellen angezeigt wird.
- Ändern Sie den Besitzer des Anbieterobjekts.
- Fügen Sie Kommentare hinzu, oder ändern Sie sie.
Erforderliche Berechtigungen: Sie müssen der Besitzer des Anbieterobjekts sein, um den Besitzer aktualisieren zu können. Zum Aktualisieren des Anbieternamens müssen Sie ein Metastore-Administrator (oder ein Benutzer mit der Berechtigung CREATE_PROVIDER) und der Anbieterbesitzer sein. Zum Aktualisieren des Kommentars müssen Sie der Besitzer sein. Der ursprüngliche Besitzer ist der Metastore-Administrator.
Katalog-Explorer
Klicken Sie in Ihrem Azure Databricks-Arbeitsbereich auf
Katalog.Klicken Sie oben im Bereich Katalog auf das Zahnradsymbol
, und wählen Sie Delta Sharing aus.Klicken Sie alternativ auf der Seite Schnellzugriff auf die Schaltfläche Delta Sharing >.
Suchen Sie auf der Registerkarte Für mich freigegeben nach dem Anbieter, und wählen Sie ihn aus.
Aktualisieren Sie auf der Detailseite den Besitzer, den Kommentar oder den Anbieternamen.
Um einen Anbieter umzubenennen, klicken Sie auf das Optionsmenü
, und wählen Sie Umbenennen aus.
SQL
Führen Sie in einem Notebook oder im Databricks SQL-Abfrage-Editor den folgenden Befehl aus.
ALTER PROVIDER <provider-name> RENAME TO <new-provider-name>
OWNER TO <new-owner>
COMMENT "<comment>";
BEFEHLSZEILENSCHNITTSTELLE (CLI)
Führen Sie über die Databricks-CLI den folgenden Befehl aus. Ersetzen Sie <provider-name> durch den aktuellen Anbieternamen und <new-provider-name> durch den neuen Namen.
databricks providers update <provider-name> /
--new-name <new-provider-name> /
--comment "<new comment>" /
--owner <new-owner-name>
Löschen eines Anbieters
Zum Löschen eines Anbieters können Sie den Katalog-Explorer, die Databricks Unity Catalog-Befehlszeilenschnittstelle oder den SQL-Befehl DROP PROVIDER in einem Azure Databricks-Notebook oder im Databricks SQL-Abfrage-Editor verwenden. Sie müssen der Besitzer des Anbieterobjekts sein, um den Anbieter löschen zu können.
Wenn Sie einen Anbieter löschen, können Sie und die Benutzer in Ihrer Organisation (der Empfänger) nicht mehr auf die vom Anbieter freigegebenen Daten zugreifen.
Erforderliche Berechtigungen: Berechtigung des Anbieterobjekts
Katalog-Explorer
Klicken Sie in Ihrem Azure Databricks-Arbeitsbereich auf
Katalog.Klicken Sie oben im Bereich Katalog auf das Zahnradsymbol
, und wählen Sie Delta Sharing aus.Klicken Sie alternativ auf der Seite Schnellzugriff auf die Schaltfläche Delta Sharing >.
Suchen Sie auf der Registerkarte Für mich freigegeben nach dem Anbieter, und wählen Sie ihn aus.
Wählen Sie das Kebab-Menü
und dann Löschen aus.Klicken Sie im Bestätigungsdialogfeld auf Löschen.
SQL
Führen Sie in einem Notebook oder im Databricks SQL-Abfrage-Editor den folgenden Befehl aus.
DROP PROVIDER [IF EXISTS] <provider-name>;
BEFEHLSZEILENSCHNITTSTELLE (CLI)
Führen Sie über die Databricks-Befehlszeilenschnittstelle den folgenden Befehl aus:
databricks providers delete <provider-name>
Wenn der Vorgang erfolgreich ist, werden keine Ergebnisse zurückgegeben.