Skapa datamottagare för OpenSharing (Databricks-till-Databricks-delning)

Den här sidan förklarar hur du skapar mottagare i OpenSharing när mottagarna finns på en Databricks-arbetsyta som är aktiverad för Unity Catalog. Information om hur du visar, uppdaterar, tar bort, beviljar resursåtkomst, hanterar egenskaper eller begränsar åtkomst med IP-listor för en befintlig mottagare finns i Hantera datamottagare för OpenSharing.

En mottagare är det namngivna objektet som representerar identiteten för en användare eller grupp av användare som använder delade data. Hur du skapar mottagare varierar beroende på om mottagaren har åtkomst till en Databricks-arbetsyta som är aktiverad för Unity Catalog:

Mer information om dessa två delningslägen och när du ska välja vilka finns i Databricks-to-Open-delning jämfört med Databricks-till-Databricks-delning.

Krav

Så här skapar du en mottagare:

  • Du måste ha behörigheten CREATE RECIPIENT för Unity Catalog-metaarkivet där de data du vill dela är registrerade.
  • Du måste skapa mottagaren med hjälp av en Azure Databricks-arbetsyta som har Unity Catalog-metaarkivet anslutet.
  • Om du använder en Databricks-notebook-fil för att skapa mottagaren måste din beräkning använda Databricks Runtime 11.3 LTS eller senare och antingen standard- eller dedikerat åtkomstläge (tidigare delade och enstaka användaråtkomstlägen).

Behörigheter som krävs för andra mottagaråtgärder (visa, uppdatera, ta bort, bevilja resursåtkomst, hantera egenskaper) finns i Hantera datamottagare för OpenSharing.

Skapa ett mottagarobjekt för användare som har åtkomst till Databricks (Databricks-till-Databricks-delning)

Om datamottagaren har åtkomst till en Databricks-arbetsyta som har aktiverats för Unity Catalog kan du skapa ett mottagarobjekt med autentiseringstypen DATABRICKS.

Ett mottagarobjekt med autentiseringstypen DATABRICKS representerar en datamottagare i ett visst Unity Catalog-metaarkiv, som identifieras i mottagarobjektdefinitionen av en delningsidentifierarsträng som består av metaarkivets moln, region och UUID. Data som delas med den här mottagaren kan endast nås i det metaarkivet.

Steg 1: Begär mottagarens delningsidentifierare

Be en mottagaranvändare att skicka delningsidentifieraren för Unity Catalog-metaarkivet som är kopplat till arbetsytorna där mottagaranvändaren eller gruppen av användare arbetar med delade data.

Delningsidentifieraren är en sträng som består av metaarkivets moln, region och UUID (den unika identifieraren för metaarkivet) i formatet <cloud>:<region>:<uuid>.

I följande skärmbild är aws:us-west-2:19a84bee-54bc-43a2-87de-023d0ec16016till exempel den fullständiga delningsidentifierarsträngen .

exempel på CURRENT_METASTORE

Mottagaren kan hitta identifieraren med hjälp av Catalog Explorer, Databricks Unity Catalog CLI eller sql-standardfunktionen CURRENT_METASTORE i en Databricks-notebook- eller Databricks SQL-fråga som körs på en Unity-Catalog-kompatibel beräkning på arbetsytan som de tänker använda.

Katalogutforskaren

Så här hämtar du delningsidentifieraren med Hjälp av Catalog Explorer:

  1. På din Azure Databricks-arbetsyta klickar du på dataikonen.Katalog.

  2. Längst upp i fönstret Katalog klickar du på kugghjulsikonen. kugghjulsikonen och väljer OpenSharing.

    Du kan också klicka på Dela > OpenSharing i det övre högra hörnet.

  3. På fliken Delat med mig klickar du på namnet på din Databricks-delningsorganisation i det övre högra hörnet och väljer Kopiera delningsidentifierare.

SQL

Kör följande kommando i en notebook-fil eller Databricks SQL-frågeredigeraren:

SELECT CURRENT_METASTORE();

CLI

Kör följande kommando med hjälp av Databricks CLI. Delningsidentifieraren returneras som global_metastore_id.

databricks metastores summary

Du kan skicka informationen till mottagaren i det här steget, eller så kan du peka dem till Få åtkomst i Databricks-till-Databricks-modellen.

Steg 2: Skapa mottagaren

Om du vill skapa en mottagare för Databricks-till-Databricks-delning kan du använda Catalog Explorer, Databricks Unity Catalog CLI eller CREATE RECIPIENT SQL-kommandot i en Azure Databricks-notebook-fil eller Databricks SQL-frågeredigeraren.

Behörigheter som krävs: Metaarkivadministratör eller användare med CREATE RECIPIENT behörighet för Unity Catalog-metaarkivet där de data som du vill dela är registrerade.

Katalogutforskaren

  1. På din Azure Databricks-arbetsyta klickar du på dataikonen.Katalog.

  2. Längst upp i fönstret Katalog klickar du på kugghjulsikonen. kugghjulsikonen och väljer OpenSharing.

    Du kan också klicka på Dela > OpenSharing i det övre högra hörnet.

  3. På fliken Delat av mig klickar du på Ny mottagare.

  4. Ange mottagarnamn.

  5. För Mottagartypväljer du Databricks.

  6. Ange mottagarens delningsidentifieraren.

    Använd hela delningsidentifierarsträngen i formatet <cloud>:<region>:<uuid>. Till exempel aws:us-west-2:19a84bee-54bc-43a2-87de-023d0ec16016.

  7. (Valfritt) Ange en kommentar.

  8. Klicka på Skapa.

  9. (Valfritt) Skapa anpassade egenskaper för mottagare.

    På fliken Översikt, klicka på redigeringsikonen bredvid Egenskaper för mottagare. Lägg sedan till ett egenskapsnamn (nyckel) och värde. Mer information finns i Hantera mottagaregenskaper.

SQL

Kör följande kommando i en notebook-fil eller Databricks SQL-frågeredigeraren:

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

Använd hela delningsidentifierarsträngen i formatet <cloud>:<region>:<uuid>. Till exempel aws:eu-west-1:g0c979c8-3e68-4cdf-94af-d05c120ed1ef.

Du kan också lägga till anpassade egenskaper för mottagaren. Mer information finns i Hantera mottagaregenskaper.

CLI

Kör följande kommando med hjälp av Databricks CLI. Ersätt platshållarvärdena:

  • <recipient-name>: Mottagarens namn.
  • <sharing-identifier>: Hela delningsidentifierarsträngen i formatet <cloud>:<region>:<uuid>. Till exempel aws:eu-west-1:g0c979c8-3e68-4cdf-94af-d05c120ed1ef.
  • <authentication-type>: Ange till DATABRICKS när en delningsidentifierarsträng i formatet <cloud>:<region>:<uuid> anges för <sharing-identifier>.
databricks recipients create <recipient-name> <authentication-type> --sharing-code <sharing-identifier>

Du kan också lägga till anpassade egenskaper för mottagaren. Mer information finns i Hantera mottagaregenskaper.

Mottagaren skapas med authentication_type av DATABRICKS.

Ytterligare resurser

  • Last updated on