Delen via

Delta Sharing-providers beheren (voor gegevens recipients)

  • Artikel

In dit artikel wordt beschreven hoe u Unity Catalog gebruikt om informatie te get over gegevens providers te verkrijgen van wie gegevens met u delen via Delta Sharing. Ook wordt beschreven wat een providerobject is en wanneer u mogelijk een providerobject moet maken in uw Unity-Catalog metastore, een taak die de meeste recipients nooit hoeft te doen.

Belangrijk

Gegevens recipients moeten toegang hebben tot een Databricks-werkruimte die is ingeschakeld voor Unity-Catalog om de functionaliteit te kunnen gebruiken die in dit artikel wordt beschreven. Dit artikel is niet van toepassing op recipients die geen Unity Catalog-enabled werkruimten hebben.

Moet recipients providerobjecten maken?

In Delta Sharing op Databricks kan de term 'provider' betekenen dat zowel de organisatie die gegevens met u deelt als een beveiligbaar object in de Unity-Catalog-metastore van een ontvanger die die organisatie vertegenwoordigt. Het bestaan van dat beveiligbare object in de Unity-Catalog-metastore van een geadresseerde stelt recipients in staat om de toegang van hun team tot gedeelde gegevens te beheren met behulp van Unity Catalog.

Als ontvanger met toegang tot een Unity Catalog metastore hoeft u doorgaans geen providerobjecten te maken. Dit komt doordat gegevens met u gedeeld moeten worden via Databricks-naar-Databricks-delingen providerobjecten automatisch in uw Unity Catalog metastore worden gemaakt.

Notitie

Als u de zeldzame ontvanger bent op Unity Catalog die gegevens ontvangt van een provider die niet deelt vanuit een Databricks-werkruimte met Unity Catalog, kunt u providerobjecten maken in Unity Catalog, zodat u die gedeelde gegevens kunt beheren met behulp van Unity Catalog. Als u zich in die categorie bevindt, kunt u de POST /api/2.1/unity-catalog/providers REST API-aanroep of de Databricks CLI gebruiken om het Unity Catalog-providerobject te maken. U moet een metastore-beheerder of gebruiker zijn met de CREATE_PROVIDER bevoegdheid voor de metastore.

Voordat u begint

Ga als volgende te werk om providers te beheren in uw Azure Databricks-werkruimte:

  • Uw werkruimte moet geactiveerd zijn voor Unity Catalog.
  • Als u een provider wilt weergeven, moet u een metastore-beheerder zijn of moet een metastore-beheerder u de USE PROVIDER-bevoegdheid grant.
  • Als u een provider wilt maken, moet u een metastore-beheerder zijn of moet een metastore-beheerder u de CREATE PROVIDER-bevoegdheid grant.
  • Als u een provider wilt update, moet u de eigenaar van het provider-object zijn en over de bevoegdheid CREATE PROVIDER beschikken. Zie Update een provider (naam wijzigen, eigenaar wijzigen, opmerking)voor meer informatie.

Als uw werkruimte daarom is gemaakt zonder een metastore-beheerder, moet een Azure Databricks-accountbeheerder een gebruiker of groep de beheerdersrol van de metastore grant voordat u met providerobjecten in Azure Databricks kunt werken. Zie Automatische inschakeling van Unity Catalog en (optioneel) De metastore-adminrol toewijzen.

providers weergeven

Als u een list met beschikbare gegevens providerswilt weergeven, kunt u Catalog Explorer, de Databricks Unity Catalog CLI of de SHOW PROVIDERS SQL-opdracht gebruiken in een Azure Databricks-notebook of de Databricks SQL-queryeditor.

vereiste machtigingen: u moet een metastore-beheerder zijn of de USE PROVIDER bevoegdheid hebben om alle providers in de metastore weer te geven. Andere gebruikers hebben alleen toegang tot de providers die ze bezitten.

Catalog Explorer

  1. Klik in uw Azure Databricks-werkruimte op Catalog pictogramCatalog.

  2. Klik bovenaan in het deelvenster Catalog op het tandwielpictogram en selectDelta Sharing.

    U kunt ook op de pagina Snelle toegang klikken op de knop Delta delen > .

  3. Op het tabblad Gedeeld met mij kunt u alle beschikbare providersbekijken.

SQL

Voer de volgende opdracht uit in een notebook of de Sql-query-editor van Databricks. Vervang desgewenst door <pattern> een LIKE predicaat.

SHOW PROVIDERS [LIKE <pattern>];

CLI

Voer de volgende opdracht uit met behulp van de Databricks CLI.

databricks providers list

Details van provider weergeven

Als u details over een provider wilt bekijken, kunt u Catalog Explorer, de Databricks Unity Catalog CLI of de DESCRIBE PROVIDER SQL-opdracht gebruiken in een Azure Databricks-notebook of de Databricks SQL-queryeditor.

Vereiste machtigingen: Metastore-beheerder, gebruiker met de USE PROVIDER bevoegdheid of de eigenaar van het providerobject.

Details omvatten:

  • Shares gedeeld door de provider (zie shares weergeven die een provider met u heeft gedeeld).
  • De maker van de provider, het tijdstempel voor het maken, opmerkingen en verificatietype (TOKEN of DATABRICKS). TOKEN vertegenwoordigt providers die gegevens met u hebben gedeeld met behulp van het open sharing-protocol van Delta Sharing. DATABRICKS vertegenwoordigt providers die gegevens met u hebben gedeeld met behulp van het Databricks-to-Databricks-sharing-protocol.
  • Als de provider Databricks-to-Databricks deelt: de cloud-, regio- en metastore-id van de Unity-Catalog-metastore van de provider.
  • Als de provider open delen gebruikt: het eindpunt van uw profiel, waar de where Delta Sharing server wordt gehost.

Catalog Explorer

  1. Klik in uw Azure Databricks-werkruimte op Catalog pictogramCatalog.

  2. Klik bovenaan het deelvenster Catalog op het tandwielpictogram en vervolgens op selectDelta Sharing.

    U kunt ook op de pagina Snelle toegang klikken op de knop Delta delen > .

  3. Zoek op het tabblad Gedeeld met mij de provider en select.

SQL

Voer de volgende opdracht uit in een notebook of de Sql-query-editor van Databricks.

DESC PROVIDER <provider-name>;

CLI

Voer de volgende opdracht uit met behulp van de Databricks CLI.

databricks providers get <provider-name>

shares weergeven die een provider met u heeft gedeeld

Als u de shares wilt bekijken die een provider met u heeft gedeeld, kunt u Catalog Explorer, de Databricks Unity Catalog CLI of de SHOW SHARES IN PROVIDER SQL-opdracht gebruiken in een Azure Databricks-notebook of de Databricks SQL-queryeditor.

Vereiste machtigingen: Metastore-beheerder, gebruiker met de USE PROVIDER bevoegdheid of de eigenaar van het providerobject.

Catalog Explorer

  1. Klik in uw Azure Databricks-werkruimte op Catalog pictogramCatalog.

  2. Klik boven aan het deelvenster op het tandwielpictogram tandwielpictogram en Delta Sharing-.

    U kunt ook op de pagina Snelle toegang klikken op de knop Delta delen > .

  3. Zoek op het tabblad Gedeeld met mij de provider en select.

SQL

Voer de volgende opdracht uit in een notebook of de Sql-query-editor van Databricks. Vervang desgewenst door <pattern> een LIKE predicaat.

SHOW SHARES IN PROVIDER [LIKE <pattern>];

CLI

Voer de volgende opdracht uit met behulp van de Databricks CLI.

 databricks providers list-shares <provider-name>

Update een provider (naam wijzigen, eigenaar wijzigen, opmerking)

U kunt Catalog Explorer, de Databricks Unity Catalog CLI of de ALTER PROVIDER SQL-opdracht gebruiken in een Azure Databricks-notebook of de Databricks SQL-queryeditor om het providerobject in uw Unity-Catalog-metastore te wijzigen:

  • Wijzig de naam van de provider om de manier te wijzigen waarop gebruikers het providerobject in hun Databricks-interfaces zien.
  • Wijzig de eigenaar van het providerobject.
  • Opmerkingen toevoegen of wijzigen.

Vereiste machtigingen: U moet de eigenaar van het provider-object zijn om de eigenaar te update. U moet een metastore-beheerder (of gebruiker met de bevoegdheid CREATE_PROVIDER) en providereigenaar zijn om de naam van de provider te update. U moet de eigenaar zijn om de opmerking te doen update. De initiële eigenaar is de metastore-beheerder.

Catalog Explorer

  1. Klik in uw Azure Databricks-werkruimte op Catalog pictogramCatalog.

  2. Klik boven aan het deelvenster op het tandwielpictogram tandwielpictogram en Delta Sharing-.

    U kunt ook op de pagina Snelle toegang klikken op de knop Delta delen > .

  3. Op het tabblad Gedeeld met mij zoek je de provider en select.

  4. Op de detailpagina update de eigenaar, opmerking of providernaam.

    Als u de naam van een provider wilt wijzigen, klikt u op het kebabmenu en selectNaam wijzigen.

SQL

Voer de volgende opdracht uit in een notebook of de Sql-query-editor van Databricks.

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

CLI

Voer de volgende opdracht uit met behulp van de Databricks CLI. Vervang <provider-name> door de naam van de huidige provider en <new-provider-name> door de nieuwe naam.

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

Een provider verwijderen

Als u een provider wilt verwijderen, kunt u Catalog Explorer, de Databricks Unity Catalog CLI of de DROP PROVIDER SQL-opdracht gebruiken in een Azure Databricks-notebook of de Databricks SQL-queryeditor. U moet de eigenaar van het providerobject zijn om de provider te verwijderen.

Wanneer u een provider verwijdert, hebben u en de gebruikers in uw organisatie (de ontvanger) geen toegang meer tot de gegevens die door de provider worden gedeeld.

Vereiste machtigingen: eigenaar van providerobject.

Catalog Explorer

  1. Klik in uw Azure Databricks-werkruimte op Catalog pictogramCatalog.

  2. Klik bovenaan het deelvenster Catalog op het tandwielpictogram en selectDelta Sharing.

    U kunt ook op de pagina Snelle toegang klikken op de knop Delta delen > .

  3. Zoek op het tabblad Gedeeld met mij de provider en select.

  4. Klik op het Kebab menu en selectVerwijderen.

  5. Klik in het bevestigingsvenster op Verwijderen.

SQL

Voer de volgende opdracht uit in een notebook of de Sql-query-editor van Databricks.

DROP PROVIDER [IF EXISTS] <provider-name>;

CLI

Voer de volgende opdracht uit met behulp van de Databricks CLI.

databricks providers delete <provider-name>

Als de bewerking is geslaagd, worden er geen resultaten geretourneerd.