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

Den här sidan förklarar hur man skapar mottagare i OpenSharing när mottagarna befinner sig på en Azure 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. Sättet du skapar mottagare på skiljer sig beroende på om din mottagare har tillgång till en Azure Databricks-arbetsyta som är aktiverad för Unity Catalog eller inte:

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 Azure Databricks-användare

Om din datamottagare har tillgång till en Azure 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.

För att skapa en mottagare för Databricks-till-Databricks-delning, använd Catalog Explorer, Databricks CLI eller SQL-kommandot CREATE RECIPIENT i en Azure Databricks-notebook eller Databricks SQL-frågeredigerare. För att skapa en mottagare med REST API:et, inklusive en e-postmottagare, se Skapa en mottagare i REST API-referensen.

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. Välj hur din mottagare kan komma åt sina aktier:

    • Dela med e-post (Beta): Detta skickar ett mejl till mottagaren och uppmanar dem att logga in på sitt Azure Databricks-konto och välja önskad metastore. Mottagaren måste logga in med ett Azure Databricks-konto som använder den inbjudna e-postadressen. För mer information och begränsningar, se e-postdelning.

      1. Ange mottagarnamn.
      2. Ange mottagarens e-postadress.
      3. För Konfigurera hur den här delningen kan användas, välj Valfri OpenSharing-klient som stöds eller Begränsa till Databricks-mottagare. Alla stödda OpenSharing-klienter låter din mottagare ladda ner en legitimationsfil och komma åt delningen på Azure Databricks.
      4. (Valfritt) Under Tillåtna metastores (via delnings-ID), klicka på Lägg till metastore och ange en delningsidentifierare för att begränsa vilka Azure Databricks metastores som kan acceptera inbjudan.

      Anmärkning

      När du lägger till en mottagare i en delning, mejlar OpenSharing mottagaren en säker aktiveringslänk och skickar ett nytt mejl varje gång du lägger till dem i en annan delning. Att återbevilja en andel som en mottagare redan har utlöser inte ett duplicert mejl. Se Hantera åtkomst till OpenSharing-dataresurser (för leverantörer).

    • Dela med delningsidentifierare: Du behöver be om och ange mottagarens delningsidentifierare.

      1. Ange mottagarnamn.

      2. För Mottagartypväljer du Databricks.

      3. Ange mottagarens delningsidentifieraren.

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

      4. (Valfritt) Ange en kommentar.

  5. Klicka på Skapa.

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

  • Uppdaterades senast