Introduzione ai trasferimenti di 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 di Klaviyo, consulta Caricare i dati di 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 di trasferimento può supportare solo l'importazione 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 sottoposta a clustering utilizzando la chiave primaria fornita ed è soggetta alle limitazioni delle tabelle con clustering.
  • Quando aggiorni per la prima volta una configurazione di 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 importazione dei dati

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

Trasferimenti completi o incrementali

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

Puoi configurare un trasferimento di dati completo per trasferire tutti i dati dai set di dati di Klaviyo a ogni trasferimento di dati.

In alternativa, puoi configurare un trasferimento di dati incrementale ([Anteprima](https://cloud.google.com/products#product-launch-stages)) 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 vengono scritti i dati 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à di aggiunta, devi selezionare una colonna watermark. Per consentire al connettore Klaviyo di monitorare le modifiche nella tabella di origine, è necessaria una colonna watermark.

Per i trasferimenti di Klaviyo, ti consigliamo di selezionare una colonna che viene aggiornata solo al momento della creazione del record 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 inserisce una nuova riga 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 non è presente una chiave primaria 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:

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

  • 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 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 di Klaviyo ai tipi di dati BigQuery corrispondenti:

Tipo di dati di Klaviyo Tipo di dati di BigQuery
String STRING
Text STRING
Integer INTEGER
Boolean BOOLEAN
Date (YYYY-MM-DD HH:MM:SS) TIMESTAMP
List ARRAY

Prezzi

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

Passaggi successivi