OneTrace.pro Centro assistenza

Esportazione nei data warehouse

L'esportazione copia regolarmente i dati del progetto nel Suo data warehouse: profili, eventi e, a scelta, messaggi, segmenti, consensi e prodotti. Gli analisti li usano con i propri strumenti: creano report nella BI, li uniscono ai dati del sistema gestionale, addestrano modelli.

La direzione opposta, cioè la lettura delle righe modificate dal Suo data warehouse nei profili e negli eventi, la svolge una sorgente di dati.

La sezione si trova in Dati → Data warehouse. L'esportazione nei data warehouse è disponibile con il piano «Enterprise», vedi Piani.

Esportazioni verso BigQuery, S3 e ClickHouse

Dove si può esportare

Data warehouse Come arrivano i dati
S3 (AWS, Yandex Object Storage, MinIO) file NDJSON.gz nel Suo bucket
Google Cloud Storage file NDJSON.gz nel Suo bucket
BigQuery tabelle in un dataset del progetto Google Cloud
Snowflake tabelle in uno schema; i dati passano attraverso il Suo bucket AWS S3
ClickHouse tabelle in un database sul Suo server
PostgreSQL tabelle in uno schema sul Suo server

Prima occorre collegare il data warehouse nella pagina Integrazioni, nel gruppo Data warehouse: indichi le credenziali di accesso e poi faccia clic su Verifica.

  • S3: bucket, chiavi di accesso e, per Yandex Object Storage e MinIO, l'indirizzo dell'API.
  • Google Cloud Storage e BigQuery: la chiave di un account di servizio (JSON). Per Cloud Storage l'account deve avere il ruolo Storage Object User sul bucket, per BigQuery i ruoli BigQuery Data Editor e BigQuery Job User. Per BigQuery si indica anche la posizione dei dati: EU, US o una regione.
  • Snowflake: account, utente con la sua chiave privata RSA senza password, ruolo, warehouse di calcolo e un bucket AWS S3 con le chiavi. Assegni la chiave pubblica all'utente con il comando ALTER USER … SET RSA_PUBLIC_KEY.
  • ClickHouse: indirizzo dell'interfaccia HTTP, ad esempio https://ch.example.com:8443, utente e password.
  • PostgreSQL: host, porta, database, utente, password e crittografia della connessione.

Il server ClickHouse o PostgreSQL deve essere raggiungibile da internet: gli indirizzi delle reti interne non sono accettati.

Come creare un'esportazione

  1. Faccia clic su Nuova esportazione.
  2. Inserisca un nome e scelga il Data warehouse: non è possibile cambiarlo dopo la creazione.
  3. Selezioni Cosa esportare. Profili ed eventi vengono esportati sempre.
  4. Nel campo Storico dal scelga la data da cui esportare eventi e messaggi la prima volta, oppure lasci il campo vuoto: in questo caso verrà esportato tutto lo storico. Profili, segmenti, consensi e prodotti vengono esportati per intero.
  5. Scelga la Pianificazione: ogni ora, ogni 3, 6 o 12 ore oppure una volta al giorno.
  6. Compili le impostazioni del data warehouse: la cartella nel bucket, il dataset BigQuery, il database e lo schema Snowflake, il database ClickHouse o lo schema PostgreSQL. Dataset, database e schema vengono creati automaticamente se non esistono. Il prefisso delle tabelle serve se più esportazioni scrivono nello stesso database.
  7. Faccia clic su Salva. La prima esportazione partirà entro un minuto.

Impostazioni dell'esportazione

La prima esportazione di uno storico lungo avviene a parti e può richiedere alcune ore: finché non termina, sulla scheda è visibile l'etichetta Prima esportazione. Le esecuzioni successive trasmettono solo ciò che è cambiato dalla volta precedente.

Cosa viene esportato

Dati Tabelle Contenuto
Profili profiles attributi, identificatori (email, telefono, user_id …), prima e ultima visita, unione (merged_into_id) ed eliminazione
Eventi events tutti gli eventi del sito, dell'API e di sistema ($message_*, $segment_* e altri), proprietà e contesto
Messaggi messages canale, oggetto, modello, campagna e variante, percorso, stato e ora di ogni stato, destinatario
Segmenti segments, segment_members elenco dei segmenti; chi fa parte del segmento ora, quando vi è entrato e quando ne è uscito
Consensi consents, preferences consensi per canale e argomento; frequenza e pausa dal centro preferenze
Prodotti products catalogo con prezzi, disponibilità, categorie, caratteristiche e valutazioni

La tabella degli eventi viene solo integrata con nuove righe. Le altre tabelle vengono aggiornate per chiave: un profilo, un messaggio o un prodotto modificato sostituisce la riga precedente. Attributi, proprietà e contesto degli eventi sono in JSON. Gli orari sono in UTC.

Le tabelle vengono create automaticamente; se in una nuova versione di OneTrace.pro una tabella riceve una nuova colonna, questa verrà aggiunta.

Particolarità dei data warehouse:

  • S3 e Google Cloud Storage: i file si trovano nella cartella events/dt=2026-10-29/. Nelle tabelle aggiornate per chiave, la riga attuale di una chiave è l'ultima per updated_at. Gli schemi delle tabelle sono nella cartella _schema.
  • BigQuery: gli eventi sono partizionati per giorno dell'evento e raggruppati per nome dell'evento e profilo, quindi le query su un periodo leggono meno dati.
  • ClickHouse: legga le tabelle aggiornate per chiave con FINAL; il JSON è memorizzato come stringa: estragga i valori con le funzioni JSONExtract….

Profili cancellati

Quando un profilo viene cancellato su richiesta del cliente (vedi Profili), l'esecuzione successiva dell'esportazione elimina le sue righe anche dal data warehouse: da profili, eventi, messaggi, appartenenza ai segmenti e consensi. In S3 e Google Cloud Storage i file già scritti non vengono modificati: l'elenco dei profili cancellati viene salvato nella cartella _erasures e spetta a Lei eliminare le loro righe nei Suoi sistemi.

Esecuzioni ed errori

Sulla scheda dell'esportazione sono visibili la pianificazione, l'ultima esecuzione e quante righe sono state inviate in ogni tabella. Cronologia mostra le ultime esecuzioni.

Cronologia delle esecuzioni dell'esportazione

  • Esegui ora: esporta subito le modifiche, senza attendere la pianificazione.
  • Metti in pausa: sospende l'esportazione; le modifiche si accumulano e verranno inviate dopo Riprendi.
  • Riesportare da zero: l'esecuzione successiva invierà tutti i dati, come la prima volta. Se le tabelle del data warehouse non vengono svuotate, gli eventi saranno duplicati.

Se il data warehouse è temporaneamente non disponibile, l'esportazione ripete l'esecuzione dopo 1, 5, 15, 30 e 60 minuti e riprende dal punto in cui si era fermata: le parti già accettate non vengono inviate due volte. Se l'accesso è stato revocato o il database non è stato trovato, sulla scheda compare un errore: corregga la connessione nella pagina Integrazioni e l'esecuzione successiva proseguirà l'esportazione.

Chi può configurare le esportazioni

Nel data warehouse finiscono dati personali dei clienti. Per questo la sezione è visibile ai ruoli con il permesso di esportare i profili, mentre creare, modificare e avviare le esportazioni può solo chi ha anche il permesso di gestire le integrazioni e quello di vedere i dati personali non mascherati. Tra i ruoli di sistema si tratta di «Proprietario» e «Amministratore». Maggiori dettagli nell'articolo Membri e ruoli.