Delen via


Gegevensontvangers creëren en beheren voor Delta Sharing (Databricks-naar-Databricks uitwisseling)

Op deze pagina wordt uitgelegd hoe u ontvangers maakt en beheert in Delta Sharing, wanneer de geadresseerden zich in een Databricks-werkruimte bevinden die is ingeschakeld voor Unity Catalog.

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.

Voor meer informatie over deze twee deelmodi en wanneer u welke moet kiezen, zie Delen openen versus Databricks-naar-Databricks delen.

Vereisten

Een geadresseerde maken:

  • U moet een metastore-beheerder zijn of beschikken over de CREATE RECIPIENT bevoegdheid voor de Unity Catalog-metastore waarin 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 de machtigingseisen die worden vermeld in de bewerkingsspecifieke secties van dit artikel voor andere beheer van ontvangers (zoals weergeven, verwijderen, bijwerken en ontvangerstoegang geven tot een share).

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 het pictogram Gegevens.Catalogus.

  2. Klik bovenaan het deelvenster Catalogus op het tandwielpictogram en selecteer Delta Sharing.

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

  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 het pictogram Gegevens.Catalogus.

  2. Klik bovenaan het deelvenster Catalogus op het tandwielpictogram en selecteer Delta Sharing.

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

  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) Aangepaste eigenschappen voor geadresseerden maken.

    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.

De ontvanger toegang verlenen tot een share

Nadat u de ontvanger hebt gemaakt en shares hebt gemaakt, kunt u de ontvanger toegang verlenen tot deze shares.

Als u sharetoegang wilt verlenen aan ontvangers, kunt u Catalog Explorer, de Databricks Unity Catalog CLI of de GRANT ON SHARE SQL-opdracht gebruiken in een Azure Databricks-notebook of de Databricks SQL-queryeditor.

Vereiste machtigingen: een van de volgende:

  • Metastore-beheerder.
  • Gedelegeerde machtigingen of eigendom voor zowel de share- als de ontvangerobjecten ((USE SHARE + SET SHARE PERMISSION) of de eigenaar van de share) EN (USE RECIPIENT of de eigenaar van de ontvanger).

Zie Toegang tot Delta Sharing-gegevensshares beheren (voor providers) voor instructies.

Geadresseerden weergeven

Als u een lijst met geadresseerden wilt weergeven, kunt u Catalog Explorer, de Databricks Unity Catalog CLI of de SHOW RECIPIENTS SQL-opdracht gebruiken in een Azure Databricks-notebook of de Databricks SQL-queryeditor.

Vereiste machtigingen: u moet een metastore-beheerder zijn of de USE RECIPIENT bevoegdheid hebben om alle geadresseerden in de metastore weer te geven. Andere gebruikers hebben alleen toegang tot de geadresseerden waarvan ze de eigenaar zijn.

Catalogusverkenner

  1. Klik in uw Azure Databricks-werkruimte op het pictogram Gegevens.Catalogus.

  2. Klik bovenaan het deelvenster Catalogus op het tandwielpictogram en selecteer Delta Sharing.

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

  3. Klik op het tabblad Gedeeld door mij op Ontvangers.

SQL

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

SHOW RECIPIENTS [LIKE <pattern>];

CLI (Command Line Interface)

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

databricks recipients list

Details van geadresseerde weergeven

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

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

Details omvatten:

  • De maker, het aanmaak tijdstempel, de opmerkingen en het verificatietype (TOKEN of DATABRICKS) van de geadresseerde.
  • Als de ontvanger open delen gebruikt: de levensduur van het token, de activeringskoppeling, de activeringsstatus (of de referentie is gedownload) en IP-toegangslijsten, indien toegewezen.
  • Als de ontvanger gebruikmaakt van Databricks-to-Databricks-deling: de cloud, regio, metastore-ID van de Unity Catalog-metastore van de ontvanger, en de activeringsstatus.
  • Eigenschappen van geadresseerden, waaronder aangepaste eigenschappen. Zie Eigenschappen van geadresseerden beheren.

Catalogusverkenner

  1. Klik in uw Azure Databricks-werkruimte op het pictogram Gegevens.Catalogus.

  2. Klik bovenaan het deelvenster Catalogus op het tandwielpictogram en selecteer Delta Sharing.

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

  3. Klik op het tabblad Gedeeld door mij op Geadresseerden en selecteer de geadresseerde.

SQL

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

DESCRIBE RECIPIENT <recipient-name>;

CLI (Command Line Interface)

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

databricks recipients get <recipient-name>

De machtigingen van een ontvanger voor gedeelde bestanden weergeven

Als u de lijst met shares wilt weergeven waartoe een ontvanger toegang heeft, kunt u Catalog Explorer, de Databricks CLI of de SHOW GRANTS TO RECIPIENT SQL-opdracht gebruiken in een Azure Databricks-notebook of de Databricks SQL-query-editor.

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

Catalogusverkenner

  1. Klik in uw Azure Databricks-werkruimte op het pictogram Gegevens.Catalogus.

  2. Klik bovenaan het deelvenster Catalogus op het tandwielpictogram en selecteer Delta Sharing.

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

  3. Klik op het tabblad Gedeeld door mij op Geadresseerden en selecteer de geadresseerde.

  4. Ga naar het tabblad Shares om de lijst met gedeelde shares met de ontvanger weer te geven.

SQL

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

SHOW GRANTS TO RECIPIENT <recipient-name>;

CLI (Command Line Interface)

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

databricks recipients share-permissions <recipient-name>

Een geadresseerde bijwerken

Als u een ontvanger wilt bijwerken, kunt u Catalog Explorer, de Databricks Unity Catalog CLI of de ALTER RECIPIENT SQL-opdracht gebruiken in een Azure Databricks-notebook of de Databricks SQL-queryeditor.

Eigenschappen die u kunt bijwerken, zijn de naam van de geadresseerde, de eigenaar, de opmerking en de aangepaste eigenschappen.

Vereiste machtigingen: U moet een metastore-beheerder of eigenaar van het ontvangerobject zijn om de eigenaar bij te werken. U moet een metastore-beheerder (of gebruiker met de CREATE RECIPIENT bevoegdheid) en de eigenaar zijn om de naam bij te werken. U moet de eigenaar zijn om de opmerking of aangepaste eigenschappen bij te werken.

Catalogusverkenner

  1. Klik in uw Azure Databricks-werkruimte op het pictogram Gegevens.Catalogus.

  2. Klik bovenaan het deelvenster Catalogus op het tandwielpictogram en selecteer Delta Sharing.

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

  3. Klik op het tabblad Gedeeld door mij op Geadresseerden en selecteer de geadresseerde.

  4. Op de pagina met details van de geadresseerde:

    • Werk de eigenaar bij.

    • Een opmerking bewerken of toevoegen.

    • Wijzig de naam van de ontvanger.

      Klik op het Kebabmenu-pictogram. en selecteer Naam wijzigen.

    • Bewerk, verwijder of voeg aangepaste eigenschappen van geadresseerden toe.

      Klik op het Bewerkpictogram Bewerkpictogram naast eigenschappen van de geadresseerde. Voeg vervolgens een eigenschapsnaam (sleutel) en waarde toe. Zie Eigenschappen van geadresseerden beheren voor meer informatie.

    • Alleen ontvangers met token-authenticatie:

    • Alleen gefedereerde OIDC-geadresseerden:

      • Klik onder OIDC-federatiebeleidop Beleid toevoegen. Zie LINK.
      • Eindpunt van geadresseerde weergeven en kopiëren en MTLS-eindpunt van geadresseerde.

SQL

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

ALTER RECIPIENT <recipient-name> RENAME TO <new-recipient-name>;

ALTER RECIPIENT <recipient-name> OWNER TO <new-owner>;

COMMENT ON RECIPIENT <recipient-name> IS "<new-comment>";

ALTER RECIPIENT <recipient-name> SET PROPERTIES ( <property-key>  =  property_value [, ...] )

ALTER RECIPIENT <recipient-name> UNSET PROPERTIES ( <property-key> [, ...] )

Voor meer informatie over eigenschappen, zie Eigenschappen van geadresseerden beheren.

CLI (Command Line Interface)

Maak een JSON-bestand dat een update bevat van de naam van de geadresseerde, opmerking, eigenaar, IP-toegangslijst of aangepaste eigenschappen.

{
  "name": "new-recipient-name",
  "owner": "someone-else@example.com",
  "comment": "something new",
  "ip_access_list": {
    "allowed_ip_addresses": ["8.8.8.8", "8.8.8.4/10"]
  },
  "property": {
    "country": "us",
    "id": "001"
  }
}

Voer vervolgens de volgende opdracht uit met behulp van de Databricks CLI. Vervang door <recipient-name> de naam van de huidige geadresseerde en vervang deze door update-recipient-settings.json de bestandsnaam van het JSON-bestand.

databricks recipients update --json-file update-recipient-settings.json

Voor meer informatie over eigenschappen, zie Eigenschappen van geadresseerden beheren.

(Optioneel) Beperk toegang tot geadresseerden met toegangslijsten

U kunt de toegang van adressaten beperken tot een specifieke reeks IP-adressen wanneer u het ontvangerobject configureert. Zie Toegang van Delta Sharing-ontvangers beperken met IP-toegangslijsten (open delen).

Eigenschappen van geadresseerden beheren

Ontvangende objecten bevatten vooraf gedefinieerde eigenschappen die u kunt gebruiken om de toegang tot gegevensdeling te verfijnen. U kunt ze bijvoorbeeld gebruiken om het volgende te doen:

  • Deel verschillende tabelpartities met verschillende geadresseerden, zodat u dezelfde shares met meerdere geadresseerden kunt gebruiken terwijl u de gegevensgrenzen tussen deze geadresseerden behoudt.
  • Deel dynamische weergaven waarmee de toegang van geadresseerden tot tabelgegevens op rij- of kolomniveau wordt beperkt op basis van de eigenschappen van geadresseerden.

U kunt ook aangepaste eigenschappen maken.

De vooraf gedefinieerde eigenschappen beginnen met databricks. en bevatten het volgende:

  • databricks.accountId: het Azure Databricks-account waartoe een gegevensontvanger behoort (alleen voor Databricks-to-Databricks delen).
  • databricks.metastoreId: de Unity Catalog-metastore waartoe een gegevensontvanger behoort (alleen gegevensuitwisseling tussen Databricks-instanties).
  • databricks.name: De naam van de gegevensontvanger.

Aangepaste eigenschappen die van waarde kunnen zijn, kunnen bijvoorbeeld country omvatten. Als u bijvoorbeeld de aangepaste eigenschap 'country' = 'us' koppelt aan een geadresseerde, kunt u tabelgegevens partitioneren op land en alleen rijen delen met Amerikaanse gegevens met de geadresseerden waaraan die eigenschap is toegewezen. U kunt ook een dynamische weergave delen waarmee de toegang tot rijen of kolommen wordt beperkt op basis van de eigenschappen van geadresseerden. Voor meer gedetailleerde voorbeelden, zie Eigenschappen van geadresseerden gebruiken om partitiefiltering uit te voeren en Dynamische weergaven toevoegen aan een share om rijen en kolommen te filteren.

Vereisten

Eigenschappen van geadresseerden worden ondersteund in Databricks Runtime 12.2 en hoger.

Eigenschappen toevoegen wanneer u een geadresseerde maakt of bijwerkt

U kunt eigenschappen toevoegen wanneer u een geadresseerde maakt of bijwerkt voor een bestaande geadresseerde. U kunt Catalog Explorer, de Databricks Unity Catalog CLI of SQL-opdrachten gebruiken in een Azure Databricks-notebook of de Databricks SQL-queryeditor.

Vereiste machtigingen: Metastore-beheerder of gebruiker met de CREATE RECIPIENT bevoegdheid voor de Unity Catalog-metastore.

Catalogusverkenner

Wanneer u met behulp van Catalog Explorer een geadresseerde maakt of bijwerkt, voegt u aangepaste eigenschappen toe of werkt u deze als volgt bij:

  1. Ga naar de pagina Details van geadresseerde.

    Als u een nieuwe ontvanger maakt, komt u op deze pagina terecht nadat u op Maken hebt geklikt. Als u een bestaande geadresseerde bijwerkt, gaat u naar deze pagina door op het tandwielpictogram te klikken.tandwielpictogram > Delta Sharing > Shared by me > Recipients en de geadresseerde te selecteren.

  2. Klik op Eigenschappen > bewerken +Eigenschap toevoegen.

  3. Voer een eigenschapsnaam (sleutel) en waarde in.

    Als u bijvoorbeeld gedeelde gegevens wilt filteren op land en alleen Amerikaanse gegevens met deze ontvanger wilt delen, kunt u een sleutel met de naam 'land' maken met de waarde 'VS'.

  4. Klik op Opslaan.

SQL

Als u een aangepaste eigenschap wilt toevoegen wanneer u een ontvanger maakt, voert u de volgende opdracht uit in een notebook of de Sql-queryeditor van Databricks:

CREATE RECIPIENT [IF NOT EXISTS] <recipient-name>
[USING ID '<sharing-identifier>'] /* Skip this if you are using open sharing */
[COMMENT "<comment>"]
PROPERTIES ( '<property-key>' = '<property-value>' [, ...] );

<property-key> kan een letterlijke tekenreeks of id zijn. <property-value> moet een letterlijke tekenreeks zijn.

Voorbeeld:

CREATE RECIPIENT acme PROPERTIES ('country' = 'us', 'partner_id' = '001');

Als u aangepaste eigenschappen voor een bestaande geadresseerde wilt toevoegen, bewerken of verwijderen, voert u een van de volgende handelingen uit:

ALTER RECIPIENT <recipient-name> SET PROPERTIES ( '<property-key>' = '<property-value>' [, ...] );

ALTER RECIPIENT <recipient-name> UNSET PROPERTIES ( '<property-key>' );

CLI (Command Line Interface)

Als u aangepaste eigenschappen wilt toevoegen wanneer u een ontvanger maakt, voert u de volgende opdracht uit met behulp van de Databricks CLI. Vervang de waarden van de tijdelijke aanduidingen:

  • <recipient-name>: De naam van de geadresseerde.
  • <property-key> kan een letterlijke tekenreeks of id zijn.
  • <property-value> moet een letterlijke tekenreeks zijn.
databricks recipients create \
--json='{
  "name": "<recipient-name>",
  "properties_kvpairs": {
    "properties": {
      "<property-key>": "<property-value>",
    }
  }
}'

Voorbeeld:

databricks recipients create \
--json='{
  "name": "<recipient-name>",
  "properties_kvpairs": {
    "properties": {
      "country": "us",
      "partner_id":"001"
    }
  }
}'

Als u aangepaste eigenschappen voor een bestaande geadresseerde wilt toevoegen of bewerken, gebruikt update u in plaats van create:

databricks recipients update \
--json='{
  "name": "<recipient-name>",
  "properties_kvpairs": {
    "properties": {
      "country": "us",
      "partner_id":"001"
    }
  }
}'

Eigenschappen van geadresseerden weergeven

Als u de eigenschappen van geadresseerden wilt weergeven, volgt u de instructies in Details van geadresseerden weergeven.

Een geadresseerde verwijderen

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

Wanneer u een geadresseerde verwijdert, hebben de gebruikers die door de geadresseerde worden vertegenwoordigd, geen toegang meer tot de gedeelde gegevens. Tokens die ontvangers gebruiken in een scenario voor open delen worden ongeldig gemaakt.

Vereiste machtigingen: Eigenaar van het ontvangerobject.

Catalogusverkenner

  1. Klik in uw Azure Databricks-werkruimte op het pictogram Gegevens.Catalogus.

  2. Klik bovenaan het deelvenster Catalogus op het tandwielpictogram en selecteer Delta Sharing.

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

  3. Klik op het tabblad Gedeeld door mij op Geadresseerden en selecteer de geadresseerde.

  4. Zoek en selecteer de geadresseerde op het tabblad Geadresseerden .

  5. Klik op het kebabmenu-pictogram. Selecteer Verwijderen.

  6. Klik in het bevestigingsvenster op Verwijderen.

SQL

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

DROP RECIPIENT [IF EXISTS] <recipient-name>;

CLI (Command Line Interface)

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

databricks recipients delete <recipient-name>