Carica i dati di Klaviyo in BigQuery

Per pianificare trasferimenti di dati ricorrenti da Klaviyo a BigQuery, crea una configurazione di trasferimento per specificare quali oggetti di dati trasferire e con quale frequenza pianificare il trasferimento di dati. Puoi creare una configurazione del trasferimento utilizzando la console Google Cloud o lo strumento a riga di comando bq. Una volta configurata la configurazione del trasferimento, BigQuery Data Transfer Service trasferisce i dati più recenti in una tabella BigQuery in base alla pianificazione specificata.

Per scoprire come funziona un trasferimento Klaviyo, consulta Introduzione ai trasferimenti di dati Klaviyo.

Limitazioni

• Puoi scegliere solo TIMESTAMP colonne come colonne di watermark.
• L'importazione incrementale è supportata solo per gli asset con colonne di watermark valide.
• I valori in una colonna di watermark devono essere in ordine crescente.
• 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 del watermark o la chiave primaria dopo la prima esecuzione dell'importazione incrementale.
• La tabella BigQuery di destinazione è raggruppata in cluster utilizzando la chiave primaria fornita ed è soggetta alle limitazioni delle tabelle in cluster.
• Quando aggiorni una configurazione del trasferimento esistente alla modalità di importazione incrementale per la prima volta, 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.

Prima di iniziare

Le sezioni seguenti descrivono i prerequisiti da soddisfare prima di creare un trasferimento di dati Klaviyo.

Prerequisiti di Klaviyo

Devi disporre di una chiave API privata di sola lettura per consentire al connettore Klaviyo di trasferire i dati a BigQuery. Per saperne di più, consulta Crea una chiave privata.

Prerequisiti di BigQuery

• Verifica di aver completato tutte le azioni richieste per abilitare BigQuery Data Transfer Service.
• Crea un set di dati BigQuery per archiviare i dati.

Ruoli BigQuery richiesti

Per ottenere le autorizzazioni necessarie per creare un trasferimento di dati BigQuery Data Transfer Service, chiedi all'amministratore di concederti il ruolo IAM Amministratore BigQuery (roles/bigquery.admin) sul tuo progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene le autorizzazioni necessarie per creare un trasferimento di dati di BigQuery Data Transfer Service. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Per saperne di più, consulta Concedi l'accesso a bigquery.admin.

Se intendi configurare le notifiche di esecuzione del trasferimento per Pub/Sub, assicurati di disporre dell'autorizzazione IAM pubsub.topics.setIamPolicy. Le autorizzazioni Pub/Sub non sono necessarie se configuri solo le notifiche via email. Per saperne di più, consulta Notifiche di esecuzione di BigQuery Data Transfer Service.

Configura un trasferimento di dati Klaviyo

Aggiungi i dati di Klaviyo a BigQuery configurando un trasferimento con una delle seguenti opzioni:

bq mk
    --transfer_config
    --project_id=PROJECT_ID
    --data_source=DATA_SOURCE
    --display_name=NAME
    --target_dataset=DATASET
    --params='PARAMETERS'

    bq mk
        --transfer_config
        --target_dataset=mydataset
        --data_source=klaviyo
        --display_name='My Transfer'
        --params= ' {
            "assets": [ "Events" , "Flows"] ,
            "connector.authentication.privateApiKey" : "pk_123456789123",
            "connector.startDate": "2025-10-20"
            }'

Per eseguire manualmente un trasferimento di dati al di fuori della pianificazione regolare, puoi avviare un'esecuzione di backfill.

Per un elenco dei dati inclusi in un trasferimento di dati Klaviyo, consulta il riferimento del modello dei dati Klaviyo.

Risolvi i problemi di configurazione del trasferimento

Se riscontri problemi durante la configurazione del trasferimento di dati, consulta Problemi di trasferimento di Klaviyo.

Passaggi successivi

• Per una panoramica di BigQuery Data Transfer Service, consulta Che cos'è BigQuery Data Transfer Service.
• Per informazioni sull'utilizzo dei trasferimenti, tra cui come ottenere informazioni su una configurazione di trasferimento, elencare le configurazioni di trasferimento e visualizzare la cronologia di esecuzione di un trasferimento, consulta Gestisci i trasferimenti.