Delta Sharing-providers beheren (voor gegevensontvangers)

In dit artikel wordt beschreven hoe u Unity Catalog gebruikt om informatie te krijgen over gegevensproviders die gegevens met u delen met behulp van 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 ontvangers nooit hoeven te doen.

Belangrijk

Gegevensontvangers 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 ontvangers die geen werkruimten met Unity Catalog hebben.

Moeten geadresseerden providerobjecten maken?

In Delta Sharing op Databricks kan de term 'provider' zowel de organisatie betekenen die gegevens met u deelt als een beveiligbaar object in de Unity Catalog-metastore van een geadresseerde die die organisatie vertegenwoordigt. Het bestaan van dat beveiligbare object in de Unity Catalog-metastore van een geadresseerde stelt ontvangers 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 moeten worden gedeeld met databricks-to-Databricks en providerobjecten automatisch worden gemaakt in uw Unity Catalog-metastore.

Notitie

Als u de zeldzame ontvanger bent in 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 REST API-aanroep POST /api/2.1/unity-catalog/providers 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.

Providers weergeven

Als u een lijst met beschikbare gegevensproviders wilt 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 beschikken over de USE PROVIDER bevoegdheid om alle providers in de metastore weer te geven. Andere gebruikers hebben alleen toegang tot de providers die ze bezitten.

Catalogusverkenner

1. Klik in uw Azure Databricks-werkruimte op Catalogus.
2. Vouw in het linkerdeelvenster het menu Delta delen uit en selecteer Gedeeld met mij.
3. Bekijk op het tabblad Providers alle beschikbare providers.

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 weergeven, 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 die door de provider worden gedeeld (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 met u gegevens hebben gedeeld met behulp van het open sharing-protocol voor 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 geadresseerdeprofiel. Dit is de locatie waar de Delta Sharing-server wordt gehost.

Catalogusverkenner

1. Klik in uw Azure Databricks-werkruimte op Catalogus.
2. Vouw in het linkerdeelvenster het menu Delta delen uit en selecteer Gedeeld met mij.
3. Zoek en selecteer de provider op het tabblad Providers .
4. Bekijk providerdetails op het tabblad Details .

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 weergeven 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.

Catalogusverkenner

1. Klik in uw Azure Databricks-werkruimte op Catalogus.
2. Vouw in het linkerdeelvenster het menu Delta delen uit en selecteer Gedeeld met mij.
3. Selecteer op het tabblad Providers de provider waarvan u de shares wilt weergeven.

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>

Een provider bijwerken (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 een metastore-beheerder of eigenaar van het providerobject zijn om de eigenaar bij te werken. U moet een metastore-beheerder (of gebruiker met de CREATE_PROVIDER bevoegdheid) en de eigenaar van de provider zijn om de providernaam bij te werken. U moet de eigenaar zijn om de opmerking bij te werken. De initiële eigenaar is de metastore-beheerder.

Catalogusverkenner

1. Klik in uw Azure Databricks-werkruimte op Catalogus.
2. Vouw in het linkerdeelvenster het menu Delta delen uit en selecteer Gedeeld met u.
3. Zoek en selecteer de provider op het tabblad Providers .
4. Werk op de detailpagina de naam van de eigenaar, opmerking of provider bij.

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.

Catalogusverkenner

1. Klik in uw Azure Databricks-werkruimte op Catalogus.
2. Vouw in het linkerdeelvenster het menu Delta delen uit en selecteer Gedeeld met u.
3. Zoek en selecteer de provider op het tabblad Providers .
4. Klik ophetmenu (ook wel bekend als het menu met drie puntjes) en selecteer Verwijderen.
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.