Condividi tramite

Gestire i provider di condivisione delta (per i destinatari dei dati)

  • Articolo

Questo articolo descrive come usare Unity Catalog per ottenere informazioni sui provider di dati che condividono dati con l'utente usando Delta Sharing. Descrive anche che cos'è un oggetto provider e quando potrebbe essere necessario creare un oggetto provider nel metastore del catalogo Unity, un'attività che la maggior parte dei destinatari non deve mai eseguire.

Importante

I destinatari dei dati devono avere accesso a un'area di lavoro di Databricks abilitata per Catalogo Unity per usare le funzionalità descritte in questo articolo. Questo articolo non si applica ai destinatari che non dispongono di aree di lavoro abilitate per Unity Catalog.

I destinatari devono creare oggetti provider?

In Delta Sharing on Databricks, il termine "provider" può significare sia l'organizzazione che condivide i dati con l'utente sia un oggetto proteggibile nel metastore del Unity Catalog di un destinatario che rappresenta l'organizzazione. L'esistenza di tale oggetto proteggibile nel metastore dell'Unity Catalog di un destinatario consente ai destinatari di gestire l'accesso del team ai dati condivisi usando Unity Catalog.

In qualità di destinatario con accesso a un metastore del catalogo Unity, in genere non è necessario creare oggetti provider. Questo avviene perché i dati devono essere condivisi con l'utente usando condivisione da Databricks a Databrickse gli oggetti provider vengono creati automaticamente nel metastore di Unity Catalog.

Nota

Se si è il destinatario raro in Unity Catalog che riceve dati da un provider che non condivide da un'area di lavoro databricks abilitata per Unity Catalog, è possibile creare oggetti provider in Unity Catalog in modo da poter gestire i dati condivisi usando Unity Catalog. Se rientri in tale categoria, puoi usare la chiamata all'API REST POST /api/2.1/unity-catalog/providers o l'interfaccia della riga di comando di Databricks per creare l'oggetto provider del catalogo Unity. È necessario essere un amministratore o un utente del metastore con il CREATE_PROVIDER privilegio per il metastore.

Operazioni preliminari

Per gestire i provider nell'area di lavoro di Azure Databricks:

  • L'area di lavoro deve essere abilitata per il catalogo Unity.
  • Per visualizzare un provider, è necessario essere un amministratore del metastore, oppure un amministratore del metastore deve concedere il privilegio USE PROVIDER.
  • Per creare un provider, è necessario essere un amministratore del metastore oppure ricevere il privilegio CREATE PROVIDER da un amministratore del metastore.
  • Per aggiornare un provider, è necessario essere il proprietario dell'oggetto provider e avere il privilegio di CREATE PROVIDER. Per informazioni dettagliate, vedere Aggiornare un provider (rinominare, modificare il proprietario, il commento).

Per questo motivo, se l'area di lavoro è stata creata senza un amministratore del metastore, un amministratore dell'account Azure Databricks deve concedere a un utente o a un gruppo il ruolo di amministratore del metastore prima di poter usare gli oggetti provider in Azure Databricks. Vedi Attivazione automatica di Unity Catalog e (Opzionale) Assegna il ruolo di Amministratore del metastore.

Visualizzare i provider

Per visualizzare un elenco dei provider di dati disponibili, è possibile usare Esplora cataloghi, l'interfaccia della riga di comando di Databricks Unity Catalog o il comando SQL SHOW PROVIDERS in un notebook di Azure Databricks o nell'editor di query SQL di Databricks.

Autorizzazioni necessarie: è necessario essere un amministratore del metastore o avere il privilegio USE PROVIDER per visualizzare tutti i provider nel metastore. Gli altri utenti hanno accesso solo ai provider di cui sono proprietari.

Esploratore di cataloghi

  1. Nell'area di lavoro di Azure Databricks fare clic sull'icona CatalogoCatalogo.

  2. Nella parte superiore del riquadro Catalogo, fare clic sull'icona a forma di ingranaggio e selezionare Delta Sharing.

    In alternativa, nella pagina Accesso rapido fare clic sul pulsante condivisione delta >.

  3. Nella scheda Condiviso con me visualizza tutti i fornitori disponibili.

SQL

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

SHOW PROVIDERS [LIKE <pattern>];

CLI

Eseguire il comando seguente usando la CLI di Databricks.

databricks providers list

Visualizzare i dettagli del provider

Per visualizzare informazioni dettagliate su un provider, è possibile usare Esplora cataloghi, l'interfaccia della riga di comando di Databricks Unity Catalog o il comando SQL DESCRIBE PROVIDER in un notebook di Azure Databricks o nell'editor di query SQL di Databricks.

Autorizzazioni necessarie: amministratore metastore, utente con privilegi USE PROVIDER o proprietario dell'oggetto provider.

I dettagli includono:

  • Condivisioni condivise dal provider (vedere Visualizza condivisioni condivise da un provider con l'utente).
  • Autore del provider, timestamp di creazione, commenti e tipo di autenticazione (TOKEN o DATABRICKS). TOKEN rappresenta i provider che hanno condiviso i dati con l'utente usando il protocollo di condivisione aperta delta. DATABRICKS rappresenta i fornitori che hanno condiviso i dati con l'utente usando il protocollo di condivisione Databricks-a-Databricks.
  • Se il provider utilizza la condivisione Databricks-to-Databricks: il cloud, l'area e l'ID del metastore di Unity Catalog del provider.
  • Se il provider usa la condivisione aperta: l'endpoint del profilo del destinatario, ovvero la posizione in cui è ospitato il server di condivisione Delta.

Esploratore di cataloghi

  1. Nell'area di lavoro di Azure Databricks fare clic sull'icona CatalogoCatalogo.

  2. Nella parte superiore del riquadro Catalogo, fare clic sull'icona a forma di ingranaggio e selezionare Condivisione Delta.

    In alternativa, nella pagina Accesso rapido fare clic sul pulsante condivisione delta >.

  3. Nella scheda Condivisi con me, trovare e selezionare il fornitore.

SQL

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

DESC PROVIDER <provider-name>;

CLI

Eseguire il comando seguente usando la CLI di Databricks.

databricks providers get <provider-name>

Visualizzare condivisioni condivise da un provider

Per visualizzare le condivisioni che un provider ha condiviso con te, puoi utilizzare Catalog Explorer, il Databricks Unity Catalog CLI, o il comando SQL SHOW SHARES IN PROVIDER in un notebook di Azure Databricks o nell'editor delle query SQL di Databricks.

Autorizzazioni necessarie: amministratore metastore, utente con privilegi USE PROVIDER o proprietario dell'oggetto provider.

Esploratore di Cataloghi

  1. Nell'area di lavoro di Azure Databricks, fai clic sull'icona CatalogoCatalogo.

  2. Nella parte superiore del riquadro Catalogo, fare clic sull'icona a forma di ingranaggio e selezionare Delta Sharing .

    In alternativa, nella pagina Accesso rapido fare clic sul pulsante condivisione delta >.

  3. Nella scheda Condivisi con me, trovare e selezionare il provider.

SQL

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

SHOW SHARES IN PROVIDER [LIKE <pattern>];

CLI

Eseguire il comando seguente usando la CLI di Databricks.

 databricks providers list-shares <provider-name>

Aggiornare un provider (rinominare, modificare il proprietario, il commento)

È possibile usare Catalog Explorer, la CLI di Databricks Unity Catalog o il comando SQL ALTER PROVIDER in un notebook di Azure Databricks o nell'editor di query Databricks SQL per modificare l'oggetto provider nel metastore del tuo Unity Catalog.

  • Rinominare il provider per modificare il modo in cui gli utenti vedono l'oggetto provider nelle interfacce di Databricks.
  • Modificare il proprietario dell'oggetto provider.
  • Aggiungere o modificare commenti.

Autorizzazioni necessarie: È necessario essere il proprietario dell'oggetto fornitore per aggiornare il proprietario. Per aggiornare il nome del provider, è necessario essere sia un amministratore del metastore (o un utente con privilegi di CREATE_PROVIDER) che proprietario del provider con i privilegi e. Per aggiornare il commento, è necessario essere il proprietario. Il proprietario iniziale è l'amministratore del metastore.

Esploratore di cataloghi

  1. Nell'area di lavoro di Azure Databricks, fai clic sull'icona CatalogoCatalogo.

  2. Nella parte superiore del riquadro Catalogo, fare clic sull'icona a forma di ingranaggio e selezionare Delta Sharing.

    In alternativa, nella pagina Accesso rapido fare clic sul pulsante condivisione delta >.

  3. Nella scheda Condivisi con me, trova e seleziona il provider.

  4. Nella pagina dei dettagli aggiornare il proprietario, il commento o il nome del provider.

    Per rinominare un provider, fare clic sul kebab menu kebab menu e selezionare Rinomina.

SQL

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

ALTER PROVIDER <provider-name> RENAME TO <new-provider-name>
OWNER TO <new-owner>
COMMENT "<comment>";

CLI

Eseguire il comando seguente usando la CLI di Databricks. Sostituire <provider-name> con il nome del provider corrente e <new-provider-name> con il nuovo nome.

databricks providers update <provider-name> /
--new-name <new-provider-name> /
--comment "<new comment>" /
--owner <new-owner-name>

Eliminare un provider

Per eliminare un provider, è possibile usare Esplora cataloghi, l'interfaccia della riga di comando di Databricks Unity Catalog o il comando SQL DROP PROVIDER in un notebook di Azure Databricks o nell'editor di query SQL di Databricks. Per eliminare il provider, è necessario essere il proprietario dell'oggetto provider.

Quando si elimina un provider, l'utente e gli utenti dell'organizzazione (destinatario) non possono più accedere ai dati condivisi dal provider.

Autorizzazioni necessarie: proprietario dell'oggetto provider.

Esploratore di Cataloghi

  1. Nell'area di lavoro di Azure Databricks, fare clic sull'icona CatalogoCatalogo.

  2. Nella parte superiore del riquadro Catalogo, fare clic sull'icona a forma di ingranaggio e selezionare Delta Sharing.

    In alternativa, nella pagina Accesso rapido fare clic sul pulsante condivisione delta >.

  3. Nella scheda Condivisi con me, trovare e selezionare il provider.

  4. Fare clic sul menu kebab e selezionare Elimina.

  5. 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 PROVIDER [IF EXISTS] <provider-name>;

CLI

Eseguire il comando seguente usando la CLI di Databricks.

databricks providers delete <provider-name>

Se l'operazione ha esito positivo, non vengono restituiti risultati.