Skapa och hantera andelar för Delta Sharing

På den här sidan beskrivs hur du skapar och hanterar andelar för Delta Sharing.

En resurs är ett skyddsbart objekt i Unity Catalog som du använder för att dela följande datatillgångar med en eller flera mottagare:

• Tabeller och tabellpartitioner
• Strömmande tabeller
• Hanterade Iceberg-tabeller
• Externa scheman och tabeller
• Vyer, inklusive dynamiska vyer som begränsar åtkomsten på rad- och kolumnnivå
• Materialiserade vyer
• Volumes
• Notebooks
• AI-modeller

Om du delar ett helt schema (databas) kan mottagaren komma åt alla tabeller, strömmande tabeller, vyer, materialiserade vyer, modeller och volymer i schemat när du delar det, tillsammans med alla data och AI-tillgångar som läggs till i schemat i framtiden.

En resurs kan innehålla data och AI-tillgångar från endast ett Unity Catalog-metaarkiv. Du kan lägga till eller ta bort data och AI-tillgångar från en resurs när som helst.

Innan du skapar en delning, se till att du har konfigurerat deltadelning för ditt konto (för leverantörer).

Mer information om delningsmodellen finns i Resurser, leverantörer och mottagare.

Requirements

Se till att du uppfyller de angivna kraven för varje uppgift som du vill slutföra.

Beräkningskrav

• Om du använder en Databricks notebook för att skapa delningen måste din beräkningsresurs använda Databricks Runtime 11.3 LTS eller senare och ha ett standard- eller dedikerat åtkomstläge (tidigare delat och engångsanvändarläge).
• Om du använder SQL-instruktioner för att lägga till ett schema i en resurs (eller uppdatera eller ta bort ett schema) måste du använda ett SQL-lager eller beräkning som kör Databricks Runtime 13.3 LTS eller senare. Att göra samma sak med Catalog Explorer har inga beräkningskrav.

Skapa ett delningsobjekt

Se till att du uppfyller kraven innan du skapar ett resursobjekt.

För att skapa en delning använder du Catalog Explorer, Databricks Unity Catalog CLI eller CREATE SHARE SQL-kommandon i en Azure Databricks-notebook-fil eller Databricks SQL-frågeredigeraren.

Katalogutforskaren

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

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

   Du kan också klicka på knappen på sidan >.

3. På fliken Delat av mig klickar du på knappen Dela data .

4. På sidan Skapa resurs anger du resursnamnet och en valfri kommentar.

5. Klicka på Spara och fortsätt.

   Du kan fortsätta att lägga till datatillgångar, eller så kan du stoppa och komma tillbaka senare.

6. På fliken Lägg till datatillgångar väljer du de datatillgångar som du vill dela.

   Detaljerade instruktioner, ytterligare krav och relaterade begränsningar finns i:

   • Lägg till tabeller i en delning
   • Lägga till strömmande tabeller i en delning
   • Lägg till hanterade Iceberg-tabeller i en delning
   • Lägg till externa scheman eller tabeller i en delning
   • Lägg till volymer i en delning
   • Lägga till vyer i en delning
   • Lägg till materialiserade vyer i en delning
   • Lägg till modeller i en delning

7. Klicka på Spara och fortsätt.

8. På fliken Lägg till anteckningsböcker väljer du de anteckningsböcker som du vill dela.

   Detaljerade anvisningar finns i Lägg till notebook-filer i en delning.

9. Klicka på Spara och fortsätt.

10. På fliken Lägg till mottagare väljer du de mottagare som du vill dela med.

    Detaljerade anvisningar finns i Hantera åtkomst till deltadelningsdataresurser (för leverantörer).

11. Klicka på Dela data för att dela data med mottagarna.

SQL

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

CREATE SHARE [IF NOT EXISTS] <share-name>
[COMMENT "<comment>"];

Nu kan du lägga till tabeller, strömmande tabeller, volymer, vyer, materialiserade vyer och modeller till resursen.

Detaljerade instruktioner, ytterligare krav och relaterade begränsningar finns i:

• Lägg till tabeller i en delning
• Lägga till strömmande tabeller i en delning
• Lägg till hanterade Iceberg-tabeller i en delning
• Lägg till externa scheman eller tabeller i en delning
• Lägg till volymer i en delning
• Lägga till vyer i en delning
• Lägg till materialiserade vyer i en delning
• Lägg till modeller i en delning

CLI

Kör följande kommando med hjälp av Databricks CLI.

databricks shares create <share-name>

Du kan använda --comment för att lägga till en kommentar eller --json för att lägga till tillgångar i resursen. Mer information finns i avsnitten som följer.

Nu kan du lägga till tabeller, strömmande tabeller, volymer, vyer, materialiserade vyer och modeller till resursen.

Detaljerade instruktioner, ytterligare krav och relaterade begränsningar finns i:

• Lägg till tabeller i en delning
• Lägga till strömmande tabeller i en delning
• Lägg till hanterade Iceberg-tabeller i en delning
• Lägg till externa scheman eller tabeller i en delning
• Lägg till volymer i en delning
• Lägga till vyer i en delning
• Lägg till materialiserade vyer i en delning
• Lägg till modeller i en delning

Lägga till tabeller i en delning

Se till att du uppfyller kraven innan du lägger till tabeller i en resurs.

Om du är administratör för arbetsytan och har ärvt USE SCHEMA och USE CATALOG behörighet för schemat och katalogen som innehåller tabellen från arbetsytans administratörsgrupp kan du inte lägga till tabellen i en delning. Du måste först ge dig själv behörigheterna USE SCHEMA och USE CATALOG för schemat och katalogen.

Om du vill lägga till tabeller i en resurs använder du Catalog Explorer, Databricks Unity Catalog CLI eller SQL-kommandon i en Azure Databricks-notebook-fil eller Databricks SQL-frågeredigeraren.

Katalogutforskaren

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

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

   Du kan också klicka på knappen på sidan >.

3. På fliken Delat av mig letar du reda på den resurs som du vill lägga till en tabell i och klickar på dess namn.

4. Klicka på Hantera tillgångar > Lägg till datatillgångar.

5. På sidan Lägg till tabeller väljer du antingen ett helt schema (databas) eller enskilda tabeller.

   • Om du vill välja en tabell eller vy väljer du först katalogen, sedan schemat som innehåller tabellen och sedan själva tabellen eller vyn.

     Du kan söka efter tabeller efter namn, kolumnnamn eller kommentar med hjälp av arbetsytesökning. Se Sök efter arbetsyteobjekt.

   • Välj ett schema genom att först välja katalogen och sedan schemat.

     Detaljerad information om delningsscheman finns i Lägga till scheman i en resurs.

6. Historik: Dela tabellhistoriken så att mottagarna kan köra frågor om tidsresor eller läsa tabellen med Spark Structured Streaming. För Databricks-till-Databricks-delningar delas även Delta-loggen för tabellen för att förbättra prestandan. Se Förbättra tabellläsningsprestanda med historikdelning. Historikdelning kräver Databricks Runtime 12.2 LTS eller senare.

   Note

   Om du också vill att dina kunder ska kunna köra frågor mot en tabells ändringsdataflöde (CDF) med hjälp av funktionen table_changes() måste du aktivera CDF i tabellen innan du delar den WITH HISTORY.

7. (Valfritt) Klicka på . Under kolumnerna Alias eller Partition lägger du till ett alias eller en partition. Alias och partitioner är inte tillgängliga om du väljer ett helt schema. Tabellhistorik ingår som standard om du väljer ett helt schema.

   • Alias: Ett alternativt tabellnamn för att göra tabellnamnet mer läsbart. Aliaset är det tabellnamn som mottagaren ser och måste använda i frågor. Mottagarna kan inte använda det faktiska tabellnamnet om ett alias har angetts.
   • Partition: Dela endast en del av tabellen. Exempel: (column = 'value') Se Ange tabellpartitioner för att dela och Använd mottagaregenskaper för att utföra partitionsfiltrering.

8. Klicka på Spara.

SQL

Kör följande kommando i en notebook-fil eller Databricks SQL-frågeredigeraren för att lägga till en tabell:

ALTER SHARE <share-name> ADD TABLE <catalog-name>.<schema-name>.<table-name>  [COMMENT "<comment>"]
   [PARTITION(<clause>)] [AS <alias>]
   [WITH HISTORY | WITHOUT HISTORY];

Kör följande för att lägga till ett helt schema. Kommandot ADD SCHEMA kräver ett SQL-lager eller en beräkning som kör Databricks Runtime 13.3 LTS eller senare. Detaljerad information om delningsscheman finns i Lägga till scheman i en resurs.

ALTER SHARE <share-name> ADD SCHEMA <catalog-name>.<schema-name>
[COMMENT "<comment>"];

Alternativen omfattar följande. PARTITION och AS <alias> är inte tillgängliga om du väljer ett helt schema.

• PARTITION(<clause>): Om du bara vill dela en del av tabellen kan du ange en partition. Till exempel, (column = 'value') se Specificera tabellpartitioner att dela och Använd mottagaregenskaper för att utföra partitionsfiltrering.

• AS <alias>: Ett alternativt tabellnamn eller alias för att göra tabellnamnet mer läsbart. Aliaset är det tabellnamn som mottagaren ser och måste använda i frågor. Mottagarna kan inte använda det faktiska tabellnamnet om ett alias har angetts. Använd formatet <schema-name>.<table-name>.

• WITH HISTORY eller WITHOUT HISTORY: När WITH HISTORY anges, dela tabellen med fullständig historik, vilket ger mottagarna möjlighet att utföra tidsresefrågor och strömmande läsningar. För Databricks-till-Databricks-delningar delar historikdelning också tabellens Delta-logg för att förbättra prestandan. Standardbeteendet för tabelldelning är WITH HISTORY om din beräkning kör Databricks Runtime 16.2 eller senare och WITHOUT HISTORY för tidigare Databricks Runtime-versioner. För schemadelning är standardvärdet WITH HISTORY oavsett Databricks Runtime-version. WITH HISTORY och WITHOUT HISTORY kräver Databricks Runtime 12.2 LTS eller senare. Se även Förbättra tabellläsningsprestanda med historikdelning.

  Note

  Om du, förutom att köra frågor om tidsresor och direktuppspelningsläsningar, vill att mottagarna ska köra frågor mot en tabells ändringsdataflöde (CDF) med hjälp av funktionen table_changes() måste du aktivera CDF i tabellen innan du delar den WITH HISTORY.

Mer information om ALTER SHARE-alternativen finns i ALTER SHARE.

CLI

Om du vill lägga till en tabell kör du följande kommando med hjälp av Databricks CLI.

databricks shares update <share-name> \
  --json '{
    "updates": [
      {
        "action": "ADD",
        "data_object": {
          "name": "<table-full-name>",
          "data_object_type": "TABLE",
          "shared_as": "<table-alias>"
        }
      }
    ]
  }'

Om du vill lägga till ett schema kör du följande Databricks CLI-kommando:

databricks shares update <share-name> \
  --json '{
    "updates": [
      {
        "action": "ADD",
        "data_object": {
          "name": "<schema-full-name>",
          "data_object_type": "SCHEMA"
        }
      }
    ]
  }'

Om du vill veta mer om alternativen i det här exemplet kan du läsa anvisningarna på fliken SQL.

För att lära dig mer om ytterligare parametrar, kör databricks shares update --help eller se PATCH /api/2.1/unity-catalog/shares/ i REST API-referensen.

Information om hur du tar bort tabeller från en resurs finns i Uppdatera resurser.

Ange tabellpartitioner som ska delas

Om du bara vill dela en del av en tabell när du lägger till tabellen i en resurs anger du en partitionsspecifikation. Ange partitioner när du lägger till en tabell i en resurs eller uppdaterar en resurs med hjälp av Catalog Explorer, Databricks Unity Catalog CLI eller SQL-kommandon i en Azure Databricks-notebook-fil eller Databricks SQL-frågeredigeraren. Se Lägga till tabeller i en resurs och Uppdatera resurser.

Example

Följande SQL-exempel delar en del av data i inventory tabellen, partitionerade efter kolumnerna year, monthoch date :

• Data för år 2021.
• Data för december 2020.
• Data för 25 december 2019.

ALTER SHARE share_name
ADD TABLE inventory
PARTITION (year = "2021"),
          (year = "2020", month = "Dec"),
          (year = "2019", month = "Dec", date = "2019-12-25");

Använda mottagaregenskaper för att utföra partitionsfiltrering

Du kan dela en tabellpartition som matchar egenskaper för datamottagare, även kallat parametriserad partitionsdelning.

Standardegenskaper är:

• databricks.accountId: Azure Databricks-kontot som en datamottagare tillhör (endast Databricks-till-Databricks-delning).
• databricks.metastoreId: Unity Catalog-metakatalogen som en datamottagare tillhör (endast Databricks-till-Databricks-delning).
• databricks.name: Namnet på datamottagaren.

Du kan skapa en anpassad egenskap när du skapar eller uppdaterar en mottagare.

Genom att filtrera efter mottagares egenskaper kan du dela samma tabeller med samma delning över flera Databricks-konton, arbetsytor och användare, samtidigt som du upprätthåller datagränserna mellan dem.

Om dina tabeller till exempel innehåller en azure Databricks-konto-ID-kolumn kan du skapa en enskild resurs med tabellpartitioner som definierats av Azure Databricks-konto-ID. När du delar dynamiskt levererar Delta Sharing endast de data som är associerade med varje mottagares Azure Databricks-konto.

Utan möjligheten att dynamiskt dela upp efter egenskaper måste du skapa en separat delning för varje mottagare.

Om du vill ange en partition som filtrerar efter mottagaregenskaper när du skapar eller uppdaterar en resurs kan du använda Catalog Explorer eller CURRENT_RECIPIENT SQL-funktionen i en Azure Databricks-notebook-fil eller Databricks SQL-frågeredigeraren:

Katalogutforskaren

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

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

   Du kan också klicka på knappen på sidan >.

3. På fliken Delat av mig letar du reda på den resurs som du vill uppdatera och klickar på dess namn.

4. Klicka på Hantera tillgångar > Lägg till datatillgångar.

5. På sidan Lägg till tabeller väljer du den katalog och databas som innehåller tabellen och väljer sedan tabellen.

   Om du inte är säker på vilken katalog och databas som innehåller tabellen kan du söka efter den efter namn, kolumnnamn eller kommentar med hjälp av arbetsytesökning. Se Sök efter arbetsyteobjekt.

6. (Valfritt) Klicka på Under partitionskolumnen lägger du till en partition.

   I dialogrutan Lägg till partition i tabellen lägger du till den egenskapsbaserade partitionsspecifikationen med hjälp av följande syntax:

   (<column-name> = CURRENT_RECIPIENT().<property-key>)
   

   Ett exempel:

   (country = CURRENT_RECIPIENT().'country')
   

7. Klicka på Spara.

SQL

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

ALTER SHARE <share-name> ADD TABLE <catalog-name>.<schema-name>.<table-name>
   PARTITION (<column-name> = CURRENT_RECIPIENT().<property-key>);

Ett exempel:

ALTER SHARE acme ADD TABLE acme.default.some_table
  PARTITION (country = CURRENT_RECIPIENT().'country');

Lägga till tabeller med borttagningsvektorer eller kolumnmappning till en delning

Borttagningsvektorer är en funktion för lagringsoptimering som du kan aktivera i Delta-tabeller. Se Vad är borttagningsvektorer?.

Azure Databricks stöder även kolumnmappning för Delta-tabeller. Se Byt namn på och ta bort kolumner med Delta Lake-kolumnmappning.

Om du vill dela en tabell med borttagningsvektorer eller kolumnmappning måste du dela den med historiken. Se Lägg till tabeller i en delning.

När du delar en tabell med borttagningsvektorer eller kolumnmappning kan mottagarna fråga tabellen med hjälp av ett SQL-lager, en beräkning som kör Databricks Runtime 14.1 eller senare eller en beräkning som kör öppen källkod delta-sharing-spark 3.1 eller senare. Se Läs tabeller med borttagningsvektorer eller kolumnmappning aktiverat och Läs tabeller med borttagningsvektorer eller kolumnmappning aktiverat.

Lägga till scheman i en delning

Försäkra dig om att du uppfyller kraven innan du adderar scheman till en delning.

Genom att lägga till ett helt schema i en resurs får mottagarna åtkomst till alla datatillgångar i schemat när du skapar resursen, samt alla tillgångar som läggs till i schemat över tid. Detta omfattar alla tabeller, vyer och volymer i schemat. Tabeller som delas på det här sättet innehåller alltid fullständig historik.

Dela scheman med en mottagare

Om du vill lägga till ett schema i en resurs följer du anvisningarna i Lägg till tabeller i en resurs och uppmärksammar innehållet som anger hur du lägger till ett schema.

För att lägga till, uppdatera eller ta bort ett schema med SQL krävs ett SQL-lager eller en beräkning som kör Databricks Runtime 13.3 LTS eller senare. Att göra samma sak med Catalog Explorer har inga beräkningskrav.

Begränsningar

• Tabellalias, partitioner och volymalias är inte tillgängliga om du delar ett helt schema. Om du har skapat alias eller partitioner för några tillgångar i schemat tas dessa bort när du lägger till hela schemat i resursen.

• Om du vill ange avancerade alternativ för en tabell eller volym i schemat måste du dela tabellen eller volymen med SQL och ge tabellen eller volymen ett alias med ett annat schemanamn.

Lägga till tabeller och scheman som skyddas av ABAC-principer till en resurs

Attributbaserad åtkomstkontroll (ABAC) är en datastyrningsmodell som ger flexibel, skalbar och centraliserad åtkomstkontroll i Azure Databricks.

Du kan dela en tabell eller ett schema som skyddas av ABAC-principer som standardtabeller. Information om hur du tillämpar ABAC-principer på dina datatillgångar finns i Skapa och hantera attributbaserade åtkomstkontrollprinciper (ABAC).

Du måste dock vara en privilegierad användare. En privilegierad användare är resursägaren och en användare som undantas från DE ABAC-principer som tillämpas på datatillgången. Principen styr inte mottagarens åtkomst. Mottagarna har fullständig åtkomst till den delade tillgången. ABAC-begränsningar gäller.

** Lägg till strömmande tabeller i en delning

Direktuppspelningstabeller är vanliga Delta-tabeller med extra stöd för direktuppspelning eller inkrementell databearbetning. Strömmande tabeller är utformade för datakällor där data endast läggs till och bearbetar indatan endast en gång. Se Använda strömmande tabeller i Databricks SQL.

Se till att du uppfyller kraven innan du lägger till strömmande tabeller i en resurs.

Ytterligare krav

• Om arbetsytan har aktiverat bindningar för arbetsytekatalogen kontrollerar du att arbetsytan har läs- och skrivåtkomst till katalogen som strömningstabellen finns i. Mer information finns i Begränsa katalogåtkomst till specifika arbetsytor.
• Delningsbara direktuppspelningstabeller måste definieras i Delta-tabeller eller andra delningsbara strömmande tabeller eller vyer.
• Du måste använda ett SQL-lager eller en beräkning på Databricks Runtime 13.3 LTS eller senare när du lägger till en strömmande tabell i en resurs.

Begränsningar

• Strömningstabellen kan inte ha radfilter och kolumnmasker.
  • Bastabellen i den strömmande tabellen kan ha radfilter och kolumnmasker.
• Strömningstabellen kan inte ha partitionsfilter. Skapa i stället en vy ovanpå strömningstabellen.

Dela strömmande tabeller med en mottagare

Så här lägger du till strömmande tabeller i en delning:

Katalogutforskaren

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

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

   Du kan också klicka på knappen på sidan >.

3. På fliken Delat av mig letar du reda på den resurs som du vill lägga till en strömmande tabell i och klickar på dess namn.

4. Klicka på Hantera tillgångar > Redigera tillgångar.

5. På sidan Redigera tillgångar söker eller bläddrar du efter den strömmande tabell som du vill dela och väljer den.

6. (Valfritt) I kolumnen Alias klickar du på Om du vill ange ett alias eller ett alternativt namn på strömningstabellen blir namnet på den strömmande tabellen mer läsbart. Aliaset är det namn som mottagaren ser och måste använda i frågor. Mottagarna kan inte använda det faktiska namnet på strömningstabellen om ett alias har angetts.

7. Klicka på Spara.

SQL

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

ALTER SHARE <share_name> ADD TABLE <st_name> [COMMENT <comment>] [AS <shared_st_name>];

CLI

Kör följande Databricks CLI-kommando.

databricks shares update <share-name> \
  --json '{
    “updates”: [
      {
        “action”: “ADD”,
        “data_object”: {
          “name”: “<st-full-name>",
          “data_object_type”: “TABLE”,
          “comment”: “<comment>”
        }
      }
    ]
  }'

Information om hur du tar bort strömmande tabeller från en resurs finns i Uppdatera resurser.

Lägga till hanterade isbergstabeller i en delning

Apache Iceberg är ett tabellformat med öppen källkod för analysarbetsbelastningar. I Azure Databricks kan du skapa isbergstabeller i Unity Catalog, så kallade hanterade isbergstabeller.

Se till att du uppfyller kraven innan du lägger till hanterade isbergstabeller i en delning.

Begränsningar för isbergstabeller och hanterade isbergstabeller gäller. Se Begränsningar för isbergstabeller.

För att lägga till administrerade Iceberg-tabeller i en resurs:

Katalogutforskaren

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

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

   Du kan också klicka på knappen på sidan >.

3. På fliken Delat av mig letar du reda på den resurs som du vill lägga till en hanterad isbergstabell i och klickar på dess namn.

4. Klicka på Hantera tillgångar>Redigera tillgångar.

5. På sidan Redigera tillgångar söker eller bläddrar du efter den hanterade isbergstabell som du vill dela och väljer den.

6. (Valfritt) I kolumnen Alias klickar du på Om du vill ange ett alias eller ett alternativt hanterat isbergstabellnamn kan du göra namnet mer läsbart. Aliaset är det namn som mottagaren ser och måste använda i frågor. Mottagarna kan inte använda det faktiska namnet på den hanterade Iceberg-tabellen om ett alias har angetts.

7. Klicka på Spara.

SQL

Kör följande kommando i en notebook-fil eller Databricks SQL-frågeredigeraren. Du kan ange <shared_iceberg_table_name> för att exponera den hanterade isbergstabellen under ett annat namn.

ALTER SHARE <share_name> ADD TABLE <managed_iceberg_name> [COMMENT <comment>] [AS <shared_iceberg_table_name>];

CLI

Kör följande Databricks CLI-kommando.

databricks shares update <share-name> \
  --json '{
    “updates”: [
      {
        “action”: “ADD”,
        “data_object”: {
          “name”: “<managed-iceberg-full-name>",
          “data_object_type”: “TABLE”,
          “comment”: “<comment>”
        }
      }
    ]
  }'

Lägg till utländska scheman eller tabeller i en delning

Med Lakehouse Federation kan du använda Azure Databricks för att köra frågor mot externa datakällor. Du kan skapa externa scheman och tabeller, som innehåller data och metadata som hanteras av externa system, med Unity Catalog som lägger till datastyrning för att köra frågor mot dessa tabeller. Mer information om hur du ansluter till externa källor finns i Vad är Lakehouse Federation?.

Med deltadelning kan du dela främmande data på ett säkert sätt från den ursprungliga platsen, utan att kopiera data till Azure Databricks, komplexa nätverksinstallationer eller överföringar av autentiseringsuppgifter.

Se till att du uppfyller kraven innan du lägger till externa scheman eller tabeller i en resurs.

Ytterligare krav

• Du måste aktivera serverlös beräkning för arbetsflöden, anteckningsböcker och Lakeflow Deklarativa Pipelines på det konto där utländskt schema eller delning av utländska tabeller har konfigurerats. Se Ansluta till serverlös beräkning.

• Om du väljer att använda standardlagring måste du aktivera deltadelning för standardlagring – utökad åtkomstförhandsgranskning på kontonivå. Se Hantera förhandsversioner av Azure Databricks.

Lagringsplats för materialiserade data

När du delar utländska scheman och tabeller hämtas data och materialiseras tillfälligt hos leverantören. Som standard lagras materialiserade data i ett dolt schema med azure Databricks standardlagring (privat förhandsversion). Se till att du uppfyller kraven och observera begränsningarna för standardlagring.

Standardlagringen har begränsad regional tillgänglighet. Dess tillgänglighet matchar den hos serverlös beräkning för anteckningsböcker och jobb. Se Serverlös tillgänglighet.

Om du vill välja bort användning av Azure Databricks standardlagring och använda din egen lagring för tillfällig materialisering öppnar du ett supportärende.

Rekommenderade användningsmönster

Frågeresultat genereras på begäran för varje fråga, så utländsk tabell- och schemadelning kanske inte är lika kostnadseffektivt jämfört med delning av tabeller eller materialiserade vyer. Azure Databricks rekommenderar följande för att förbättra prestanda:

• Behåll storleken på vanliga frågeresultat mindre än 10 GB.
• Använd ad hoc-undersökande frågor i stället för frekventa datadumpar.
• När du använder molntokendelning, överväg att dela materialiserade vyer som skapats ovanpå externa tabeller för kostnadseffektivitet och bättre prestanda.

Dela det externa schemat eller tabellen med en mottagare

Om du vill lägga till externa scheman eller tabeller i en resurs använder du Catalog Explorer, Databricks Unity Catalog CLI eller SQL-kommandon i en Azure Databricks-notebook-fil eller Databricks SQL-frågeredigeraren.

Katalogutforskaren

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

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

   Du kan också klicka på knappen på sidan >.

3. På fliken Delat av mig letar du reda på den resurs som du vill lägga till en sekundär tabell eller ett schema i och klickar på dess namn.

4. Klicka på Hantera tillgångar > Redigera tillgångar.

5. På sidan Redigera tillgångar söker eller bläddrar du efter den utländska tabellen eller det schema som du vill dela och väljer det.

6. (Valfritt) I kolumnen Alias klickar du på Om du vill ange ett alias eller ett alternativt sekundärschema eller tabellnamn kan du göra det externa schemat eller tabellnamnet mer läsbart. Aliaset är det namn som mottagaren ser och måste använda i frågor. Mottagarna kan inte använda det utländska schemat eller tabellnamnet om ett alias har angetts.

7. Klicka på Spara.

SQL

ALTER SHARE <share-name>
  ADD {TABLE | SCHEMA} {federated_catalog.federated_schema.federated_table | federated_catalog.federated_schema}
  [COMMENT "<comment>"]
  [AS <alias>];

Alternativen inkluderar:

• AS <alias>: Ett alternativt namn eller alias för att göra datatillgångens namn mer läsbart. Aliaset är det datatillgångsnamn som mottagaren ser och måste använda i frågor. Mottagarna kan inte använda det faktiska namnet om ett alias har angetts. Använd formatet <catalog-name>.<schema-name>.<view-name>.
• COMMENT "<comment>": Kommentarer visas i katalogutforskarens användargränssnitt och när du listar och visar information om datatillgången med hjälp av SQL-instruktioner.

Mer information om ALTER SHARE-alternativen finns i ALTER SHARE.

CLI

databricks shares update <share-name> \
  --json '{
    “updates”: [
      {
        “action”: “ADD”,
        “data_object”: {
          “name”: “<federated-data-asset-full-name>",
          “data_object_type”: “{TABLE | SCHEMA}”,
          "shared_as": "<foreign-data-asset-alias>",
          “comment”: “<comment>”
        }
      }
    ]
  }'

Lägga till vyer i en delning

Vyer är skrivskyddade objekt som skapats från en eller flera olika tabeller eller andra vyer. En vy kan skapas från tabeller och andra vyer som finns i flera scheman och kataloger i ett Unity Catalog-metaarkiv. Se Skapa och hantera vyer.

Se till att du uppfyller kraven innan du lägger till vyer i en delning.

Ytterligare krav

• Delningsbara vyer måste definieras i Delta-tabeller, andra delade vyer eller lokala materialiserade vyer och strömmande tabeller. Delningsbara vyer kan inte definieras på externa tabeller.
• Du kan inte dela vyer som hänvisar till delade tabeller eller gemensamma vyer.
• Du måste använda ett SQL-lager eller en datorresurs på Databricks Runtime version 13.3 LTS eller senare när du lägger till en vy i en delning.
• Om du har aktiverat bindningar för arbetsytekatalogen på arbetsytan kontrollerar du att arbetsytan har läs- och skrivåtkomst till katalogen. Mer information finns i Begränsa katalogåtkomst till specifika arbetsytor.

Dela perspektiv med en mottagare

Det här avsnittet beskriver hur du lägger till vyer till en resurs med hjälp av Catalog Explorer-, Databricks CLI- eller SQL-kommandon i en Azure Databricks-notebook-fil eller Databricks SQL-frågeredigeraren. Om du föredrar att använda REST-API:et för Unity Catalog läser du PATCH /api/2.1/unity-catalog/shares/ i REST API-referensen .

Katalogutforskaren

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

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

   Du kan också klicka på knappen på sidan >.

3. På fliken Delat av mig letar du reda på den resurs som du vill lägga till en vy i och klickar på dess namn.

4. Klicka på Hantera tillgångar > Lägg till datatillgångar.

5. På sidan Lägg till tabeller söker eller bläddrar du efter den vy som du vill dela och väljer den.

6. (Valfritt) Klicka på Under kolumnen Alias anger du ett alternativt vynamn, eller Alias, för att göra visningsnamnet mer läsbart. Aliaset är det namn som mottagaren ser och måste använda i frågor. Mottagarna kan inte använda det faktiska visningsnamnet om ett alias har angetts.

7. Klicka på Spara.

SQL

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

ALTER SHARE <share-name> ADD VIEW <catalog-name>.<schema-name>.<view-name>
   [COMMENT "<comment>"]
   [AS <alias>];

Alternativen inkluderar:

• AS <alias>: Ett alternativt vynamn eller alias för att göra visningsnamnet mer läsbart. Aliaset är det vynamn som mottagaren ser och måste använda i frågor. Mottagarna kan inte använda det faktiska visningsnamnet om ett alias har angetts. Använd formatet <schema-name>.<view-name>.
• COMMENT "<comment>": Kommentarer visas i katalogutforskarens användargränssnitt och när du listar och visar visningsinformation med hjälp av SQL-instruktioner.

Mer information om ALTER SHARE-alternativen finns i ALTER SHARE.

CLI

Kör följande Databricks CLI-kommando:

databricks shares update <share-name> \
  --json '{
    "updates": [
      {
        "action": "ADD",
        "data_object": {
          "name": "<view-full-name>",
          "data_object_type": "VIEW",
          "shared_as": "<view-alias>"
        }
      }
    ]
  }'

"shared_as": "<view-alias>" är valfritt och tillhandahåller ett alternativt vynamn eller alias för att göra visningsnamnet mer läsbart. Aliaset är det vynamn som mottagaren ser och måste använda i frågor. Mottagarna kan inte använda det faktiska visningsnamnet om ett alias har angetts. Använd formatet <schema-name>.<view-name>.

För att lära dig mer om ytterligare parametrar, kör databricks shares update --help eller se PATCH /api/2.1/unity-catalog/shares/ i REST API-referensen.

Information om hur du tar bort vyer från en resurs finns i Uppdatera resurser.

Lägger till dynamiska vyer i en delning för att filtrera rader och kolumner

Du kan använda dynamiska vyer för att konfigurera detaljerad åtkomstkontroll för tabelldata, inklusive:

• Säkerhet på kolumn- eller radnivå.
• Datamaskering

När du skapar en dynamisk vy som använder funktionen CURRENT_RECIPIENT() kan du begränsa mottagaråtkomsten enligt egenskaper som du anger i mottagardefinitionen.

Det här avsnittet innehåller exempel på hur du begränsar mottagarens åtkomst till tabelldata på både rad- och kolumnnivå med hjälp av en dynamisk vy.

Requirements

• Se till att du uppfyller kraven för att lägga till en vy i en dela.
• Databricks Runtime-version: Funktionen CURRENT_RECIPIENT stöds i Databricks Runtime 14.2 och senare.

Begränsningar

• Alla begränsningar för visningsdelning gäller.
• När en provider delar en vy som använder CURRENT_RECIPIENT funktionen kan providern inte fråga vyn direkt på grund av delningskontexten. För att testa en sådan dynamisk vy måste leverantören dela vyn med sig själv och köra en fråga mot vyn som mottagare.
• Leverantörer kan inte skapa en vy som refererar till en dynamisk vy.

Ange en mottagaregenskap

I de här exemplen har tabellen som ska delas en kolumn med namnet country, och endast mottagare med en matchande country egenskap kan visa vissa rader eller kolumner.

Du kan ange mottagaregenskaper med hjälp av Catalog Explorer- eller SQL-kommandon i en Azure Databricks-notebook-fil eller SQL-frågeredigeraren.

Katalogutforskaren

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

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

   Du kan också klicka på knappen på sidan >.

3. På fliken Mottagare letar du reda på den mottagare som du vill lägga till egenskaperna i och klickar på dess namn.

4. Klicka på Redigera egenskaper.

5. I dialogrutan Redigera mottagaregenskaper anger du kolumnnamnet som en nyckel (i det här fallet country) och det värde som du vill filtrera efter som värde (till exempel CA).

6. Klicka på Spara.

SQL

Om du vill ange egenskapen på mottagaren använder du ALTER RECIPIENT. I det här exemplet är egenskapen inställd på countryCA.

ALTER RECIPIENT recipient1 SET PROPERTIES ('country' = 'CA');

Skapa en dynamisk vy med behörighet på radnivå för mottagare

I det här exemplet kan endast mottagare med en matchande country egenskap visa vissa rader.

CREATE VIEW my_catalog.default.view1 AS
  SELECT * FROM my_catalog.default.my_table
  WHERE country = CURRENT_RECIPIENT('country');

Ett annat alternativ är att dataprovidern underhåller en separat mappningstabell som mappar faktatabellfält till mottagaregenskaper. På så sätt kan mottagaregenskaper och faktatabellfält frikopplas för större flexibilitet.

Skapa en dynamisk vy med behörighet på kolumnnivå för mottagare

I det här exemplet kan endast mottagare som matchar country egenskapen visa vissa kolumner. Andra ser de data som returneras som REDACTED:

CREATE VIEW my_catalog.default.view2 AS
  SELECT
  CASE
    WHEN CURRENT_RECIPIENT('country') = 'US' THEN pii
    ELSE 'REDACTED'
  END AS pii
  FROM my_catalog.default.my_table;

Dela den dynamiska vyn med en mottagare

Om du vill dela den dynamiska vyn med en mottagare använder du samma SQL-kommandon eller UI-procedur som för en standardvy. Se Lägg till vyer i en delning.

Lägga till materialiserade vyer i en delning

Precis som vyer är materialiserade vyer resultatet av en fråga och du kan komma åt dem på samma sätt som i en tabell. Till skillnad från vanliga vyer återspeglar resultatet av en materialiserad vy datatillståndet när den materialiserade vyn senast uppdaterades. Mer information om materialiserade vyer finns i Använda materialiserade vyer i Databricks SQL.

Se till att du uppfyller kraven innan du lägger till materialiserade vyer i en delning.

Ytterligare krav

• Om din arbetsyta har aktiverat bindningar för arbetsytans katalog, se till att arbetsytan har läs- och skrivåtkomst till katalogen som innehåller den materialiserade vyn. Mer information finns i Begränsa katalogåtkomst till specifika arbetsytor.
• Delningsbara materialiserade vyer måste definieras i Delta-tabeller eller andra delningsbara strömmande tabeller, vyer eller materialiserade vyer.
• Du måste använda ett SQL-lager eller en beräkning på Databricks Runtime 13.3 LTS eller senare när du lägger till en materialiserad vy i en resurs.

Begränsningar

• Den materialiserade vyn får inte ha radfilter, men bastabellen i den materialiserade vyn kan ha radfilter och kolumnmasker.
• Den materialiserade vyn kan inte ha partitionsfilter. Skapa i stället en vy ovanpå den materialiserade vyn.

Dela materialiserade vyer med en mottagare

I det här avsnittet beskrivs hur du lägger till materialiserade vyer i en resurs med hjälp av Katalogutforskaren, Databricks CLI eller SQL-kommandon i en Azure Databricks-anteckningsbok eller Databricks SQL-frågeredigeraren. Om du föredrar att använda REST-API:et för Unity Catalog läser du PATCH /api/2.1/unity-catalog/shares/ i REST API-referensen .

Katalogutforskaren

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

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

   Du kan också klicka på knappen på sidan >.

3. På fliken Delat av mig letar du reda på den resurs som du vill lägga till en materialiserad vy i och klickar på dess namn.

4. Klicka på Hantera tillgångar > Redigera tillgångar.

5. På sidan Redigera tillgångar söker eller bläddrar du efter den materialiserade vy som du vill dela och väljer den.

6. (Valfritt) I kolumnen Alias klickar du på Om du vill ange ett alias eller ett alternativt materialiserat vynamn kan du göra det materialiserade visningsnamnet mer läsbart. Aliaset är det namn som mottagaren ser och måste använda i frågor. Mottagare kan inte använda det faktiska materialiserade vynamnet om ett alias har angetts.

7. Klicka på Spara.

SQL

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

ALTER SHARE <share_name> ADD MATERIALIZED VIEW <mv_name> [COMMENT <comment>] [AS <shared_mv_name>];

CLI

databricks shares update <share-name> \
  --json '{
    “updates”: [
      {
        “action”: “ADD”,
        “data_object”: {
          “name”: “<mat-view-full-name>”,
          “data_object_type”: “MATERIALIZED_VIEW”,
          “comment”: “<comment>”
        }
      }
    ]
  }'

Information om hur du tar bort materialiserade vyer från en resurs finns i Uppdatera resurser.

Lägg till volymer i en delning

Volymer är Unity Catalog-objekt som representerar en logisk lagringsvolym på en lagringsplats för molnobjekt. De är främst avsedda att ge styrning över icke-tabellbaserade datatillgångar. Se Vad är Unity Catalog-volymer?.

Se till att du uppfyller kraven innan du lägger till volymer i en delad resurs.

Ytterligare krav

• Volymdelning stöds endast i Databricks-till-Databricks-delning.
• Du måste använda ett SQL-lager på version 2023.50 eller senare eller en beräkningsresurs på Databricks Runtime 14.1 eller senare när du lägger till en volym till en delning.
• Om volymlagringen på providersidan har anpassade nätverkskonfigurationer (till exempel en brandvägg eller en privat länk) måste providern se till att mottagarens kontrollplans- och dataplansadresser är korrekt tillåtna för att kunna ansluta till volymens lagringsplats.

Dela volymer med en mottagare

I det här avsnittet beskrivs hur du lägger till volymer i en resurs med hjälp av Catalog Explorer, Databricks CLI eller SQL-kommandon i en Azure Databricks-notebook- eller SQL-frågeredigerare. Om du föredrar att använda REST-API:et för Unity Catalog läser du PATCH /api/2.1/unity-catalog/shares/ i REST API-referensen .

Katalogutforskaren

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

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

   Du kan också klicka på knappen på sidan >.

3. På fliken Delat av mig letar du reda på den resurs som du vill lägga till en volym i och klickar på dess namn.

4. Klicka på Hantera tillgångar > Redigera tillgångar.

5. På sidan Redigera tillgångar söker eller bläddrar du efter den volym som du vill dela och väljer den.

   Du kan också välja hela schemat som innehåller volymen. Se Lägga till scheman i en delning.

6. (Valfritt) Klicka på Under kolumnen Alias anger du ett alternativt volymnamn, eller Alias, för att göra volymnamnet mer läsbart.

   Inga alias är tillgängliga om du väljer ett helt schema.

   Aliaset är det namn som mottagaren ser och måste använda i frågor. Om ett alias anges kan mottagarna inte använda det faktiska volymnamnet.

7. Klicka på Spara.

SQL

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

ALTER SHARE <share-name> ADD VOLUME <catalog-name>.<schema-name>.<volume-name>
   [COMMENT "<comment>"]
   [AS <alias>];

Alternativen inkluderar:

• AS <alias>: Ett alternativt volymnamn eller alias för att göra volymnamnet mer läsbart. Aliaset är det volymnamn som mottagaren ser och måste använda i sökfrågor. Mottagarna kan inte använda det faktiska volymnamnet om ett alias har angetts. Använd formatet <schema-name>.<volume-name>.
• COMMENT "<comment>": Kommentarer visas i katalogutforskarens användargränssnitt och när du listar och visar volyminformation med hjälp av SQL-instruktioner.

Mer information om ALTER SHARE-alternativen finns i ALTER SHARE.

CLI

Kör följande kommando med Databricks CLI 0.210 eller senare:

 databricks shares update <share-name> \
   --json '{
     "updates": [
       {
         "action": "ADD",
         "data_object": {
           "name": "<volume-full-name>",
           "data_object_type": "VOLUME",
           "string_shared_as": "<volume-alias>"
         }
       }
     ]
   }'

"string_shared_as": "<volume-alias>" är valfritt och tillhandahåller ett alternativt volymnamn, eller alias, för att göra volymnamnet mer läsbart. Aliaset är det volymnamn som mottagaren ser och måste använda i sökfrågor. Mottagarna kan inte använda det faktiska volymnamnet om ett alias har angetts. Använd formatet <schema-name>.<volume-name>.

För att lära dig mer om ytterligare parametrar, kör databricks shares update --help eller se PATCH /api/2.1/unity-catalog/shares/ i REST API-referensen.

Information om hur du tar bort volymer från en resurs finns i Uppdatera resurser.

Lägga till modeller i en delning

Säkerställ att du uppfyller kraven innan du lägger till modeller i en delning.

Ytterligare krav

• Modelldelning stöds endast i Databricks-till-Databricks-delning.
• Du måste använda ett SQL-lager på version 2023.50 eller senare eller en beräkningsresurs på Databricks Runtime 14.0 eller senare när du lägger till en modell i en resurs.

Dela modeller med en mottagare

I det här avsnittet beskrivs hur du lägger till modeller i en resurs med hjälp av Catalog Explorer, Databricks CLI eller SQL-kommandon i en Azure Databricks-notebook- eller SQL-frågeredigerare. Om du föredrar att använda REST-API:et för Unity Catalog läser du PATCH /api/2.1/unity-catalog/shares/ i REST API-referensen .

För att lägga till modeller i en delning:

Katalogutforskaren

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

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

   Du kan också klicka på knappen på sidan >.

3. På fliken Delat av mig letar du reda på den resurs som du vill lägga till en modell i och klickar på dess namn.

4. Klicka på Hantera tillgångar > Redigera tillgångar.

5. På sidan Redigera tillgångar söker eller bläddrar du efter den modell som du vill dela och väljer den.

   Du kan också välja hela schemat som innehåller modellen. Se Lägga till scheman i en delning.

6. (Valfritt) Klicka på Under kolumnen Alias för att ange ett alternativt modellnamn, eller Alias, för att göra modellnamnet mer läsbart.

   Inga alias är tillgängliga om du väljer ett helt schema.

   Aliaset är det namn som mottagaren ser och måste använda i frågor. Mottagarna kan inte använda det faktiska modellnamnet om ett alias har angetts.

7. Klicka på Spara.

SQL

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

ALTER SHARE <share-name> ADD MODEL <catalog-name>.<schema-name>.<model-name>
   [COMMENT "<comment>"]
   [AS <alias>];

Alternativen inkluderar:

• AS <alias>: Ett alternativt modellnamn eller alias för att göra modellnamnet mer läsbart. Aliaset är det modellnamn som mottagaren ser och måste använda i frågor. Mottagarna kan inte använda det faktiska modellnamnet om ett alias har angetts. Använd formatet <schema-name>.<model-name>.
• COMMENT "<comment>": Kommentarer visas i katalogutforskarens användargränssnitt och när du listar och visar modellinformation med hjälp av SQL-instruktioner.

Mer information om ALTER SHARE-alternativen finns i ALTER SHARE.

CLI

Kör följande kommando med Databricks CLI 0.210 eller senare:

 databricks shares update <share-name> \
   --json '{
     "updates": [
       {
         "action": "ADD",
         "data_object": {
           "name": "<model-full-name>",
           "data_object_type": "MODEL",
           "string_shared_as": "<model-alias>"
         }
       }
     ]
   }'

"string_shared_as": "<model-alias>" är valfritt och tillhandahåller ett alternativt modellnamn, eller alias, för att göra modellnamnet mer läsbart. Aliaset är det modellnamn som mottagaren ser och måste använda i frågor. Mottagarna kan inte använda det faktiska modellnamnet om ett alias har angetts. Använd formatet <schema-name>.<model-name>.

För att lära dig mer om ytterligare parametrar, kör databricks shares update --help eller se PATCH /api/2.1/unity-catalog/shares/ i REST API-referensen.

Information om hur du tar bort modeller från en resurs finns i Uppdatera resurser.

Lägga till anteckningsboksfiler till en delning

Se till att du uppfyller kraven innan du lägger till notebook-filer i en delning.

Använd Katalogutforskaren för att lägga till en notebook-fil i en delning.

1. På din Azure Databricks-arbetsyta klickar du på Katalog.
2. Klicka på knappen på sidan >.
3. På fliken Delat av mig letar du reda på den resurs som du vill lägga till en anteckningsbok i och klickar på dess namn.
4. Klicka på Hantera tillgångar och välj Lägg till notebook-fil.
5. På sidan Lägg till notebook-fil klickar du på filikonen för att bläddra efter den notebook-fil som du vill dela.
   • Klicka på den fil som du vill dela och klicka på Välj.
   • (Valfritt) ange ett användarvänligt alias för filen i fältet Dela som . Det här är identifieraren som mottagarna ser.
   • Under Lagringsplats anger du den externa platsen i molnlagringen där du vill lagra anteckningsboken. Du kan ange en underordnad sökväg under den definierade externa platsen. Om du inte anger någon extern plats lagras anteckningsboken på lagringsplatsen på metaarkivnivå (eller "rotplatsen för metaarkivet"). Om ingen rotplats har definierats för metaarkivet måste du ange en extern plats här. Se Lägga till hanterad lagring i ett befintligt metaarkiv.
6. Klicka på Spara.

Den delade notebook-filen visas nu i listan Notebook-filer på fliken Tillgångar .

Ta bort notebook-filer från delningar

Så här tar du bort en anteckningsboksfil från en delning:

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

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

   Du kan också klicka på knappen på sidan >.

3. På fliken Delat av mig letar du reda på resursen som innehåller anteckningsboken och klickar på resursnamnet.

4. På fliken Tillgångar letar du reda på den notebook-fil som du vill ta bort från resursen.

5. Klicka på kebabmeny till höger om raden och välj Ta bort anteckningsboksfil.

6. Klicka på Ta bort i bekräftelsedialogrutan.

Uppdatera anteckningsboksfiler i delningar

Om du vill uppdatera en anteckningsbok som du redan har delat måste du lägga till den igen, vilket ger den ett nytt alias i fältet Dela som . Databricks rekommenderar att du använder ett namn som anger notebook-filens ändrade status, till exempel <old-name>-update-1. Du kan behöva meddela mottagaren om ändringen. Mottagaren måste välja och klona den nya anteckningsboken för att kunna dra nytta av uppdateringen.

Bevilja mottagare åtkomst till en delning

Se till att du uppfyller kraven innan du beviljar mottagarna åtkomst till en resurs.

Anvisningar finns i Hantera åtkomst till deltadelningsdataresurser (för leverantörer). Den här sidan förklarar också hur du återkallar en mottagares åtkomst till en resurs.

Visa resurser och dela information

Se till att du uppfyller kraven innan du visar resurser och delar information.

Om du vill visa en lista med resurser eller information om en resurs använder du Catalog Explorer, Databricks Unity Catalog CLI eller SQL-kommandon i en Azure Databricks-anteckningsbok eller Databricks SQL-frågeredigeraren.

Uppgifter om delning inkluderar följande:

• Resursens ägare, skapare, tidsstämpel för skapande, uppdatering, uppdaterad tidsstämpel, kommentarer.
• Datatillgångar i delningen.
• Mottagare med åtkomst till delningen.

Katalogutforskaren

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

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

   Du kan också klicka på knappen på sidan >.

3. Öppna fliken Resurser om du vill visa en lista över resurser.

4. Visa delningsinformation på fliken Details.

SQL

Om du vill visa en lista över resurser kör du följande kommando i en notebook-fil eller Databricks SQL-frågeredigeraren. Alternativt kan du ersätta <pattern> med ett LIKE predikat.

SHOW SHARES [LIKE <pattern>];

Om du vill visa information om en specifik resurs kör du följande kommando.

DESCRIBE SHARE <share-name>;

Om du vill visa information om alla tabeller, vyer och volymer i en resurs kör du följande kommando.

SHOW ALL IN SHARE <share-name>;

CLI

Om du vill visa en lista över resurser kör du följande kommando med hjälp av Databricks CLI.

databricks shares list

Om du vill visa information om en specifik resurs kör du följande kommando.

databricks shares get <share-name>

Visa de mottagare som har behörighet för en delning

Se till att du uppfyller kraven innan du visar mottagarna.

Om du vill visa listan över resurser som en mottagare har beviljats åtkomst till använder du Catalog Explorer, Databricks Unity Catalog CLI eller SHOW GRANTS TO RECIPIENT SQL-kommandot i en Azure Databricks-notebook-fil eller Databricks SQL-frågeredigeraren.

Katalogutforskaren

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

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

   Du kan också klicka på knappen på sidan >.

3. På fliken Delat av mig letar du upp och väljer mottagaren.

4. Gå till fliken Mottagare för att visa listan över mottagare som kan komma åt resursen.

SQL

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

SHOW GRANTS ON SHARE <share-name>;

CLI

Kör följande kommando med hjälp av Databricks CLI.

databricks shares share-permissions <share-name>

Uppdatera aktier

Se till att du uppfyller kraven innan du uppdaterar en resurs.

Du kan uppdatera en delning så här:

• Byt namn på en resurs.
• Ta bort tabeller, vyer, volymer och scheman från en resurs.
• Lägga till eller uppdatera en kommentar på en delning.
• Byt namn på en tabells alias (tabellnamnet som visas för mottagaren).
• Aktivera eller inaktivera åtkomst till en tabells historikdata, så att mottagarna kan köra frågor om tidsresor eller strömmande läsningar av tabellen.
• Lägg till, uppdatera eller ta bort partitionsdefinitioner.
• Ändra aktieägaren.

Om du vill göra dessa uppdateringar av aktier använder du Catalog Explorer, Databricks Unity Catalog CLI eller SQL-kommandon i en Azure Databricks-anteckningsbok eller Databricks SQL-redigerare. Du kan dock inte använda Catalog Explorer för att byta namn på resursen.

Katalogutforskaren

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

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

   Du kan också klicka på knappen på sidan >.

3. På fliken Delat av mig letar du reda på den resurs som du vill uppdatera och klickar på dess namn.

Gör följande på sidan dela information:

• Klicka på ikonen bredvid fältet Ägare eller Kommentar för att uppdatera dessa värden.
• Klicka på knappen i en rad med en tillgång för att ta bort den.
• Klicka på Hantera tillgångar > Redigera tillgångar för att uppdatera alla andra egenskaper:
  • Om du vill ta bort en tillgång avmarkerar du kryssrutan bredvid tillgången.
  • Om du vill lägga till, uppdatera eller ta bort partitionsdefinitioner klickar du på Avancerade alternativ.

SQL

Kör följande kommandon i en notebook-fil eller Databricks SQL-redigeraren.

Byt namn på en resurs:

ALTER SHARE <share-name> RENAME TO <new-share-name>;

Ta bort tabeller från en resurs:

ALTER SHARE share_name REMOVE TABLE <table-name>;

Ta bort volymer från en delning:

ALTER SHARE share_name REMOVE VOLUME <volume-name>;

Lägg till eller uppdatera en kommentar på en delning:

COMMENT ON SHARE <share-name> IS '<comment>';

Lägg till eller ändra partitioner för en tabell i en delning:

ALTER SHARE <share-name> ADD TABLE <table-name> PARTITION(<clause>);

Ändra aktieägare

ALTER SHARE <share-name> OWNER TO  '<principal>'

-- Principal must be an account-level user email address or group name.

Aktivera historikdelning för en tabell:

ALTER SHARE <share-name> ADD TABLE <table-name> WITH HISTORY;

Mer information om ALTER SHARE parametrar finns i ALTER SHARE.

CLI

Kör följande kommandon med hjälp av Databricks CLI.

Byt namn på en resurs:

databricks shares update <share-name> --name <new-share-name>

Ta bort tabeller från en resurs:

databricks shares update <share-name> \
  --json '{
    "updates": [
      {
        "action": "REMOVE",
        "data_object": {
          "name": "<table-full-name>",
          "data_object_type": "TABLE",
          "shared_as": "<table-alias>"
        }
      }
    ]
  }'

Ta bort volymer från en resurs (med Databricks CLI 0.210 eller senare):

databricks shares update <share-name> \
  --json '{
    "updates": [
      {
        "action": "REMOVE",
        "data_object": {
          "name": "<volume-full-name>",
          "data_object_type": "VOLUME",
          "string_shared_as": "<volume-alias>"
        }
      }
    ]
  }'

Lägg till eller uppdatera en kommentar på en delning:

databricks shares update <share-name> --comment '<comment>'

Ändra aktieägare

databricks  shares update <share-name> --owner '<principal>'

Principalen måste vara en användarens e-postadress eller ett gruppnamn på kontonivå.

Överväganden vid uppdatering av resursägare

Vem resursägaren är påverkar hur auktoriserings- och säkerhetsfunktioner, till exempel ABAC-principer, utvärderas. Om du överför ägarskapet för resursen till en överprivilegierad användare kan mottagarna ha överprivilegierad åtkomst om du har en tabell eller ett schema som skyddas av ABAC-principer.

Ta bort delningar

När du tar bort en resurs kan mottagarna inte längre komma åt delade data. Se till att du uppfyller kraven innan du tar bort ett resursobjekt.

Om du vill ta bort en resurs använder du Catalog Explorer, Databricks Unity Catalog CLI eller DELETE SHARE SQL-kommandot i en Azure Databricks-anteckningsbok eller Databricks SQL-frågeredigeraren. Du måste vara ägare till andelen.

Katalogutforskaren

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

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

   Du kan också klicka på knappen på sidan >.

3. På fliken Delat av mig letar du reda på den resurs som du vill ta bort och klickar på dess namn.

4. Klicka på kebabmeny och välj Ta bort.

5. Klicka på Ta bort i bekräftelsedialogrutan.

SQL

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

DROP SHARE [IF EXISTS] <share-name>;

CLI

Kör följande kommando med hjälp av Databricks CLI.

databricks shares delete <share-name>