Dataontvangers maken voor OpenSharing (Databricks-to-Databricks-gegevensdeling)

Op deze pagina wordt uitgelegd hoe u ontvangers maakt in OpenSharing, wanneer de geadresseerden zich in een Databricks-werkruimte bevinden die is ingeschakeld voor Unity Catalog. Zie Gegevensontvangers beheren voor OpenSharing als u toegang wilt weergeven, bijwerken, verwijderen, delen wilt verlenen, eigenschappen wilt beheren of de toegang wilt beperken met IP-lijsten voor een bestaande ontvanger.

Een ontvanger is het benoemde object dat de identiteit vertegenwoordigt van een gebruiker of groep gebruikers die gedeelde gegevens gebruiken. Hoe u ontvangers aanmaakt, verschilt afhankelijk van of uw ontvanger toegang heeft tot een Databricks-werkruimte die Unity Catalog heeft ingeschakeld.

Zie Databricks-to-Open sharing versus Databricks-to-Databricks sharing voor meer informatie over deze twee manieren van delen en wanneer u welke moet kiezen.

Requirements

Een geadresseerde maken:

  • U moet over de CREATE RECIPIENT bevoegdheid beschikken voor de Unity Catalog-metastore waar de gegevens die u wilt delen, zijn geregistreerd.
  • U moet de ontvanger maken met behulp van een Azure Databricks-werkruimte waaraan de Unity Catalog-metastore is gekoppeld.
  • Als u een Databricks-notebook gebruikt om de ontvanger te maken, moet uw berekening gebruikmaken van Databricks Runtime 11.3 LTS of hoger en de standaard- of toegewezen toegangsmodus (voorheen gedeelde en modus voor toegang tot één gebruiker).

Zie Gegevensontvangers beheren voor OpenSharing voor de machtigingen die zijn vereist voor andere bewerkingen voor gegevensontvangers (weergeven, bijwerken, verwijderen, deeltoegang verlenen, eigenschappen beheren).

Een ontvangerobject maken voor gebruikers die toegang hebben tot Databricks (Databricks-to-Databricks delen)

Als uw gegevensontvanger toegang heeft tot een Databricks-werkruimte die is ingeschakeld voor Unity Catalog, kunt u een ontvangerobject maken met een verificatietype van DATABRICKS.

Een ontvangerobject met het verificatietype van DATABRICKS vertegenwoordigt een gegevensontvanger in een bepaalde Unity Catalog-metastore, geïdentificeerd in de definitie van het ontvangerobject door een tekenreeks voor het delen van id's die bestaat uit de cloud, regio en UUID van de metastore. De gegevens die met deze geadresseerde worden gedeeld, kunnen alleen worden geopend in die metastore.

Stap 1: Vraag de deel-id van de geadresseerde aan

Vraag een ontvangende gebruiker om u de identificatiecode voor delen te sturen voor de Unity Catalog-metastore die is gekoppeld aan de werkruimten waar de ontvangende gebruiker of gebruikersgroep met de gedeelde gegevens zal werken.

Deelidentificator is een tekenreeks die bestaat uit de cloud, regio en unieke identificator van de metastore, opgemaakt als <cloud>:<region>:<uuid>.

In de volgende schermafbeelding is de tekenreeks voor de volledige deeldentificatie bijvoorbeeld aws:us-west-2:19a84bee-54bc-43a2-87de-023d0ec16016.

voorbeeld van CURRENT_METASTORE

De ontvanger kan de identificatie vinden met behulp van Catalog Explorer, de Databricks Unity Catalog CLI of de standaard SQL-functie CURRENT_METASTORE in een Databricks-notebook of Databricks SQL-query die wordt uitgevoerd op een Unity Catalog-compatibele rekenkracht binnen de werkruimte die ze willen gebruiken.

Catalogusverkenner

Deel-ID opvragen met behulp van Catalog Explorer:

  1. Klik in uw Azure Databricks werkruimte op Gegevenspictogram.Catalog.

  2. Klik bovenaan het deelvenster Catalogus op het tandwielpictogram. en selecteer OpenSharing.

    U kunt ook in de rechterbovenhoek op OpenSharing delen >klikken.

  3. Klik op het tabblad Gedeeld met mij, klik op de naam van de Databricks deelorganisatie in de rechterbovenhoek, en selecteer Deler-identificatie kopiëren.

SQL

Voer de volgende opdracht uit in een notebook of de Sql-queryeditor van Databricks:

SELECT CURRENT_METASTORE();

CLI (Command Line Interface)

Voer de volgende opdracht uit met behulp van de Databricks CLI. De deel-identificator wordt teruggegeven als de global_metastore_id.

databricks metastores summary

U kunt de geadresseerde de informatie in deze stap verzenden, of u kunt hen verwijzen naar het gedeelte Toegang krijgen in het Databricks-naar-Databricks-model.

Stap 2: de ontvanger maken

Als u een ontvanger wilt maken voor het delen van Databricks-naar-Databricks, kunt u Catalog Explorer, de Databricks Unity Catalog CLI of de CREATE RECIPIENT SQL-opdracht gebruiken in een Azure Databricks-notebook of de Databricks SQL-queryeditor.

Vereiste machtigingen: Metastore-beheerder of gebruiker met de bevoegdheid voor de CREATE RECIPIENT Unity Catalog-metastore waarin de gegevens die u wilt delen, zijn geregistreerd.

Catalogusverkenner

  1. Klik in uw Azure Databricks werkruimte op Gegevenspictogram.Catalog.

  2. Klik bovenaan het deelvenster Catalogus op het tandwielpictogram. en selecteer OpenSharing.

    U kunt ook in de rechterbovenhoek op OpenSharing delen >klikken.

  3. Klik op het tabblad Gedeeld door mij op Nieuwe geadresseerde.

  4. Voer de naam van de ontvanger in.

  5. Selecteer Databricks-voor type geadresseerde.

  6. Voer de id voor delen van de geadresseerde in.

    Gebruik de volledige gedeelde identificatiestring in het formaat <cloud>:<region>:<uuid>. Bijvoorbeeld: aws:us-west-2:19a84bee-54bc-43a2-87de-023d0ec16016.

  7. (Optioneel) Voer een opmerking in.

  8. Klik op Create.

  9. (Optioneel) Maak aangepaste eigenschappen voor geadresseerden.

    Klik op het pictogram Bewerken naast Edit iconOntvangerseigenschappenop het tabblad Overzicht. Voeg vervolgens een eigenschapsnaam (sleutel) en waarde toe. Zie Eigenschappen van geadresseerden beheren voor meer informatie.

SQL

Voer de volgende opdracht uit in een notebook of de Sql-queryeditor van Databricks:

CREATE RECIPIENT [IF NOT EXISTS] <recipient-name>
USING ID '<sharing-identifier>'
[COMMENT "<comment>"];

Gebruik de volledige gedeelde identificatiestring in het formaat <cloud>:<region>:<uuid>. Bijvoorbeeld: aws:eu-west-1:g0c979c8-3e68-4cdf-94af-d05c120ed1ef.

U kunt ook aangepaste eigenschappen toevoegen voor de geadresseerde. Zie Eigenschappen van geadresseerden beheren voor meer informatie.

CLI (Command Line Interface)

Voer de volgende opdracht uit met behulp van de Databricks CLI. Vervang de waarden van de tijdelijke aanduidingen:

  • <recipient-name>: De naam van de geadresseerde.
  • <sharing-identifier>: De volledige deler-identificatiestring in de indeling <cloud>:<region>:<uuid>. Bijvoorbeeld: aws:eu-west-1:g0c979c8-3e68-4cdf-94af-d05c120ed1ef.
  • <authentication-type>: Ingesteld op DATABRICKS wanneer een tekenreeks voor het delen van id's in de indeling <cloud>:<region>:<uuid> wordt opgegeven <sharing-identifier>.
databricks recipients create <recipient-name> <authentication-type> --sharing-code <sharing-identifier>

U kunt ook aangepaste eigenschappen toevoegen voor de geadresseerde. Zie Eigenschappen van geadresseerden beheren voor meer informatie.

De ontvanger wordt gemaakt met de authentication_type van DATABRICKS.

Aanvullende informatiebronnen