Shares beheren voor OpenSharing

Op deze pagina wordt beschreven hoe u bestaande OpenSharing-shares in Azure Databricks kunt weergeven, bijwerken en verwijderen. Een share is een beveiligbaar object in Unity Catalog waarmee tabellen, weergaven, volumes, notebooks, AI-modellen en andere gegevensassets worden gebundeld voor delen met een of meer ontvangers.

Zie Shares maken voor OpenSharing als u een nieuwe share wilt maken of gegevensassets wilt toevoegen aan een bestaande share. Als u een ontvanger toegang tot een share wilt verlenen, raadpleegt u Toegang tot OpenSharing-datashares beheren (voor aanbieders). Zie Gegevensontvangers beheren voor OpenSharing om de gegevensontvangers met wie u deelt te beheren.

Zie Shares, providers en ontvangers voor meer informatie over het model voor delen.

Requirements

Controleer of u voldoet aan de vermelde vereisten voor elke taak die u wilt voltooien.

Task	Requirements
Ontvanger toegang verlenen tot een gedeelde map	Een metastore-beheerder zijn. OF Wees een gebruiker met gedelegeerde machtigingen of eigendom voor zowel de share- als de ontvangerobjecten. Dit betekent dat de gebruiker moet voldoen aan beide van de volgende vereisten: `USE SHARE` en `SET SHARE PERMISSION` rechten hebben OF de eigenaar van de share zijn Bevoegdheid hebben `USE RECIPIENT` OF de eigenaar van de geadresseerde zijn
Aandelen weergeven	Een metastore-beheerder zijn (kan alles bekijken). OR Wees een gebruiker met de `USE SHARE` bevoegdheid (kan alles bekijken). OR Wees de eigenaar van het gedeeld object.
Eigenaar van share bijwerken	Wees een metastore-beheerder.
Naam van share bijwerken	Geniet van het `CREATE SHARE` voorrecht. Wees de eigenaar van het aandeel.
Andere gedeelde eigenschappen bijwerken	Wees de eigenaar van het aandeel.
Gedeelde items verwijderen	Wees de eigenaar van het gedeeld object.

Aandelen en details van aandelen weergeven

Controleer of u aan de vereisten voldoet voordat u shares bekijkt en details deelt.

Als u een lijst met aandelen of details over een aandeel wilt weergeven, gebruikt u Catalog Explorer, de Databricks Unity Catalog CLI of SQL-opdrachten in een Azure Databricks-notebook of de Databricks SQL-queryeditor.

De details van de aandelen zijn onder andere:

De eigenaar van de share, auteur, tijdstempel van de creatie, updater, bijgewerkte tijdstempel, opmerkingen.
Gegevensassets in de gedeelde map.
Ontvangers met toegang tot de gedeelde bestand.

Catalogusverkenner

Klik in uw Azure Databricks werkruimte op Catalog.
Klik bovenaan het deelvenster Catalogus op het en selecteer OpenSharing.

U kunt ook op de pagina Snelle toegang klikken op de knop OpenSharing > .
Open het tabblad Shares om een lijst met shares weer te geven.
Bekijk de deelgegevens op het tabblad Details.

SQL

Als u een lijst met shares wilt weergeven, voert u de volgende opdracht uit in een notebook of de Databricks SQL-queryeditor. Vervang desgewenst door <pattern> een LIKE predicaat.

SHOW SHARES [LIKE <pattern>];

Voer de volgende opdracht uit om details over een specifieke share weer te geven.

DESCRIBE SHARE <share-name>;

Voer de volgende opdracht uit om details over alle tabellen, weergaven en volumes in een share weer te geven.

SHOW ALL IN SHARE <share-name>;

CLI (Command Line Interface)

Als u een lijst met shares wilt weergeven, voert u de volgende opdracht uit met behulp van de Databricks CLI.

databricks shares list

Voer de volgende opdracht uit om details over een specifieke share weer te geven.

databricks shares get <share-name>

De ontvangers weergeven die machtigingen hebben voor een gedeelde map.

Controleer of u aan de vereisten voldoet voordat u de geadresseerden bekijkt.

Gebruik Catalog Explorer, de Databricks Unity Catalog CLI of de SHOW GRANTS TO RECIPIENT SQL-opdracht in een Azure Databricks notebook of de Databricks SQL-queryeditor om de lijst met shares weer te geven waartoe een ontvanger toegang heeft gekregen.

Catalogusverkenner

Klik in uw Azure Databricks werkruimte op Catalog.
Klik bovenaan het deelvenster Catalogus op het en selecteer OpenSharing.

U kunt ook op de pagina Snelle toegang klikken op de knop OpenSharing > .
Zoek en selecteer de geadresseerde op het tabblad Gedeeld door mij .
Ga naar het tabblad Ontvangers om de lijst met ontvangers weer te geven die toegang hebben tot de gedeelde map.

SQL

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

SHOW GRANTS ON SHARE <share-name>;

CLI (Command Line Interface)

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

databricks shares share-permissions <share-name>

Shares bijwerken

Controleer of u aan de vereisten voldoet voordat u updates voor een share aanbrengt.

U kunt een share op de volgende manieren bijwerken:

Wijzig de naam van een gedeelde map.
Verwijder tabellen, weergaven, volumes en schema's uit een share.
Een opmerking aan een share toevoegen of bijwerken.
Wijzig de naam van de alias van een tabel (de tabelnaam die wordt weergegeven aan de ontvanger).
Toegang tot de geschiedenisgegevens van een tabel in- of uitschakelen, zodat ontvangers tijdreizenquery's of streaming-leesbewerkingen van de tabel kunnen uitvoeren.
Partitiedefinities toevoegen, bijwerken of verwijderen.
Wijzig de eigenaar van de share.

Als u deze updates wilt uitvoeren voor shares, gebruikt u Catalog Explorer, de Databricks Unity Catalog CLI of SQL-opdrachten in een Azure Databricks-notebook of de Databricks SQL-queryeditor. U kunt Catalog Explorer echter niet gebruiken om de naam van de share te wijzigen.

Catalogusverkenner

Klik in uw Azure Databricks werkruimte op Catalog.
Klik bovenaan het deelvenster Catalogus op het en selecteer OpenSharing.

U kunt ook op de pagina Snelle toegang klikken op de knop OpenSharing > .
Zoek op het tabblad Gedeeld door mij de share die u wilt bijwerken en klik op de naam ervan.

Ga als volgt te werk op de pagina met share-details:

Klik op het naast het veld Eigenaar of Opmerking om deze waarden bij te werken.
Klik op het in een assetrij om het te verwijderen.
Klik op Assets > bewerken om alle andere eigenschappen bij te werken:
- Als u een asset wilt verwijderen, schakelt u het selectievakje naast de asset uit.
- Als u partitiedefinities wilt toevoegen, bijwerken of verwijderen, klikt u op Geavanceerde opties.

SQL

Voer de volgende opdrachten uit in een notebook of de Databricks SQL-editor.

De naam van een share wijzigen:

ALTER SHARE <share-name> RENAME TO <new-share-name>;

Tabellen verwijderen uit een gedeeld bestand:

ALTER SHARE share_name REMOVE TABLE <table-name>;

Volumes verwijderen uit een gedeelde map:

ALTER SHARE share_name REMOVE VOLUME <volume-name>;

Een opmerking aan een share toevoegen of bijwerken:

COMMENT ON SHARE <share-name> IS '<comment>';

Partities voor een tabel in een share toevoegen of wijzigen:

ALTER SHARE <share-name> ADD TABLE <table-name> PARTITION(<clause>);

Eigenaar van share wijzigen:

ALTER SHARE <share-name> OWNER TO  '<principal>'

-- Principal must be an account-level user email address or group name.

Geschiedenis delen inschakelen voor een tabel:

ALTER SHARE <share-name> ADD TABLE <table-name> WITH HISTORY;

Voor meer informatie over de parameters van ALTER SHARE, zie ALTER SHARE.

CLI (Command Line Interface)

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

De naam van een share wijzigen:

databricks shares update <share-name> --name <new-share-name>

Tabellen verwijderen uit een gedeeld bestand:

databricks shares update <share-name> \
  --json '{
    "updates": [
      {
        "action": "REMOVE",
        "data_object": {
          "name": "<table-full-name>",
          "data_object_type": "TABLE",
          "shared_as": "<table-alias>"
        }
      }
    ]
  }'

Volumes verwijderen uit een share (met Databricks CLI 0.210 of hoger):

databricks shares update <share-name> \
  --json '{
    "updates": [
      {
        "action": "REMOVE",
        "data_object": {
          "name": "<volume-full-name>",
          "data_object_type": "VOLUME",
          "string_shared_as": "<volume-alias>"
        }
      }
    ]
  }'

Opmerking

Gebruik de name eigenschap als er geen alias voor het volume is. Gebruik string_shared_as deze optie als er een alias is.

Een opmerking aan een share toevoegen of bijwerken:

databricks shares update <share-name> --comment '<comment>'

Eigenaar van share wijzigen:

databricks  shares update <share-name> --owner '<principal>'

Principal moet een e-mailadres of groepsnaam van een gebruiker op accountniveau zijn.

Wie de eigenaar van de share is, is van invloed op de wijze waarop autorisatie- en beveiligingsfuncties, zoals ABAC-beleid, worden geëvalueerd. Als u het eigendom van een share overzet naar een overgeprivilegieerde gebruiker, kunnen ontvangers overgeprivilegieerde toegang hebben als u een tabel of schema hebt beveiligd met ABAC-beleidsregels.

Shares verwijderen

Wanneer u een share verwijdert, hebben ontvangers geen toegang meer tot de gedeelde gegevens. Controleer of u aan de vereisten voldoet voordat u een share-object verwijdert.

Als u een share wilt verwijderen, gebruikt u Catalog Explorer, de Databricks Unity Catalog CLI of de DELETE SHARE SQL-opdracht in een Azure Databricks-notebook of de Databricks SQL-query-editor. U moet eigenaar zijn van de share.

Catalogusverkenner

Klik in uw Azure Databricks werkruimte op Catalog.
Klik bovenaan het deelvenster Catalogus op het en selecteer OpenSharing.

U kunt ook op de pagina Snelle toegang klikken op de knop OpenSharing > .
Zoek op het tabblad Gedeeld door mij de share die u wilt verwijderen en klik op de naam ervan.
Klik op het Selecteer Verwijderen.
Klik in het bevestigingsvenster op Verwijderen.

SQL

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

DROP SHARE [IF EXISTS] <share-name>;

CLI (Command Line Interface)

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

databricks shares delete <share-name>

Feedback

Is deze pagina nuttig?

Last updated on 2026-06-24

Shares beheren voor OpenSharing

Requirements

Aandelen en details van aandelen weergeven

Catalogusverkenner

SQL

CLI (Command Line Interface)

De ontvangers weergeven die machtigingen hebben voor een gedeelde map.

Catalogusverkenner

SQL

CLI (Command Line Interface)

Shares bijwerken

Catalogusverkenner

SQL

CLI (Command Line Interface)

Overwegingen bij het bijwerken van de eigenaar van de share

Shares verwijderen

Catalogusverkenner

SQL

CLI (Command Line Interface)

Feedback

Aanvullende resources