Introduzione ai trasferimenti di dati Klaviyo

Puoi caricare i dati da Klaviyo a BigQuery utilizzando il 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 Caricare i dati Klaviyo in BigQuery.

Limitazioni

I trasferimenti incrementali di Klaviyo sono soggetti alle seguenti limitazioni:

  • Puoi scegliere solo le colonne TIMESTAMP come colonne watermark.
  • L'importazione incrementale è supportata solo per gli asset con colonne watermark valide.
  • I valori in una colonna watermark devono essere in aumento monotono.
  • I trasferimenti incrementali non possono sincronizzare le operazioni di eliminazione nella tabella di origine.
  • Una singola configurazione del trasferimento può supportare solo l'acquisizione incrementale o completa.
  • Non puoi aggiornare gli oggetti nell'elenco asset dopo la prima esecuzione dell'importazione incrementale.
  • Non puoi modificare la modalità di scrittura in una configurazione di trasferimento dopo la prima esecuzione dell'importazione incrementale.
  • Non puoi modificare la colonna watermark o la chiave primaria dopo la prima esecuzione dell'importazione incrementale.
  • La tabella BigQuery di destinazione viene raggruppata utilizzando la chiave primaria fornita ed è soggetta alle limitazioni delle tabelle in cluster.
  • Quando aggiorni per la prima volta una configurazione del trasferimento esistente alla modalità di importazione incrementale, il primo trasferimento di dati dopo l'aggiornamento trasferisce tutti i dati disponibili dall'origine dati. Tutti i trasferimenti di dati incrementali successivi trasferiranno solo le righe nuove e aggiornate dall'origine dati.

Opzioni di acquisizione dei dati

Queste sezioni descrivono le opzioni di importazione dati per configurare un trasferimento di dati Klaviyo.

Trasferimenti completi o incrementali

Quando configuri un trasferimento Klaviyo, devi specificare come caricare i dati in BigQuery selezionando la preferenza di scrittura Completa o Incrementale nella configurazione di trasferimento. I trasferimenti incrementali sono supportati in anteprima.

Puoi configurare un trasferimento di dati completo per trasferire tutti i dati dai set di dati Klaviyo a 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 a ogni trasferimento di dati. Se selezioni Incrementale per il trasferimento di dati, devi specificare le modalità di scrittura Aggiungi o Esegui upsert per definire come i dati vengono scritti in BigQuery durante un trasferimento di dati incrementale. Le sezioni seguenti descrivono le modalità di scrittura disponibili.

Modalità di scrittura Aggiungi

La modalità di scrittura Aggiungi 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à Aggiungi, devi selezionare una colonna watermark. La colonna watermark è necessaria per consentire al connettore Klaviyo di 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 colonna CREATED_AT.

Modalità di scrittura Esegui upsert

La modalità di scrittura Esegui upsert aggiorna una riga o ne inserisce una nuova nella tabella di destinazione verificando la presenza di una chiave primaria. Puoi specificare una chiave primaria per consentire al connettore Klaviyo di determinare le modifiche necessarie per mantenere aggiornata la tabella di destinazione 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à Esegui upsert, devi selezionare una colonna watermark e una chiave primaria:

  • La colonna watermark è necessaria per consentire al connettore Klaviyo di monitorare le modifiche nella tabella di origine.
    • Seleziona una colonna watermark che si aggiorna ogni volta che una riga viene modificata. Ti consigliamo di utilizzare colonne simili a UPDATED_AT o LAST_MODIFIED.

  • La chiave primaria può essere una o più colonne della tabella necessarie per consentire al connettore Klaviyo di 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 basati sul tempo immutabili.

    Per evitare potenziali perdite o danneggiamenti dei dati, le colonne di chiave primaria selezionate devono avere valori univoci. Se hai dubbi sull'univocità della colonna di chiave primaria scelta, ti consigliamo di utilizzare la modalità di scrittura Aggiungi.

Mappatura dei tipi di dati

La seguente tabella 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
Boolean BOOLEAN
Date (YYYY-MM-DD HH:MM:SS) TIMESTAMP
List ARRAY

Prezzi

Il trasferimento dei dati Klaviyo in BigQuery non comporta costi durante l'antieliminare questa funzionalità in anteprima.

Passaggi successivi