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

Deze pagina legt uit hoe je ontvangers aanmaakt in OpenSharing, wanneer de ontvangers zich op een Azure 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. De manier waarop je ontvangers aanmaakt verschilt afhankelijk van of je ontvanger toegang heeft tot een Azure Databricks-werkruimte die is ingeschakeld voor de Unity Catalog:

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

Maak een ontvangerobject voor Azure Databricks-gebruikers

Als je dataontvanger toegang heeft tot een Azure Databricks-werkruimte die is ingeschakeld voor Unity Catalog, kun je een ontvangerobject aanmaken met het authenticatietype .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.

Om een ontvanger te maken voor Databricks-naar-Databricks delen, gebruik je de Catalog Explorer, de Databricks CLI of het CREATE RECIPIENT SQL-commando in een Azure Databricks-notebook of de Databricks SQL-queryeditor. Om een ontvanger aan te maken met de REST API, inclusief een e-mailontvanger, zie Een ontvanger aanmaken in de REST API-referentie.

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. Kies hoe je ontvanger toegang krijgt tot hun aandelen:

    • Delen via e-mail (Beta): Dit stuurt een e-mail naar de ontvanger, waarin hij wordt gevraagd in te loggen op zijn Azure Databricks-account en de gewenste metastore te selecteren. De ontvanger moet inloggen met een Azure Databricks-account dat het uitgenodigde e-mailadres gebruikt. Voor meer informatie en beperkingen, zie e-maildelen.

      1. Voer de naam van de ontvanger in.
      2. Voer het e-mailadres van de geadresseerde in.
      3. Voor Configureren hoe deze gegevensshare kan worden gebruikt selecteert u Elke ondersteunde OpenSharing-client of Beperken tot Databricks-ontvangers. Elke ondersteunde OpenSharing-client stelt je ontvanger in staat een inloggegevensbestand te downloaden en toegang te krijgen tot de share op Azure Databricks.
      4. (Optioneel) Onder Toegestane metastores (via sharing ID) klik je op Metastore toevoegen en voer je een delingsidentificatie in om te beperken welke Azure Databricks metastores de uitnodiging kunnen accepteren.

      Note

      Wanneer je een ontvanger aan een share toevoegt, stuurt OpenSharing de ontvanger een beveiligde activatielink per e-mail en stuurt elke keer dat je deze aan een andere share toevoegt een nieuwe e-mail. Het opnieuw toekennen van een aandeel dat een ontvanger al heeft, veroorzaakt geen dubbele e-mail. Zie Toegang tot OpenSharing-datashares beheren (voor aanbieders).

    • Delen met deelidentificatie: Je moet om de deelidentificatie van de ontvanger vragen en invoeren.

      1. Voer de naam van de ontvanger in.

      2. Selecteer Databricks-voor type geadresseerde.

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

      4. (Optioneel) Voer een opmerking in.

  5. Klik op Create.

  6. (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

  • Laatst bijgewerkt om