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

Diese Seite erklärt, wie man Empfänger in OpenSharing erstellt, wenn sich die Empfänger auf einem Azure 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 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, variiert je nachdem, ob Ihr Empfänger Zugriff auf einen Azure Databricks-Arbeitsbereich hat, der für Unity Catalog aktiviert ist oder nicht:

  • Empfänger mit Zugang zu einem von Unity Catalog unterstützten Azure Databricks Arbeitsbereich:

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

  • Empfänger ohne Zugriff auf einen von Unity Catalog unterstützten Azure Databricks-Arbeitsbereich:

    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 Databricks-to-Open-Sharing-Empfängern finden Sie unter Open ID Connect (OIDC)-Föderation für OpenSharing-Empfänger aktivieren oder Ein Empfängerobjekt für Nicht-Databricks-Nutzer mit Trägertoken erstellen (Databricks-to-Open Sharing).

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 Sie ein Empfängerobjekt für Azure Databricks-Benutzer

Wenn Ihr Datenempfänger Zugriff auf einen Azure Databricks-Arbeitsbereich hat, der für Unity Catalog aktiviert wurde, können Sie ein Empfängerobjekt mit dem Authentifizierungstyp erstellenDATABRICKS.

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.

Um einen Empfänger für Databricks-zu-Databricks-Sharing zu erstellen, verwenden Sie den Catalog Explorer, die Databricks-CLI oder den CREATE RECIPIENT SQL-Befehl in einem Azure Databricks-Notizbuch oder den Databricks-SQL-Abfrageeditor. Um einen Empfänger mit der REST-API zu erstellen, einschließlich eines E-Mail-Empfängers, siehe Empfänger erstellen in der REST-API-Referenz.

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 Zahnrad-Symbol Zahnrad-Symbol, 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. Wählen Sie, wie Ihr Empfänger auf seine Anteile zugreifen kann:

    • Teilen per E-Mail (Beta): Dies sendet eine E-Mail an den Empfänger, die ihn auffordert, sich in seinem Azure Databricks-Konto anzumelden und den gewünschten Metastore auszuwählen. Der Empfänger muss sich mit einem Azure Databricks-Konto anmelden, das die eingeladene E-Mail-Adresse verwendet. Weitere Informationen und Einschränkungen finden Sie unter E-Mail-Teilen.

      1. Geben Sie den Namen des Empfängers ein.
      2. Geben Sie die E-Mail-Adresse des Empfängers ein.
      3. Wählen Sie für Konfigurieren, wie diese Freigabe genutzt werden kann entweder Jeden unterstützten OpenSharing-Client oder Auf Databricks-Empfänger beschränken. Jeder unterstützte OpenSharing-Client ermöglicht es Ihrem Empfänger, eine Anmeldeinformationsdatei herunterzuladen und auf die Freigabe in Azure Databricks zuzugreifen.
      4. (Optional) Unter Erlaubte Metastores (über Sharing ID) klicken Sie auf Metastore hinzufügen und geben Sie eine Share-Kennung ein, um zu begrenzen, welche Azure Databricks Metastores die Einladung annehmen können.

      Note

      Wenn du einen Empfänger zu einer Freigabe hinzufügst, schickt OpenSharing dem Empfänger eine E-Mail mit einem sicheren Aktivierungslink und sendet jedes Mal eine neue E-Mail, wenn du ihn zu einer anderen Freigabe hinzufügst. Das Erneun einer Anteilung, die ein Empfänger bereits hat, löst keine doppelte E-Mail aus. Siehe Verwalten des Zugriffs auf OpenSharing-Datenfreigaben (für Anbieter)

    • Über Freigabe-Kennung teilen: Du musst die Freigabe-Kennung des Empfängers anfordern und eingeben.

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

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

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

      4. (Optional) Geben Sie einen Kommentar ein.

  5. Klicken Sie auf "Erstellen".

  6. (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

  • Zuletzt aktualisiert um