Erstellen von Datenempfängern für OpenSharing (Databricks-to-Databricks-Freigabe)

Auf dieser Seite wird erläutert, wie Sie Empfänger in OpenSharing erstellen, wenn sich die Empfänger in einem Databricks-Arbeitsbereich befinden, der für Unity-Katalog 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 OpenSharing.

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:

Weitere Informationen zu diesen beiden Freigabemodi und dazu, wann welcher Modus gewählt werden sollte, finden Sie unter Databricks-to-Open-Freigabe im Vergleich zu Databricks-to-Databricks-Freigabe.

Requirements

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, der mit einem Unity-Katalog-Metastore verbunden 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 OpenSharing.

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.

Beispiel für CURRENT_METASTORE

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

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

    Alternativ klicken Sie oben rechts auf Teilen > OpenSharing.

  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();

CLI

Führen Sie über die Databricks-CLI 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 Datensymbol.Katalog.

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

    Alternativ klicken Sie oben rechts auf Teilen > OpenSharing.

  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 iconEdit iconEmpfängereigenschaften auf das . Fügen Sie dann einen Eigenschaftsnamen (Key) und einen Wert hinzu. Ausführliche Informationen 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. Ausführliche Informationen finden Sie unter "Verwalten von Empfängereigenschaften".

CLI

Führen Sie über die Databricks-CLI 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. Ausführliche Informationen finden Sie unter "Verwalten von Empfängereigenschaften".

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

Weitere Ressourcen

  • Last updated on