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 maneiras de criar um novo catálogo, e qualquer uma delas funciona para a integração de CDI:
- Faça upload de um CSV
- Crie um catálogo no dashboard da Braze ou durante a configuração da CDI.
- Crie um catálogo usando o endpoint Criar catálogo
Todas as alterações no esquema do catálogo (por exemplo, adicionar novos campos ou alterar o tipo de campo) devem ser feitas 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.
| Fonte | Configuração do catálogo |
|---|---|
| Snowflake | Tabela de origem do Snowflake |
| Amazon Redshift | Tabela de origem do Redshift |
| Google BigQuery | Tabela de origem do BigQuery |
| Databricks | Tabela de origem do Databricks |
| Microsoft Fabric | Tabela de origem do Microsoft Fabric |
| Amazon S3 | Formatos de arquivo do Amazon S3 |
| Google Cloud Storage | Formatos de arquivo do Google Cloud Storage |
| Azure Blob Storage | Formatos de arquivo do Azure Blob Storage |
Independentemente da fonte que você usar, as seguintes regras se aplicam:
- Selecione o tipo de sincronização Catálogos ao criar a sincronização.
- Insira um Nome da sincronização para identificar a sincronização.
- Em Catálogo a ser atualizado, selecione Usar catálogo existente e depois o catálogo, ou selecione Criar novo catálogo e insira o Nome do catálogo.
- 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
| Coluna | Obrigatória? | Descrição |
|---|---|---|
ID |
Sim | O ID do item do catálogo a ser criado ou atualizado. |
PAYLOAD |
Sim | Uma string JSON com os campos a serem sincronizados com o item do catálogo na Braze. |
DELETED |
Opcional | Quando definido como true, o item do catálogo correspondente é removido do catálogo. |
UPDATED_AT |
Somente fontes de data warehouse | O horário em que esta linha foi atualizada ou adicionada. As fontes de armazenamento de arquivos não são compatíveis com colunas UPDATED_AT. |
Como funciona a integração

O comportamento de sincronização nesta seção se aplica apenas às integrações de data warehouse. Para armazenamento de arquivos, a Braze processa novos arquivos à medida que eles são enviados para 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 com o carimbo de data/hora exato do 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 seu catálogo. Assim, você configura uma tabela de origem que é totalmente atualizada sempre que uma sincronização é executada. 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
idfornecido. - Se
DELETEDestiver definido comotrue, o item de catálogo correspondente 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.