Hantera resurser för OpenSharing

Den här sidan beskriver hur du visar, uppdaterar och tar bort befintliga OpenSharing-resurser i Azure Databricks. En share är ett skyddsbart objekt i Unity Catalog som samlar tabeller, vyer, volymer, notebooks, AI-modeller och andra datatillgångar som delas med en eller flera mottagare.

Information om hur du skapar en ny resurs eller lägger till datatillgångar i en befintlig resurs finns i Skapa resurser för OpenSharing. Information om hur du beviljar en mottagare åtkomst till en resurs finns i Hantera åtkomst till OpenSharing-dataresurser (för leverantörer). Information om hur du hanterar de datamottagare som du delar med finns i Hantera datamottagare för OpenSharing.

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

Requirements

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

Visa resurser och dela information

Kontrollera 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 OpenSharing.

   Du kan också, från sidan Snabbåtkomst, klicka på knappen OpenSharing >.

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

Kontrollera 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 OpenSharing.

   Alternativt klickar du på knappen OpenSharing > på sidan Snabbåtkomst.

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

Kontrollera 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 delningar använder du Catalog Explorer, Databricks Unity Catalog CLI eller SQL-kommandon i en Azure Databricks anteckningsbok eller Databricks SQL-frågeredigerare. 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 OpenSharing.

   Alternativt kan du på sidan Snabbåtkomst klicka på knappen OpenSharing >.

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 aktieä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. Kontrollera att du uppfyller kraven innan du tar bort ett resursobjekt.

För att ta bort en delning använder du Catalog Explorer, Databricks Unity Catalog CLI, eller SQL-kommandot DELETE SHARE i en Azure Databricks notebook-fil 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 OpenSharing.

   Du kan också, på sidan Snabbåtkomst, klicka på knappen OpenSharing >.

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>