Introdução às transferências do Klaviyo

É possível carregar dados do Klaviyo para o BigQuery usando o serviço de transferência de dados do BigQuery para o conector do Klaviyo. Com o serviço de transferência de dados do BigQuery, você pode programar jobs de transferência recorrentes que adicionam seus dados mais recentes do Klaviyo ao BigQuery.

Para saber como programar uma transferência do Klaviyo, consulte Carregar dados do Klaviyo no BigQuery.

Limitações

As transferências incrementais do Klaviyo estão sujeitas às seguintes limitações:

  • Só é possível escolher colunas TIMESTAMP como colunas de marca d'água.
  • A ingestão incremental só é compatível com recursos que têm colunas de marca d'água válidas.
  • Os valores em uma coluna de marca d'água precisam aumentar monotonicamente.
  • As transferências incrementais não podem sincronizar operações de exclusão na tabela de origem.
  • Uma única configuração de transferência só pode oferecer suporte à ingestão incremental ou completa.
  • Não é possível atualizar objetos na lista asset após a primeira execução de ingestão incremental.
  • Não é possível mudar o modo de gravação em uma configuração de transferência após a primeira execução de ingestão incremental.
  • Não é possível mudar a coluna de marca d'água ou a chave primária após a primeira execução de ingestão incremental.
  • A tabela de destino do BigQuery é agrupada usando a chave primária fornecida e está sujeita a limitações de tabelas agrupadas.
  • Quando você atualiza uma configuração de transferência para o modo de ingestão incremental pela primeira vez, a primeira transferência de dados após essa atualização transfere todos os dados disponíveis da sua fonte de dados. As transferências de dados incrementais subsequentes vão transferir apenas as linhas novas e atualizadas da sua fonte de dados.

Opções de ingestão de dados

Estas seções descrevem as opções de ingestão de dados para configurar uma transferência de dados do Klaviyo.

Transferências completas ou incrementais

Você especifica como os dados são carregados no BigQuery selecionando a Completa ou Incremental preferência de gravação na configuração da transferência quando você configura uma transferência do Klaviyo. As transferências incrementais são compatíveis na versão prévia em prévia.

Você pode configurar uma transferência de dados completa para transferir todos os dados dos seus conjuntos de dados do Klaviyo com cada transferência de dados.

Como alternativa, você pode configurar uma transferência de dados incremental ([versão prévia](https://cloud.google.com/products#product-launch-stages)) para transferir apenas os dados que foram alterados desde a última transferência de dados, em vez de carregar todo o conjunto de dados com cada transferência de dados. Se você selecionar Incremental para a transferência de dados, especifique os modos de gravação Anexar ou Upsert para definir como os dados são gravados no BigQuery durante uma transferência de dados incremental. As seções a seguir descrevem os modos de gravação disponíveis.

Modo de gravação "Anexar"

O modo de gravação "Anexar" só insere novas linhas na tabela de destino. Essa opção anexa estritamente os dados transferidos sem verificar os registros existentes. Portanto, esse modo pode causar duplicação de dados na tabela de destino.

Ao selecionar o modo de anexação, você precisa selecionar uma coluna de marca d'água. Uma coluna de marca d'água é necessária para que o conector do Klaviyo rastreie as mudanças na tabela de origem.

Para transferências do Klaviyo, recomendamos selecionar uma coluna que só seja atualizada quando o registro for criado e que não mude com atualizações subsequentes, por exemplo, a coluna CREATED_AT.

Modo de gravação "Upsert"

O modo de gravação "Upsert" atualiza uma linha ou insere uma nova linha na tabela de destino verificando uma chave primária. Você pode especificar uma chave primária para permitir que o conector do Klaviyo determine quais mudanças são necessárias para manter a tabela de destino atualizada com a tabela de origem. Se a chave primária especificada estiver presente na tabela de destino do BigQuery durante uma transferência de dados, o conector do Klaviyo atualizará essa linha com novos dados da tabela de origem. Se uma chave primária não estiver presente durante uma transferência de dados, o conector do Klaviyo vai inserir uma nova linha.

Ao selecionar o modo "Upsert", você precisa selecionar uma coluna de marca d'água e uma chave primária:

  • Uma coluna de marca d'água é necessária para que o conector do Klaviyo rastreie as mudanças na tabela de origem.
    • Selecione uma coluna de marca d'água que seja atualizada sempre que uma linha for modificada. Recomendamos colunas semelhantes à coluna UPDATED_AT ou LAST_MODIFIED.

  • A chave primária pode ser uma ou mais colunas na tabela necessárias para que o conector do Klaviyo determine se precisa inserir ou atualizar uma linha.

    Selecione colunas que contenham valores não nulos que sejam exclusivos em todas as linhas da tabela. Recomendamos colunas que incluam identificadores gerados pelo sistema, códigos de referência exclusivos (por exemplo, IDs de incremento automático) ou IDs de sequência imutáveis baseados em tempo.

    Para evitar possível perda ou corrupção de dados, as colunas de chave primária selecionadas precisam ter valores exclusivos. Se você tiver dúvidas sobre a exclusividade da coluna de chave primária escolhida, recomendamos usar o modo de gravação "Anexar".

Mapeamento de tipo de dados

A tabela a seguir mapeia os tipos de dados do Klaviyo para os tipos de dados correspondentes do BigQuery:

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

Preços

Não há custo para transferir dados do Klaviyo para o BigQuery enquanto esse recurso estiver na versão prévia.

A seguir