Introduzione ai trasferimenti di dati di Klaviyo
Puoi caricare i dati da Klaviyo a BigQuery utilizzando il connettore BigQuery Data Transfer Service per Klaviyo. Con BigQuery Data Transfer Service, puoi pianificare job di trasferimento ricorrenti che aggiungono i dati più recenti da Klaviyo a BigQuery.
Per scoprire come pianificare un trasferimento Klaviyo, consulta Carica i dati Klaviyo in BigQuery.
Opzioni di acquisizione dei dati
Queste sezioni descrivono le opzioni di importazione dati per configurare un trasferimento di dati Klaviyo.
Trasferimenti completi o incrementali
Puoi specificare il modo in cui i dati vengono caricati in BigQuery selezionando la preferenza di scrittura Completa o Incrementale nella configurazione del trasferimento quando configuri un trasferimento Klaviyo. I trasferimenti incrementali sono supportati in anteprima.
Puoi configurare un trasferimento di dati completo per trasferire tutti i dati dai tuoi set di dati Klaviyo con ogni trasferimento di dati.In alternativa, puoi configurare un trasferimento di dati incrementale (anteprima) per trasferire solo i dati modificati dall'ultimo trasferimento di dati, anziché caricare l'intero set di dati con ogni trasferimento di dati. Se selezioni Incrementale per il trasferimento di dati, devi specificare le modalità di scrittura Aggiungi o Esegui upsert per definire il modo in cui i dati vengono scritti in BigQuery durante un trasferimento di dati incrementale. Le sezioni seguenti descrivono le modalità di scrittura disponibili.
Modalità di scrittura Append
La modalità di scrittura Append inserisce solo nuove righe nella tabella di destinazione. Questa opzione aggiunge rigorosamente i dati trasferiti senza verificare la presenza di record esistenti, pertanto questa modalità può potenzialmente causare la duplicazione dei dati nella tabella di destinazione.
Quando selezioni la modalità di aggiunta, devi selezionare una colonna watermark. Per il connettore Klaviyo è necessaria una colonna di watermark per monitorare le modifiche nella tabella di origine.
Per i trasferimenti Klaviyo, ti consigliamo di selezionare una colonna che viene aggiornata solo quando il record è stato creato e non cambia con gli aggiornamenti successivi, ad esempio la colonnaCREATED_AT.
Modalità di scrittura Upsert
La modalità di scrittura upsert aggiorna una riga o ne inserisce una nuova nella tabella di destinazione controllando la presenza di una chiave primaria. Puoi specificare una chiave primaria per consentire al connettore Klaviyo di determinare le modifiche necessarie per mantenere la tabella di destinazione aggiornata con la tabella di origine. Se la chiave primaria specificata è presente nella tabella BigQuery di destinazione durante un trasferimento di dati, il connettore Klaviyo aggiorna la riga con i nuovi dati della tabella di origine. Se una chiave primaria non è presente durante un trasferimento di dati, il connettore Klaviyo inserisce una nuova riga.
Quando selezioni la modalità di upsert, devi selezionare una colonna watermark e una chiave primaria:
- Per consentire al connettore Klaviyo di monitorare le modifiche nella tabella di origine, è necessaria una colonna di watermark.
- Seleziona una colonna di watermark che si aggiorna ogni volta che viene modificata una riga. Consigliamo colonne simili alla colonna
UPDATED_AToLAST_MODIFIED.
- Seleziona una colonna di watermark che si aggiorna ogni volta che viene modificata una riga. Consigliamo colonne simili alla colonna
La chiave primaria può essere una o più colonne della tabella necessarie al connettore Klaviyo per determinare se deve inserire o aggiornare una riga.
Seleziona le colonne che contengono valori non nulli univoci in tutte le righe della tabella. Ti consigliamo di utilizzare colonne che includono identificatori generati dal sistema, codici di riferimento univoci (ad esempio ID con incremento automatico) o ID di sequenza immutabili basati sul tempo.
Per evitare potenziali perdite o danneggiamenti dei dati, le colonne della chiave primaria che selezioni devono avere valori univoci. Se hai dubbi sull'unicità della colonna della chiave primaria scelta, ti consigliamo di utilizzare la modalità di scrittura Aggiungi.
Mappatura dei tipi di dati
La tabella seguente mappa i tipi di dati Klaviyo ai tipi di dati BigQuery corrispondenti:
| Tipo di dati Klaviyo | Tipo di dati BigQuery |
|---|---|
String |
STRING |
Text |
STRING |
Integer |
INTEGER |
Float |
FLOAT |
Boolean |
BOOLEAN |
Date (YYYY-MM-DD HH:MM:SS) |
TIMESTAMP |
List |
ARRAY |
JSON |
JSON |
Record |
RECORD |
Prezzi
Il trasferimento dei dati di Klaviyo in BigQuery non prevede costi mentre questa funzionalità è in Anteprima.
Passaggi successivi
- Per una panoramica di BigQuery Data Transfer Service, consulta Che cos'è BigQuery Data Transfer Service.