Creare destinatari di dati per OpenSharing (condivisione da Databricks a Databricks)

Questa pagina spiega come creare i destinatari in OpenSharing, quando i destinatari si trovano su uno spazio di lavoro Azure Databricks abilitato per Unity Catalog. Per visualizzare, aggiornare, eliminare, concedere l'accesso alla condivisione, gestire le proprietà o limitare l'accesso con elenchi IP per un destinatario esistente, vedere Gestire i destinatari dei dati per OpenSharing.

Un destinatario è l'oggetto denominato che rappresenta l'identità di un utente o di un gruppo di utenti che utilizzano dati condivisi. Il modo in cui crei i destinatari varia a seconda che il destinatario abbia o meno accesso a uno spazio di lavoro Azure Databricks abilitato per il Catalogo Unity:

Per altre informazioni su queste due modalità di condivisione e su quando scegliere quale condivisione, vedere Condivisione da Databricks a Open rispetto alla condivisione da Databricks a Databricks.

Requisiti

Per creare un destinatario:

  • È necessario avere il CREATE RECIPIENT privilegio per il metastore del catalogo Unity in cui sono registrati i dati da condividere.
  • È necessario creare il destinatario usando un'area di lavoro di Azure Databricks con il metastore di Unity Catalog collegato.
  • Se si usa un notebook di Databricks per creare il destinatario, il calcolo deve usare Databricks Runtime 11.3 LTS o versione successiva e la modalità di accesso standard o dedicata (in precedenza modalità di accesso condiviso e singolo utente).

Per le autorizzazioni necessarie per altre operazioni del destinatario (visualizzare, aggiornare, eliminare, concedere l'accesso alla condivisione, gestire le proprietà), vedere Gestire i destinatari dei dati per OpenSharing.

Crea un oggetto destinatario per gli utenti di Azure Databricks

Se il destinatario dei tuoi dati ha accesso a uno spazio di lavoro Azure Databricks abilitato per Unity Catalog, puoi creare un oggetto destinatario con un tipo di autenticazione .DATABRICKS

Un oggetto destinatario con il tipo di autenticazione di DATABRICKS rappresenta un destinatario di dati in un particolare metastore del catalogo Unity, identificato nella definizione dell'oggetto destinatario da una stringa di identificatore di condivisione costituita dal cloud, dall'area e dall'UUID del metastore. È possibile accedere ai dati condivisi con questo destinatario solo in tale metastore.

Per creare un destinatario per la condivisione da Databricks a Databricks, usa il Catalog Explorer, la CLI di Databricks o il comando SQL CREATE RECIPIENT in un notebook di Azure Databricks o nell'editor di query SQL di Databricks. Per creare un destinatario con l'API REST, incluso un destinatario email, vedi Crea un destinatario nel riferimento REST API.

Autorizzazioni necessarie: amministratore o utente metastore con il privilegio per il CREATE RECIPIENT metastore di Unity Catalog in cui sono registrati i dati da condividere.

Esploratore di cataloghi

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

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

    In alternativa, nell'angolo superiore destro fare clic su Condividi > OpenSharing.

  3. Nella scheda Condivisi da me fare clic su Nuovo destinatario.

  4. Scegli come il tuo destinatario può accedere alle sue condivisioni:

    • Condividi tramite email (Beta): Questo invia un'email al destinatario, invitandolo ad accedere al proprio account Azure Databricks e selezionare il metastore desiderato. Il destinatario deve accedere con un account Azure Databricks che utilizzi l'indirizzo email invitato. Per maggiori informazioni e limitazioni, vedi condivisione email.

      1. Immettere il nome del destinatario .
      2. Immettere l'indirizzo di posta elettronica del destinatario.
      3. Per configurare come può essere consumata questa condivisione, seleziona Qualsiasi client OpenSharing supportato o Limita ai destinatari Databricks. Qualsiasi client OpenSharing supportato consente al destinatario di scaricare un file di credenziali e accedere alla condivisione su Azure Databricks.
      4. (Opzionale) Sotto Metastore Permessi (tramite ID di condivisione), clicca su Aggiungi metastore e inserisci un identificatore di condivisione per limitare quali metastore Azure Databricks possono accettare l'invito.

      Note

      Quando aggiungi un destinatario a una condivisione, OpenSharing invia al destinatario un link di attivazione sicuro e invia una nuova email ogni volta che lo aggiungi a un'altra condivisione. Concedere di nuovo una condivisione a un destinatario che ne dispone già non genera un'email duplicata. Vedere Gestire l'accesso alle condivisioni dati OpenSharing (per i provider).

    • Condividi usando l'identificatore di condivisione: devi chiedere e inserire l'identificatore di condivisione del destinatario.

      1. Immettere il nome del destinatario .

      2. Per Tipo di destinatario, selezionare Databricks.

      3. Immettere l'identificatore di condivisione del destinatario.

        Usare l'intera stringa di identificatore di condivisione nel formato <cloud>:<region>:<uuid>. Ad esempio: aws:us-west-2:19a84bee-54bc-43a2-87de-023d0ec16016.

      4. (Facoltativo) Immettere un commento.

  5. Clicca su Crea.

  6. (Facoltativo) Creare proprietà del destinatario personalizzate.

    Nella scheda Panoramica del destinatario, fare clic sull'icona di modifica Icona Modifica accanto a Proprietà del destinatario. Aggiungere quindi un nome di proprietà (chiave) e un valore. Per informazioni dettagliate, vedere Gestire le proprietà dei destinatari.

SQL

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

CREATE RECIPIENT [IF NOT EXISTS] <recipient-name>
USING ID '<sharing-identifier>'
[COMMENT "<comment>"];

Usare l'intera stringa di identificatore di condivisione nel formato <cloud>:<region>:<uuid>. Ad esempio: aws:eu-west-1:g0c979c8-3e68-4cdf-94af-d05c120ed1ef.

È anche possibile aggiungere proprietà personalizzate per il destinatario. Per informazioni dettagliate, vedere Gestire le proprietà dei destinatari.

CLI

Eseguire il comando seguente usando la CLI di Databricks. Sostituisci i valori segnaposto:

  • <recipient-name>: nome del destinatario.
  • <sharing-identifier>: l'intera stringa di identificatore di condivisione nel formato <cloud>:<region>:<uuid>. Ad esempio: aws:eu-west-1:g0c979c8-3e68-4cdf-94af-d05c120ed1ef.
  • <authentication-type>: impostato su DATABRICKS quando viene fornita una stringa di identificatore di condivisione nel formato <cloud>:<region>:<uuid> per <sharing-identifier>.
databricks recipients create <recipient-name> <authentication-type> --sharing-code <sharing-identifier>

È anche possibile aggiungere proprietà personalizzate per il destinatario. Per informazioni dettagliate, vedere Gestire le proprietà dei destinatari.

Il destinatario viene creato con authentication_type di DATABRICKS.

Risorse aggiuntive

  • Ultimo aggiornamento: