Dela via

Hantera Delta Sharing providers (för data recipients)

  • Artikel

Den här artikeln beskriver hur du använder Unity Catalog till att get information om data providers som delar data med dig genom Delta Sharing. 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 recipients aldrig behöver göra.

Viktigt!

Data recipients måste ha åtkomst till en Databricks-arbetsyta som är aktiverad för Unity-Catalog för att kunna använda funktionerna som beskrivs i den här artikeln. Den här artikeln gäller inte för recipients som inte har Unity Catalog-aktiverade arbetsytor.

Behöver recipients 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 en mottagares 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 recipients 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.

Kommentar

Om du är den sällsynta mottagaren på Unity Catalog som tar emot data från en leverantör som inte delar data från en Unity Catalog-aktiverad Databricks-arbetsyta kanske du vill skapa leverantörobjekt i Unity Catalog så att du kan hantera den delade datan med Unity Catalog. Om du är i den kategorin kan du använda POST /api/2.1/unity–catalog/providers REST API-anrop eller Databricks CLI- för att skapa Unity Catalog-providerobjektet. Du måste vara en metaarkivadministratör eller användare med CREATE_PROVIDER behörigheten för metaarkivet.

Innan du börjar

Så här hanterar du providers 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 grant dig USE PROVIDER behörighet.
  • Om du vill skapa en provider måste du vara administratör för metaarkivet, eller så måste en metaarkivadministratör grant dig CREATE PROVIDER behörighet.
  • Om du vill update en provider måste du vara ägare till leverantörsobjektet och ha CREATE PROVIDER behörighet. Mer information finns i Update, en leverantör (byt namn, ändra ägare, kommentera).

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

Visa providers

Om du vill visa en list med tillgängliga data providerskan du använda Catalog Explorer, Databricks Unity Catalog CLI eller kommandot SHOW PROVIDERS SQL i en Azure Databricks-notebook-fil 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 tillgång till providers som de själva äger.

Catalog Explorer

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

  2. Högst upp i rutan Catalog klickar du på kugghjulsikonen och selectDelta Sharing.

    >.

  3. På fliken Delat med mig visar du alla tillgängliga providers.

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 kommandot DESCRIBE PROVIDER SQL 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:

  • Shares delas av leverantören (se Visa shares som en leverantör har delat med dig).
  • Providerns skapare, tidsstämpel för skapande, kommentarer och autentiseringstyp (TOKEN eller DATABRICKS). TOKEN representerar providers som har delat data med dig med hjälp av Delta Sharing-protokollet för öppen datadelning. DATABRICKS representerar providers 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 providerns Unity-Catalog metaarkiv.
  • Om leverantören använder öppen delning finns din mottagarprofilslutpunkt, där deltadelningsservern where är värd.

Catalog Explorer

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

  2. Längst upp i fönstret Catalog klickar du på kugghjulsikonen och sedan på selectDelta Sharing.

    >.

  3. På fliken Delat med mig letar du upp och select leverantören.

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 shares som en provider har delat med dig

Om du vill visa shares som en provider har delat med dig kan du använda Catalog Explorer, Databricks Unity Catalog CLI eller kommandot SHOW SHARES IN PROVIDER SQL 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.

Catalog Explorer

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

  2. Längst upp i rutan Catalog klickar du på kugghjulsikonen kugghjulsikonen och selectDelta Sharing.

    >.

  3. På fliken Delat med mig letar du upp och select 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>

Update en leverantör (byt namn, ändra ägare, kommentera)

Du kan använda Catalog Explorer, Databricks Unity Catalog CLI eller kommandot ALTER PROVIDER SQL 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 update ägaren. Du måste vara metaarkivadministratör (eller användare med CREATE_PROVIDER behörighet) och providerägare för att update providernamnet. Du måste vara ägare till att update kommentaren. Den första ägaren är metaarkivadministratören.

Catalog Explorer

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

  2. Längst upp i fönstret Catalog klickar du på kugghjulsikonen , sedan på kugghjulsikonen och till sist på selectDelta Sharing.

    >.

  3. På fliken Delat med mig letar du upp och select leverantören.

  4. På informationssidan update ägaren, kommentaren eller leverantörnamnet.

    Om du vill byta namn på en leverantör klickar du på menyn Kebab kebab och selectByt namn på.

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 kommandot DROP PROVIDER SQL i en Azure Databricks-notebook-fil 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.

Catalog Explorer

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

  2. Längst upp i fönstret Catalog klickar du på kugghjulsikonen och selectDelta Sharing.

    >.

  3. På fliken Delat med mig letar du upp och select leverantören.

  4. Klicka på kebab-menyn och välj selectTa 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.