Sincronizar e excluir dados do catálogo

Esta página aborda como sincronizar dados do catálogo com a ingestão de dados na nuvem (CDI). As sincronizações de catálogo são compatíveis com todas as fontes de CDI. A tabela de origem ou o formato de arquivo de cada uma estão documentados na página da respectiva fonte.

Etapa 1: Criar um novo catálogo

Antes de criar uma nova integração de CDI para catálogos, você precisa criar um novo catálogo ou identificar um catálogo existente que queira usar na integração. Há algumas formas de criar um novo catálogo, e qualquer uma delas funciona para a integração de CDI:

• Fazer upload de um CSV
• Criar um catálogo no dashboard da Braze ou durante a configuração da CDI.
• Criar um catálogo usando o endpoint Criar catálogo

Qualquer alteração no esquema do catálogo (por exemplo, adicionar novos campos ou mudar o tipo de campo) deve ser feita pelo dashboard do catálogo antes que os dados atualizados sejam sincronizados pela CDI. A Braze recomenda fazer essas atualizações quando a sincronização estiver pausada ou sem execução agendada. Assim, você evita conflitos entre os dados do seu data warehouse e o esquema na Braze.

Etapa 2: Configure a sincronização do catálogo

A configuração de uma sincronização de catálogo segue de perto o processo das sincronizações de dados de usuários na mesma fonte. Abra a página da sua fonte e selecione a guia Itens do catálogo para a tabela de origem ou o formato de arquivo. Depois, conclua o restante da configuração nessa página.

Independentemente da fonte que você usar, as seguintes regras se aplicam:

• Selecione o tipo de sincronização Catálogos ao criar a sincronização.
• O nome da integração deve ser exatamente igual ao nome do catálogo que você criou anteriormente.
• Se você já tem credenciais de uma sincronização existente, pode reutilizá-las. Só não se esqueça de estender o acesso à tabela de origem do catálogo.

Colunas obrigatórias

Como funciona a integração

Nota

O comportamento de sincronização nesta seção se aplica apenas às integrações de data warehouse. No armazenamento de arquivos, a Braze processa novos arquivos à medida que eles são enviados para o seu bucket ou contêiner.

Sempre que a sincronização é executada, a Braze extrai todas as linhas em que UPDATED_AT é posterior ao último valor sincronizado. As linhas que estão exatamente no carimbo de data/hora limite podem ser sincronizadas novamente se novas linhas tiverem esse mesmo carimbo de data/hora.

A Braze recomenda criar uma visualização no seu data warehouse a partir dos dados do catálogo. Assim, você configura uma tabela de origem que é totalmente atualizada a cada execução da sincronização. Com as visualizações, você não precisa reescrever a consulta toda vez. Para ver um exemplo prático no dialeto SQL do seu warehouse, confira a guia Itens do catálogo na página da sua fonte.

Seja qual for a fonte que você usar:

• Os dados obtidos da integração são usados para criar ou atualizar itens no catálogo de destino com base no id fornecido.
• Se DELETED estiver definido como true, o item correspondente do catálogo será excluído.
• A sincronização não registra pontos de dados, mas todos os dados sincronizados contam para o uso total do seu catálogo. Esse uso é medido com base no total de dados armazenados, então você não precisa se preocupar em sincronizar apenas os dados alterados.