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.

Müssen Empfänger Anbieterobjekte erstellen?

In Delta Sharing on Databricks kann der Begriff "Provider" sowohl die Organisation bedeuten, die Daten für Sie freigibt, als auch ein sicherungsfähiges Objekt im Unity Catalog-Metastore eines Empfängers, der diese Organisation darstellt. Das Vorhandensein dieses sicherungsfähigen Objekts im Unity Catalog-Metastore eines Empfängers ermöglicht es Empfängern, den Zugriff ihres Teams auf freigegebene Daten mithilfe des Unity-Katalogs 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-Freigabe für Sie freigegeben werden sollten, und Anbieterobjekte werden automatisch in Ihrem Unity Catalog-Metastore erstellt.

Vorbereitung

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 Berechtigung: Sie müssen ein Metadatenspeicher-Administrator sein oder die USE PROVIDER-Berechtigung haben, um alle Anbieter im Metadatenspeicher anzuzeigen. Andere Benutzer haben nur Zugriff auf die Anbieter, die sie besitzen.

Catalog-Explorer

1. Klicken Sie im Azure Databricks-Arbeitsbereich auf das Katalog.

2. Klicken Sie oben im Bereich Katalog auf das Zahnradsymbol , und wählen Sie Delta Sharing aus.

   Wählen Sie alternativ auf der Seite Schnellzugriff die Schaltfläche Delta Sharing > aus.

3. Zeigen Sie auf der Registerkarte " Für mich freigegeben " alle Daten an, die für Ihre Organisation freigegeben wurden. Für jede Freigabe werden die folgenden Details bereitgestellt:

   • Name: Der Name der Organisation, wie vom Anbieter angegeben.
   • Authentifizierungstyp: Die vom Anbieter verwendete Freigabemethode.
   • Eigentümer: Der Name oder die E-Mail des Anbieters.
   • Erstellt unter: Das Datum und die Uhrzeit der Erstellung der Freigabe.
   • Beschreibung: Die Beschreibung der Freigabe.

SQL

Führen Sie in einem Notebook oder im Databricks SQL-Abfrage-Editor den folgenden Befehl aus. Optional ersetzen Sie <pattern> durch ein LIKE Prädikat.

SHOW PROVIDERS [LIKE <pattern>];

Weitere Informationen zu SHOW PROVIDERSfinden Sie unter SHOW PROVIDERS.

Befehlszeilenschnittstelle (CLI)

Führen Sie über die Databricks-CLI 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: Metadatenspeicher-Administrator, Benutzer mit der USE PROVIDER-Berechtigung oder der Anbieterobjektbesitzer.

Zu den Details gehören:

• Freigaben, die vom Anbieter freigegeben werden (siehe Anzeigen von Freigaben, die ein Anbieter für Sie freigegeben hat)
• Ersteller des Anbieters, Erstellungszeitstempel, Kommentare und Authentifizierungstyp (TOKEN oder DATABRICKS). TOKEN stellt Anbieter dar, die Daten mit Ihnen unter Verwendung des Delta Sharing offenen Freigabeprotokolls geteilt haben. DATABRICKS stellt Anbieter dar, die Daten mit Ihnen unter Verwendung des Databricks-zu-Databricks-Freigabeprotokolls geteilt haben.
• Wenn der Anbieter Databricks-zu-Databricks-Sharing verwendet: die Cloud, die Region und die Metastore-ID des Unity-Katalog-Metastores des Anbieters.
• Wenn der Anbieter die offene Freigabe verwendet: der Endpunkt des Empfängerprofils. Unter diesem wird der Delta Sharing-Freigabeserver gehostet.

Catalog-Explorer

1. Klicken Sie im Azure Databricks-Arbeitsbereich auf das Katalog.

2. Klicken Sie oben im Bereich Katalog auf das Zahnradsymbol , und wählen Sie Delta Sharing aus.

   Wählen Sie alternativ auf der Seite Schnellzugriff die Schaltfläche Delta Sharing > aus.

3. 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>;

Weitere Informationen zu DESC PROVIDERfinden Sie unter DESCRIBE PROVIDER.

Befehlszeilenschnittstelle (CLI)

Führen Sie über die Databricks-CLI den folgenden Befehl aus.

databricks providers get <provider-name>

Ansicht von Freigaben, die ein Anbieter mit Ihnen geteilt 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: Metadatenspeicher-Administrator, Benutzer mit der USE PROVIDER-Berechtigung oder der Anbieterobjektbesitzer.

Catalog-Explorer

1. Klicken Sie im Azure Databricks-Arbeitsbereich auf das Katalog.

2. Klicken Sie oben im Bereich Katalog auf das Zahnradsymbol , und wählen Sie Delta Sharing aus.

   Wählen Sie alternativ auf der Seite Schnellzugriff die Schaltfläche Delta Sharing > aus.

3. 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 ersetzen Sie <pattern> durch ein LIKE Prädikat.

SHOW SHARES IN PROVIDER [LIKE <pattern>];

Weitere Informationen zu SHOW SHARES IN PROVIDERfinden Sie unter SHOW SHARES IN PROVIDER.

Befehlszeilenschnittstelle (CLI)

Führen Sie über die Databricks-CLI den folgenden Befehl aus.

 databricks providers list-shares <provider-name>

Aktualisieren eines Anbieters (Umbenennen, Besitzer ändern, Kommentar)

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 Berechtigung: Sie müssen der Besitzer des Anbieterobjekts sein, um den Besitzer zu aktualisieren. 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.

Catalog-Explorer

1. Klicken Sie im Azure Databricks-Arbeitsbereich auf das Katalog.

2. Klicken Sie oben im Bereich Katalog auf das Zahnradsymbol , und wählen Sie Delta Sharing aus.

   Wählen Sie alternativ auf der Seite Schnellzugriff die Schaltfläche Delta Sharing > aus.

3. Suchen Sie auf der Registerkarte Für mich freigegeben nach dem Anbieter, und wählen Sie ihn aus.

4. Aktualisieren Sie auf der Detailseite den Besitzer, den Kommentar oder den Anbieternamen.

   Um einen Anbieter umzubenennen, klicken Sie auf das Kebab-Menü, 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>";

Weitere Informationen zu ALTER PROVIDERfinden Sie unter ALTER PROVIDER.

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 Berechtigung: Besitzer des Anbieterobjekts.

Catalog-Explorer

1. Klicken Sie im Azure Databricks-Arbeitsbereich auf das Katalog.

2. Klicken Sie oben im Bereich Katalog auf das Zahnradsymbol , und wählen Sie Delta Sharing aus.

   Wählen Sie alternativ auf der Seite Schnellzugriff die Schaltfläche Delta Sharing > aus.

3. Suchen Sie auf der Registerkarte Für mich freigegeben nach dem Anbieter, und wählen Sie ihn aus.

4. Klicken Sie auf das Kebab-Menü, und wählen Sie "Löschen" aus.

5. 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>;

Weitere Informationen zu DROP PROVIDERfinden Sie unter DROP PROVIDER.

Befehlszeilenschnittstelle (CLI)

Führen Sie über die Databricks-CLI den folgenden Befehl aus.

databricks providers delete <provider-name>

Wenn der Vorgang erfolgreich ist, werden keine Ergebnisse zurückgegeben.