Gestire le condivisioni per la condivisione Delta

Questa pagina descrive come visualizzare, aggiornare ed eliminare condivisioni Delta Sharing esistenti in Azure Databricks. Una condivisione è un oggetto proteggibile in Unity Catalog che aggrega tabelle, viste, volumi, notebook, modelli di intelligenza artificiale e altre risorse di dati per la condivisione con uno o più destinatari.

Per creare una nuova condivisione o aggiungere risorse di dati a una condivisione esistente, consulta Creare condivisioni per Delta Sharing. Per concedere a un destinatario l'accesso a una condivisione, consulta Gestire l'accesso alle condivisioni di dati Delta Sharing (per i provider). Per gestire i destinatari con cui condividi i dati, consulta Gestire i destinatari dei dati per Delta Sharing.

Per altre informazioni sul modello di condivisione, vedere Condivisioni, provider e destinatari.

Requirements

Verificare di soddisfare i requisiti elencati per ogni attività che si vuole completare.

Attività	Requirements
Concedere ai destinatari l'accesso a una condivisione	Essere un amministratore del metastore. ALTRIMENTI Essere un utente con autorizzazioni delegate o proprietà sia per la condivisione che per gli oggetti destinatario, il che significa che l'utente deve soddisfare entrambi i requisiti seguenti: Avere i privilegi di `USE SHARE` o di `SET SHARE PERMISSION` O essere il proprietario della condivisione Disporre `USE RECIPIENT` del privilegio OPPURE essere il proprietario del destinatario
Visualizza le condivisioni	Essere amministratore del metastore (possono visualizzare tutto). OR Essere un utente con il `USE SHARE` privilegio (può visualizzare tutti). OR Essere il proprietario dell'oggetto di condivisione.
Aggiornare il proprietario della condivisione	Essere un amministratore del metastore.
Aggiornare il nome della condivisione	Avere il `CREATE SHARE` privilegio . Diventa l'azionista.
Aggiornare altre proprietà di condivisione	Diventa l'azionista.
Eliminare condivisioni	Essere il proprietario dell'oggetto di condivisione.

Visualizzare condivisioni e condividere i dettagli

Verificare di soddisfare i requisiti prima di visualizzare le condivisioni e condividere i dettagli.

Per visualizzare un elenco di condivisioni o dettagli su una condivisione, usare Esplora cataloghi, l'interfaccia della riga di comando di Databricks Unity Catalog o i comandi SQL in un notebook di Azure Databricks o nell'editor di query SQL di Databricks.

I dettagli di condivisione includono quanto segue:

Proprietario della condivisione, autore, timestamp di creazione, aggiornamento, timestamp aggiornato, commenti.
Asset di dati condivisi.
Destinatari con accesso alla condivisione.

Esploratore di cataloghi

Nell'area di lavoro di Azure Databricks fare clic Catalogo.
Nella parte superiore del riquadro Catalogo, fare clic sull'icona e selezionare Delta Sharing.

In alternativa, nella pagina Accesso rapido, fare clic sul pulsante Delta Sharing >.
Aprire la scheda Condivisioni per visualizzare un elenco di condivisioni.
Visualizzare i dettagli della condivisione nella scheda Dettagli .

SQL

Per visualizzare un elenco di condivisioni, eseguire il comando seguente in un notebook o nell'editor di query SQL di Databricks. Facoltativamente, sostituire <pattern> con un LIKE predicato.

SHOW SHARES [LIKE <pattern>];

Per visualizzare i dettagli su una condivisione specifica, eseguire il comando seguente.

DESCRIBE SHARE <share-name>;

Per visualizzare i dettagli su tutte le tabelle, le viste e i volumi in una condivisione, eseguire il comando seguente.

SHOW ALL IN SHARE <share-name>;

CLI

Per visualizzare un elenco di condivisioni, eseguire il comando seguente usando l'interfaccia della riga di comando di Databricks.

databricks shares list

Per visualizzare i dettagli su una condivisione specifica, eseguire il comando seguente.

databricks shares get <share-name>

Visualizzare i destinatari che dispongono delle autorizzazioni per una condivisione

Verificare di soddisfare i requisiti prima di visualizzare i destinatari.

Per visualizzare l'elenco di condivisioni a cui è stato concesso l'accesso a un destinatario, usare Catalog Explorer, il Databricks Unity Catalog CLI o il SHOW GRANTS TO RECIPIENT comando SQL in un notebook di Azure Databricks o nell'editor di SQL di Databricks.

Esploratore di cataloghi

Nell'area di lavoro di Azure Databricks fare clic Catalogo.
Nella parte superiore del riquadro Catalogo, fare clic sull'icona e selezionare Delta Sharing.

In alternativa, nella pagina Accesso rapido, fare clic sul pulsante Delta Sharing >.
Nella scheda Condivisi da me trovare e selezionare il destinatario.
Passare alla scheda Destinatari per visualizzare l'elenco dei destinatari che possono accedere alla condivisione.

SQL

Eseguire il seguente comando in un notebook o nell'editor di query SQL di Databricks.

SHOW GRANTS ON SHARE <share-name>;

CLI

Eseguire il comando seguente usando la CLI di Databricks.

databricks shares share-permissions <share-name>

Aggiornare le condivisioni

Verificare di soddisfare i requisiti prima di apportare aggiornamenti a una condivisione.

È possibile aggiornare una condivisione nei modi seguenti:

Rinominare una condivisione.
Rimuovere tabelle, viste, volumi e schemi da una condivisione.
Aggiungere o aggiornare un commento in una condivisione.
Rinominare l'alias di una tabella (il nome della tabella visualizzato nel destinatario).
Abilitare o disabilitare l'accesso ai dati della cronologia di una tabella, consentendo ai destinatari di eseguire query temporali o letture in streaming della tabella.
Aggiungere, aggiornare o rimuovere definizioni di partizione.
Modificare il proprietario della condivisione.

Per eseguire questi aggiornamenti alle condivisioni, utilizzare Esplora Catalogo, l'interfaccia a riga di comando di Databricks Unity Catalog o i comandi SQL in un notebook di Azure Databricks o nell'editor di query SQL di Databricks. Tuttavia, non è possibile usare Esplora cataloghi per rinominare la condivisione.

Esploratore di cataloghi

Nell'area di lavoro di Azure Databricks fare clic Catalogo.
Nella parte superiore del riquadro Catalogo, fare clic sull'icona e selezionare Delta Sharing.

In alternativa, nella pagina Accesso rapido, fare clic sul pulsante Delta Sharing >.
Nella scheda Condivisi da me individuare la condivisione che si vuole aggiornare e fare clic sul nome.

Nella pagina dei dettagli della condivisione eseguire le operazioni seguenti:

Fare clic modifica accanto al campo Proprietario o Commento per aggiornare questi valori.
Fare clic sul pulsante in una riga dell'asset per rimuoverlo.
Fare clic su Gestisci asset Modifica asset > per aggiornare tutte le altre proprietà:
- Per rimuovere un asset, deselezionare la casella di controllo accanto all'asset.
- Per aggiungere, aggiornare o rimuovere definizioni di partizione, fare clic su Opzioni avanzate.

SQL

Eseguire i comandi seguenti in un notebook o nell'editor SQL di Databricks.

Rinominare una condivisione:

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

Rimuovere tabelle da una condivisione:

ALTER SHARE share_name REMOVE TABLE <table-name>;

Rimuovere volumi da una condivisione:

ALTER SHARE share_name REMOVE VOLUME <volume-name>;

Aggiungere o aggiornare un commento in una condivisione:

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

Aggiungere o modificare partizioni per una tabella in una condivisione:

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

Modificare il proprietario della condivisione:

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

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

Abilitare la condivisione della cronologia per una tabella:

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

Per informazioni dettagliate sui parametri di ALTER SHARE, vedere ALTER SHARE.

CLI

Eseguire i comandi seguenti usando l'interfaccia della riga di comando di Databricks.

Rinominare una condivisione:

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

Rimuovere tabelle da una condivisione:

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

Rimuovere volumi da una condivisione (usando l'interfaccia della riga di comando di Databricks 0.210 o versione successiva):

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

Annotazioni

Utilizzare la name proprietà se non è presente alcun alias per il volume. Usare string_shared_as se è presente un alias.

Aggiungere o aggiornare un commento in una condivisione:

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

Modificare il proprietario della condivisione:

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

L'entità principale deve essere l'indirizzo email di un utente a livello di account o il nome di un gruppo.

L'utente proprietario della condivisione influisce sul modo in cui vengono valutate le funzionalità di autorizzazione e sicurezza, ad esempio i criteri di controllo degli accessi basati sugli attributi. Il trasferimento della proprietà della condivisione a un utente con privilegi eccessivi consente ai destinatari di avere accesso con privilegi eccessivi se si dispone di una tabella o uno schema protetto dai criteri di controllo degli accessi basati sugli attributi.

Eliminare condivisioni

Quando si elimina una condivisione, i destinatari non possono più accedere ai dati condivisi. Verificare di soddisfare i requisiti prima di eliminare un oggetto condivisione.

Per eliminare una condivisione, utilizzare Catalog Explorer, la CLI di Databricks Unity Catalog, oppure il comando SQL DELETE SHARE in un notebook di Azure Databricks o nell'editor di query SQL di Databricks. È necessario essere un proprietario della quota.

Esploratore di cataloghi

Nell'area di lavoro di Azure Databricks fare clic Catalogo.
Nella parte superiore del riquadro Catalogo, fare clic sull'icona e selezionare Delta Sharing.

In alternativa, nella pagina Accesso rapido, fare clic sul pulsante Delta Sharing >.
Nella scheda Condivisi da me individuare la condivisione che si desidera eliminare e fare clic sul nome.
Fare clic Menu kebab e selezionare Elimina.
Nella finestra di dialogo di conferma fare clic su Elimina.

SQL

Eseguire il seguente comando in un notebook o nell'editor di query SQL di Databricks.

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

CLI

Eseguire il comando seguente usando la CLI di Databricks.

databricks shares delete <share-name>

Commenti e suggerimenti

Questa pagina è stata utile?

Last updated on 2026-06-01

Requirements

Visualizzare condivisioni e condividere i dettagli

Esploratore di cataloghi

SQL

CLI

Visualizzare i destinatari che dispongono delle autorizzazioni per una condivisione

Esploratore di cataloghi

SQL

CLI

Aggiornare le condivisioni

Esploratore di cataloghi

SQL

CLI

Considerazioni sull'aggiornamento del proprietario della condivisione

Eliminare condivisioni

Esploratore di cataloghi

SQL

CLI

Commenti e suggerimenti

Risorse aggiuntive