DocumentazioneExperience PlatformGuida ai connettori di origini

Delta Sharing

Ultimo aggiornamento: 26 ottobre 2026

Creato per:

  • Sviluppatore
AVAILABILITY
La versione beta limitata è stata conclusa. Disponibilità generale (GA) attualmente pianificata per il 2027. Contatta il team del tuo account Adobe per ulteriori informazioni sulla disponibilità futura.

Con il connettore di origine Delta Sharing è possibile connettersi in modo sicuro all’origine Databricks Delta Sharing e creare set di dati virtuali in Adobe Experience Platform. Questo consente di eseguire query e utilizzare tabelle esterne tramite i servizi di Experience Platform, rappresentando allo stesso tempo i dati condivisi tramite schemi relazionali e senza acquisire fisicamente i dati in Platform. Utilizzando Delta Sharing, è possibile ridurre l’archiviazione dei dati duplicati, ridurre i costi di archiviazione e semplificare la gestione dei dati.

Prerequisiti prerequisites

Prima di connettersi a un’origine Databricks Delta Sharing da Adobe Experience Platform, verificare che siano soddisfatti i seguenti requisiti.

IMPORTANT
Delta Sharing non acquisisce fisicamente o copia i dati di origine in Experience Platform. In Experience Platform, invece, i dati condivisi sono rappresentati come set di dati virtuali. Assicurati che le tabelle condivise che desideri utilizzare siano disponibili tramite Condivisione delta e possano essere rappresentate tramite schemi relazionali in Experience Platform.

Databricks prerequisiti provider

Dal lato del fornitore, assicurati di disporre dei seguenti elementi:

  • External Delta Sharing è abilitato: Delta Sharing esterno deve essere abilitato per l’account/area di lavoro Databricks e deve essere configurato un TTL del token predefinito.

  • Tabelle delta idonee: le tabelle che si intende condividere devono:

    • Essere Tabelle delta.
    • Essere configurato nell’archiviazione che supporta Delta Sharing aperto (archiviazione esterna o configurazione supportata da Databricks).
    • Non sono applicati filtri di riga o maschere di colonna (Databricks non consente la condivisione di tali tabelle).

Condivisione e configurazione dei destinatari

Un amministratore Databricks deve completare i seguenti passaggi:

  1. Crea una condivisione e aggiungi tabelle:

    code language-sql 
    CREATE SHARE IF NOT EXISTS my_first_share
  COMMENT 'Share for Adobe Experience Platform';

ALTER SHARE my_first_share
  ADD TABLE {CATALOG}.{SCHEMA}.{TABLE};

  2. Crea un destinatario per Experience Platform e concedi la condivisione:

    code language-sql 
    CREATE RECIPIENT IF NOT EXISTS plat_recipient
  COMMENT 'Recipient for Platform Delta Sharing source';
GRANT SELECT ON SHARE my_first_share TO RECIPIENT plat_recipient;

Scarica il file di credenziali Delta Sharing (.share) per questo destinatario. Questo file contiene i quattro valori che utilizzerai nell’interfaccia utente di Experience Platform.

Seleziona per visualizzare un file .share di esempio
code language-json 
{
  "shareCredentialsVersion": 1,
  "endpoint": "https://{WORKSPACE}.azuredatabricks.net/api/2.0/delta-sharing/metastores/{ID}",
  "bearerToken": "dapi1234567890abcdef1234567890abcdef-1234567890abcdef",
  "expirationTime": "2026-03-31T23:59:59Z"
}

Configurazione di rete e firewall

Se gli account di archiviazione cloud, ad esempio Azure Data Lake Storage Gen2, Amazon S3, Google Cloud Storage sono protetti dalle regole del firewall, assicurati che Experience Platform possa accedere a Delta Sharing resource, including richiesto:

  • Endpoint Delta Sharing dal file .share.
  • Percorsi di archiviazione sottostanti per le tabelle condivise.

Prerequisiti di Experience Platform

Ambiente supportato

  • L’organizzazione Experience Platform deve essere ospitata in un’area geografica supportata di Azure.
  • La funzionalità di origine Delta Sharing deve essere abilitata per la tua organizzazione. Se non trovi la scheda “Condivisione di dati → Condivisione di dati Delta Share” nel catalogo delle origini, contatta il supporto Adobe o il tuo rappresentante Adobe.

Inoltre, l’utente che crea la connessione deve disporre delle seguenti autorizzazioni nella sandbox di destinazione:

  • Accesso a Origini e autorizzazione per creare connessioni/flussi di dati di origine.
  • Autorizzazione a creare schemi e set di dati, inclusi i set di dati virtuali.

Aspettative di governance

  • Delta Sharing connessioni creano set di dati virtuali nel catalogo. Questi set di dati sono di sola lettura e sono rappresentati come set di dati virtuali in Experience Platform.
  • Non viene acquisita alcuna riga in Experience Platform. Vengono memorizzati solo i metadati, ad esempio schema, derivazione e dettagli di connessione.
  • È possibile applicare etichette e criteri di governance standard allo schema virtuale, ma i processi di privacy/conservazione non modificano i dati di origine.

Raccogli le credenziali richieste gather-required-credentials

Per autenticare e utilizzare l’origine Delta Sharing, è necessario fornire i valori per le credenziali seguenti:

Credenziali
Descrizione
Esempio
Endpoint
L’endpoint è l’URL di base del server Delta Sharing che ospita le tabelle condivise. Generato da Databricks quando è abilitato Delta Sharing esterno, questo endpoint viene visualizzato nel file di credenziali .share del destinatario e viene utilizzato da Experience Platform per enumerare condivisioni, sfogliare schemi e tabelle e recuperare metadati e anteprime di dati.
https://adb-1234567890123.4.azuredatabricks.net/api/2.0/delta-sharing/metastores/0a1b2c3d-4e5f-6789-abcd-0123456789ef
Token Bearer
Il token Bearer è un token di accesso Delta Sharing di sola lettura associato a un destinatario specifico in Databricks. Autentica Experience Platform come destinatario nel server Delta Sharing includendolo come intestazione di autorizzazione in ogni richiesta (Authorization: Bearer {BEARER_TOKEN}).
dapi1a2b3c4d5e6f7g8h9i0jklmnopqrstuvwx
Versione credenziali della condivisione
La versione delle credenziali di condivisione corrisponde a shareCredentialsVersion nel file .share. Si tratta della versione dello schema del file di credenziali, non di una versione token. Experience Platform lo utilizza per comprendere come interpretare i campi nel profilo. Per i profili Databricks Delta Sharing di oggi, il valore è 1.
1
Periodo di scadenza
La data di scadenza è una marca temporale opzionale che specifica quando scadrà il token Bearer. La data di scadenza deve essere in un timestamp UTC ISO-8601 valido.
2026-03-31T23:59:59Z

Tipi di dati di campo XDM consentiti allowed-xdm-field-data-types

Quando si mappano tabelle condivise a schemi Experience Platform, sono consentiti solo i seguenti tipi di dati di campo XDM:

  • Primitive di base: Stringa, Numero, Intero, Booleano
  • Sottotipi tramite vincoli: byte, breve, intero (32 bit), lungo
  • Temporale: Data, DateTime
  • Strutturale: Array, Oggetto
  • Varianti di stringa vincolate: Enum / Elenco suggerito (meta:enum)

Connetti a Databricks Delta Sharing nell’interfaccia utente

Leggi la Databricks Delta Sharing ​ guida dell’interfaccia utente per scoprire come acquisire dati in Experience Platform con l’origine Delta Sharing.

recommendation-more-help
experience-platform-help-sources