Datenempfänger für Delta Sharing erstellen (Databricks-zu-Databricks-Freigabe)

Auf dieser Seite wird beschrieben, wie Sie Empfänger in Delta Sharing erstellen, wenn sich die Empfänger in einem Databricks-Arbeitsbereich befinden, der für Unity Catalog aktiviert ist. Informationen zum Anzeigen, Aktualisieren, Löschen, Gewähren des Freigabezugriffs, Verwalten von Eigenschaften oder Einschränken des Zugriffs mit IP-Listen für einen vorhandenen Empfänger finden Sie unter Verwalten von Datenempfängern für die Delta-Freigabe.

Ein Empfänger ist das benannte Objekt, das die Identität eines Benutzers oder einer Gruppe von Benutzern darstellt, die freigegebene Daten nutzen. Die Art und Weise, wie Sie Empfänger erstellen, unterscheidet sich je nachdem, ob Ihr Empfänger Zugriff auf einen Databricks-Arbeitsbereich hat, der für den Unity-Katalog aktiviert ist:

• Empfänger mit Zugriff auf einen Unity Catalog-fähigen Databricks-Arbeitsbereich:

  Sie können ein Empfängerobjekt mit einer sicheren Verbindung erstellen, die von Databricks verwaltet wird. Dieser Freigabemodus wird als Databricks-zu-Databricks-Freigabe bezeichnet und auf dieser Seite beschrieben.

• Empfänger ohne Zugriff auf einen Databricks-Arbeitsbereich mit aktiviertem Unity-Katalog:

  Sie müssen die offene Freigabe mit einer sicheren Verbindung verwenden, die Sie mithilfe der tokenbasierten Authentifizierung verwalten (entweder Bearertoken oder OAuth-Verbund). Informationen zum Erstellen von Empfängern für offene Freigabe finden Sie unter Aktivieren der OpenID Connect (OIDC)-Föderation für Delta-Sharing-Empfänger und Erstellen eines Empfängerobjekts für Nicht-Databricks-Benutzer mithilfe von Bearer-Token (offene Freigabe).

Weitere Informationen zu diesen beiden Freigabemodi und dazu, wann welcher Modus verwendet werden muss, finden Sie in der Gegenüberstellung von offener Freigabe und Databricks-zu-Databricks-Freigabe.

Anforderungen

So erstellen Sie einen Empfänger

• Sie müssen über die CREATE RECIPIENT Berechtigung für den Unity-Katalog-Metaspeicher verfügen, in dem die Daten, die Sie freigeben möchten, registriert sind.
• Sie müssen den Empfänger mithilfe eines Azure Databricks-Arbeitsbereichs erstellen, in dem der Unity Catalog-Metastore angefügt ist.
• Wenn Sie ein Databricks-Notizbuch verwenden, um den Empfänger zu erstellen, muss Ihr Rechner Databricks Runtime 11.3 LTS oder höher sowie entweder den Standard- oder den dedizierten Zugriffsmodus (vormals freigegebene und Einzelbenutzer-Zugriffsmodi) verwenden.

Informationen zu Berechtigungen, die für andere Empfängervorgänge erforderlich sind (Anzeigen, Aktualisieren, Löschen, Gewähren des Freigabezugriffs, Verwalten von Eigenschaften), finden Sie unter Verwalten von Datenempfängern für die Delta-Freigabe.

Erstellen eines Empfängerobjekts für Benutzende mit Zugriff auf Databricks (Databricks-zu-Databricks-Freigabe)

Wenn Ihr Datenempfänger Zugriff auf einen Databricks-Arbeitsbereich mit Unity Catalog-Unterstützung hat, können Sie ein Empfängerobjekt mit dem Authentifizierungstyp DATABRICKS erstellen.

Ein Empfängerobjekt mit dem Authentifizierungstyp DATABRICKS repräsentiert einen Datenempfänger in einem bestimmten Unity Catalog-Metastore, der in der Definition des Empfängerobjekts durch ein Freigabekennzeichen identifiziert wird, bestehend aus der Cloud, der Region und der UUID des Metastores. Auf die für diesen Empfänger freigegebenen Daten kann nur in diesem Metastore zugegriffen werden.

Schritt 1: Freigabe-Bezeichner des Empfängers anfordern

Bitten Sie einen Empfängerbenutzer, Ihnen den Freigabebezeichner für den Unity Catalog-Metastore zu senden, der an die Arbeitsbereiche angefügt ist, in denen der Empfängerbenutzer oder die Empfängerbenutzergruppe mit den freigegebenen Daten arbeitet.

Der Freigabebezeichner ist eine Zeichenfolge, die aus der Cloud, Region und UUID des Metastores (dem eindeutigen Bezeichner für den Metastore) im Format <cloud>:<region>:<uuid>besteht.

Im folgenden Screenshot ist der vollständige Freigabebezeichner beispielsweise die Zeichenfolge aws:us-west-2:19a84bee-54bc-43a2-87de-023d0ec16016.

Der Empfänger kann den Bezeichner mithilfe des Katalog-Explorers, der Databricks Unity Catalog CLI oder der Sql-Standardfunktion CURRENT_METASTORE in einem Databricks-Notizbuch oder einer SQL-Abfrage von Databricks finden, die auf einer Unity-Catalog-fähigen Berechnung im Arbeitsbereich ausgeführt wird, den sie verwenden möchten.

Katalog-Explorer

So rufen Sie den Freigabebezeichner mithilfe des Katalog-Explorers ab

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.

   Klicken Sie alternativ in der oberen rechten Ecke auf Delta Sharing>.

3. Wählen Sie rechts oben auf der Registerkarte Für mich freigegeben den Namen der Organisation für die Databricks-Freigabe und dann Freigabebezeichner kopieren aus.

SQL

Führen Sie in einem Notebook oder im Databricks SQL-Abfrage-Editor den folgenden Befehl aus:

SELECT CURRENT_METASTORE();

Befehlszeilenschnittstelle (CLI)

Führen Sie über die Databricks-Befehlszeilenschnittstelle den folgenden Befehl aus. Der Freigabebezeichner wird als global_metastore_id zurückgegeben.

databricks metastores summary

Sie können die in diesem Schritt enthaltenen Informationen an die empfangende Person senden. Alternativ können Sie auf den Abschnitt Erhalten von Zugriff im Databricks-zu-Databricks-Modell verweisen.

Schritt 2: Erstellen des Empfängers

Sie können den Katalog-Explorer, die Databricks Unity Catalog-Befehlszeilenschnittstelle oder den SQL-Befehl CREATE RECIPIENT in einem Azure Databricks-Notebook oder im Databricks SQL-Abfrage-Editor verwenden, um einen Empfänger für die Databricks-zu-Databricks-Freigabe zu erstellen.

Erforderliche Berechtigungen: Sie müssen ein Metastore-Administrator oder ein Benutzer mit der Berechtigung CREATE RECIPIENT für den Unity Catalog-Metastore sein, in dem die freizugebenden Daten registriert sind.

Katalog-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.

   Klicken Sie alternativ in der oberen rechten Ecke auf Delta Sharing>.

3. Klicken Sie auf der Registerkarte Von mir freigegeben auf Neuer Empfänger.

4. Geben Sie den Namen des Empfängers ein.

5. Wählen Sie für "Empfängertyp" "Databricks" aus.

6. Geben Sie die Freigabe-ID des Empfängers ein.

   Verwenden Sie die gesamte Zeichenfolge des Freigabebezeichners im Format <cloud>:<region>:<uuid>. Beispiel: aws:us-west-2:19a84bee-54bc-43a2-87de-023d0ec16016.

7. (Optional) Geben Sie einen Kommentar ein.

8. Klicken Sie auf Erstellen.

9. (Optional) Erstellen Sie benutzerdefinierte Empfängereigenschaften.

   Klicken Sie auf der Registerkarte Empfängerübersicht neben den Edit iconEmpfängereigenschaften auf das . Fügen Sie dann einen Eigenschaftsnamen (Schlüssel) und einen Wert hinzu. Details finden Sie unter Verwalten von Empfängereigenschaften.

SQL

Führen Sie in einem Notebook oder im Databricks SQL-Abfrage-Editor den folgenden Befehl aus:

CREATE RECIPIENT [IF NOT EXISTS] <recipient-name>
USING ID '<sharing-identifier>'
[COMMENT "<comment>"];

Verwenden Sie die gesamte Zeichenfolge des Freigabebezeichners im Format <cloud>:<region>:<uuid>. Beispiel: aws:eu-west-1:g0c979c8-3e68-4cdf-94af-d05c120ed1ef.

Sie können auch benutzerdefinierte Eigenschaften für den Empfänger hinzufügen. Details finden Sie unter Verwalten von Empfängereigenschaften.

Befehlszeilenschnittstelle (CLI)

Führen Sie über die Databricks-Befehlszeilenschnittstelle den folgenden Befehl aus. Ersetzen Sie folgende Platzhalterwerte:

• <recipient-name>: Name des Empfängers
• <sharing-identifier>: die gesamte Zeichenfolge des Freigabebezeichners im Format <cloud>:<region>:<uuid> Beispiel: aws:eu-west-1:g0c979c8-3e68-4cdf-94af-d05c120ed1ef.
• <authentication-type>: wird auf DATABRICKS festgelegt, wenn eine Zeichenfolge für den Freigabebezeichner im Format <cloud>:<region>:<uuid> für <sharing-identifier> bereitgestellt wird

databricks recipients create <recipient-name> <authentication-type> --sharing-code <sharing-identifier>

Sie können auch benutzerdefinierte Eigenschaften für den Empfänger hinzufügen. Details finden Sie unter Verwalten von Empfängereigenschaften.

Der Empfänger wird mit dem folgenden Authentifizierungstyp (authentication_type) erstellt: DATABRICKS.

Nächste Schritte

• Verwalten des Zugriffs auf Delta Sharing-Datenfreigaben (für Anbieter) – Gewähren Sie dem Empfänger Zugriff auf eine oder mehrere Freigaben.
• Verwalten von Datenempfängern für die Delta-Freigabe – Anzeigen, Aktualisieren, Löschen, Verwalten von Eigenschaften oder Einschränken des Zugriffs für einen vorhandenen Empfänger.
• Erstellen Sie Freigaben für die Delta-Freigabe – Erstellen Sie die Freigaben, auf die Sie dem Empfänger Zugriff gewähren möchten.