Hantera deltadelningsleverantörer (för datamottagare)

Den här artikeln beskriver hur du använder Unity Catalog för att hämta information om dataleverantörer som delar data med dig med deltadelning. Den beskriver också vad ett providerobjekt är och när du kan behöva skapa ett providerobjekt i ditt Unity Catalog-metaarkiv, en uppgift som de flesta mottagare aldrig behöver göra.

Behöver mottagarna skapa providerobjekt?

I Deltadelning på Databricks kan termen "provider" innebära både den organisation som delar data med dig och ett skyddsbart objekt i mottagarens Unity Catalog-metaarkiv som representerar den organisationen. Förekomsten av det skyddsbara objektet i en mottagares Unity Catalog-metaarkiv gör det möjligt för mottagarna att hantera teamets åtkomst till delade data med hjälp av Unity Catalog.

Som mottagare med åtkomst till ett Unity Catalog-metaarkiv behöver du vanligtvis inte skapa providerobjekt. Det beror på att data ska delas med dig med databricks-till-Databricks-delning, och providerobjekt skapas automatiskt i ditt Unity Catalog-metaarkiv.

Innan du börjar

Så här hanterar du leverantörer på din Azure Databricks-arbetsyta:

• Arbetsytan måste vara aktiverad för Unity Catalog.
• Om du vill visa en provider måste du vara administratör för metaarkivet, eller så måste en metaarkivadministratör ge dig behörigheten USE PROVIDER .
• Om du vill skapa en provider måste du vara administratör för metaarkivet, eller så måste en metaarkivadministratör ge dig behörigheten CREATE PROVIDER .
• Om du vill uppdatera en provider måste du vara ägare till providerobjektet och ha behörigheten CREATE PROVIDER . Mer information finns i Uppdatera en provider (byt namn, ändra ägare, kommentera).

Om din arbetsyta därför skapades utan en metaarkivadministratör måste en Azure Databricks-kontoadministratör ge en användare eller grupp rollen som administratör för metaarkivet innan du kan arbeta med providerobjekt i Azure Databricks. Se Automatisk aktivering av Unity Catalog och (valfritt) Tilldela administratörsrollen metaarkiv.

Visa leverantörer

Om du vill visa en lista över tillgängliga dataprovidrar kan du använda Catalog Explorer, Databricks Unity Catalog CLI eller SHOW PROVIDERS SQL-kommandot i en Azure Databricks-anteckningsbok eller Databricks SQL-frågeredigeraren.

Behörigheter som krävs: Du måste vara metaarkivadministratör eller ha USE PROVIDER behörighet att visa alla providers i metaarkivet. Andra användare har endast åtkomst till de leverantörer som de äger.

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 Deltadelning > på sidan Snabbåtkomst.

3. På fliken Delat med mig visar du alla tillgängliga leverantörer.

SQL

Kör följande kommando i en notebook-fil eller Databricks SQL-frågeredigeraren. Alternativt kan du ersätta <pattern> med ett LIKE predikat.

SHOW PROVIDERS [LIKE <pattern>];

CLI

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

databricks providers list

Visa providerinformation

Om du vill visa information om en provider kan du använda Catalog Explorer, Databricks Unity Catalog CLI eller DESCRIBE PROVIDER SQL-kommandot i en Azure Databricks-notebook-fil eller Databricks SQL-frågeredigeraren.

Behörigheter som krävs: Metaarkivadministratör, användare med USE PROVIDER behörigheten eller providerobjektägaren.

Information som ingår:

• Resurser som delas av providern (se Visa resurser som en provider har delat med dig).
• Providerns skapare, tidsstämpel för skapande, kommentarer och autentiseringstyp (TOKEN eller DATABRICKS). TOKEN representerar leverantörer som har delat data med dig med hjälp av deltadelningsprotokollet för öppen delning. DATABRICKS representerar leverantörer som har delat data med dig med hjälp av delningsprotokollet Databricks-till-Databricks.
• Om providern använder Databricks-till-Databricks-delning: moln-, region- och metaarkiv-ID för leverantörens Unity Catalog-metaarkiv.
• Om providern använder öppen delning: slutpunkten för mottagarprofilen, som är platsen där delningsservern för deltadelning finns.

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 Deltadelning > på sidan Snabbåtkomst.

3. På fliken Delat med mig letar du upp och väljer providern.

SQL

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

DESC PROVIDER <provider-name>;

CLI

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

databricks providers get <provider-name>

Visa resurser som en provider har delat med dig

Om du vill visa de resurser som en provider har delat med dig kan du använda Catalog Explorer, Databricks Unity Catalog CLI eller SHOW SHARES IN PROVIDER SQL-kommandot i en Azure Databricks-notebook-fil eller Databricks SQL-frågeredigeraren.

Behörigheter som krävs: Metaarkivadministratör, användare med USE PROVIDER behörigheten eller providerobjektägaren.

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 Deltadelning > på sidan Snabbåtkomst.

3. På fliken Delat med mig letar du upp och väljer providern.

SQL

Kör följande kommando i en notebook-fil eller Databricks SQL-frågeredigeraren. Alternativt kan du ersätta <pattern> med ett LIKE predikat.

SHOW SHARES IN PROVIDER [LIKE <pattern>];

CLI

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

 databricks providers list-shares <provider-name>

Uppdatera en provider (byt namn, ändra ägare, kommentera)

Du kan använda Catalog Explorer, Databricks Unity Catalog CLI eller ALTER PROVIDER SQL-kommandot i en Azure Databricks-notebook-fil eller Databricks SQL-frågeredigeraren för att ändra providerobjektet i ditt Unity Catalog-metaarkiv:

• Byt namn på providern för att ändra hur användarna ser providerobjektet i sina Databricks-gränssnitt.
• Ändra providerobjektets ägare.
• Lägg till eller ändra kommentarer.

Behörigheter som krävs: Du måste vara ägare till providerobjektet för att uppdatera ägaren. Du måste vara metaarkivadministratör (eller användare med behörighet) CREATE_PROVIDER och providerägare för att uppdatera providernamnet. Du måste vara ägare till att uppdatera kommentaren. Den första ägaren är metaarkivadministratören.

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 Deltadelning > på sidan Snabbåtkomst.

3. På fliken Delat med mig letar du upp och väljer providern.

4. Uppdatera ägaren, kommentaren eller providernamnet på informationssidan.

   Om du vill byta namn på en provider klickar du på menyn för kebab och väljer Byt namn.

SQL

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

ALTER PROVIDER <provider-name> RENAME TO <new-provider-name>
OWNER TO <new-owner>
COMMENT "<comment>";

CLI

Kör följande kommando med hjälp av Databricks CLI. Ersätt <provider-name> med det aktuella providernamnet och <new-provider-name> med det nya namnet.

databricks providers update <provider-name> /
--new-name <new-provider-name> /
--comment "<new comment>" /
--owner <new-owner-name>

Ta bort en provider

Om du vill ta bort en provider kan du använda Catalog Explorer, Databricks Unity Catalog CLI eller DROP PROVIDER SQL-kommandot i en Azure Databricks-anteckningsbok eller Databricks SQL-frågeredigeraren. Du måste vara providerobjektägaren för att kunna ta bort providern.

När du tar bort en provider kan du och användarna i din organisation (mottagaren) inte längre komma åt de data som delas av providern.

Behörigheter som krävs: Providerobjektägare.

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 Deltadelning > på sidan Snabbåtkomst.

3. På fliken Delat med mig letar du upp och väljer providern.

4. Klicka på menyn för kebab 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 PROVIDER [IF EXISTS] <provider-name>;

CLI

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

databricks providers delete <provider-name>

Om åtgärden lyckas returneras inga resultat.