Sincronizar dados do BrazeAI Decisioning Studio
Esta página explica como sincronizar dados do seu data warehouse diretamente com o BrazeAI Decisioning Studio™ usando a ingestão de dados na nuvem (CDI).
Com o destino Decisioning Studio da CDI, a CDI também pode sincronizar dados do warehouse diretamente com o BrazeAI Decisioning Studio. Os dados dessas sincronizações ficam disponíveis para ativação no Decisioning Studio, mas seus perfis de usuário e espaços de trabalho da Braze permanecem inalterados.
Esse recurso está em acesso antecipado. Entre em contato com seu gerente de sucesso do cliente ou gerente de conta para obter acesso.
Como funciona
Ao criar uma sincronização, escolha o Decisioning Studio como destino e escreva uma consulta SQL que retorne os dados que você deseja sincronizar. A CDI executa essa consulta no cronograma que você definir e entrega os resultados como um ativo do Decisioning Studio. Cada sincronização corresponde a um único ativo, então não é possível apontar mais de uma sincronização para o mesmo ativo.
Diferente das sincronizações com a Braze Data Platform, as sincronizações do Decisioning Studio não mapeiam seus dados para perfis de usuário, eventos ou catálogos.
Para conhecer as outras formas de disponibilizar dados para o Decisioning Studio, consulte Conectar seus dados.
Pré-requisitos
- Acesso à Braze e ao BrazeAI Decisioning Studio.
- Uma fonte de data warehouse ativa do Cloud Data Ingestion. Se você ainda não configurou uma, consulte Fontes do Cloud Data Ingestion.
- A tabela ou visualização que você deseja sincronizar.
- Uma coluna (ou colunas) dessa tabela para usar como chave primária e uma coluna de carimbo de data/hora que o CDI possa usar na sincronização incremental.
Criar uma sincronização do Decisioning Studio
Etapa 1: Crie a sincronização e selecione o destino
- Acesse Configurações de dados > Ingestão de dados na nuvem > Sincronizações.
- Selecione Criar sincronização de dados.
- Insira um Nome da integração e selecione sua fonte em Fontes de dados.
- Em Destino, defina Destino dos dados como BrazeAI Decisioning Studio™.
- Em Categoria de dados, selecione o tipo de Dados do Decisioning Studio que melhor corresponde à sua tabela. Escolha entre Perfil de usuário, Eventos de engajamento com mensagem, Eventos de conversão ou Outros. Essa escolha marca os dados para o Decisioning Studio e não altera a forma como a CDI processa suas linhas.
Etapa 2: Escreva sua consulta SQL
Na etapa Definição de dados, escreva uma consulta SQL que retorne os dados da tabela ou view que você deseja sincronizar. O resultado da consulta se torna o esquema da sua sincronização.
Você pode usar o Source Explorer para navegar pelas tabelas e views disponíveis, ou o gerador de SQL com IA para ajudar a escrever sua consulta.
Sua consulta precisa retornar uma coluna UPDATED_AT, porque a CDI usa UPDATED_AT para sincronização incremental e rastreamento de alterações. A cada execução, a CDI sincroniza apenas as linhas em que UPDATED_AT é posterior ao último valor sincronizado. Se a coluna de data e hora que você identificou ainda não se chama UPDATED_AT, você pode criar um alias na consulta:
SELECT *, LAST_MODIFIED AS UPDATED_AT FROM my_table
Para saber mais sobre como UPDATED_AT controla a sincronização incremental, incluindo o que acontece quando você retrocede esse valor, consulte Entendendo a coluna UPDATED_AT.
Somente consultas de instrução única e somente leitura são aceitas, incluindo cláusulas JOIN. A CDI executa consultas somente leitura e não modifica suas tabelas subjacentes.
Etapa 3: Visualize e valide sua consulta
Selecione Visualizar e validar para executar sua consulta. A seção Prévia da consulta (primeiras 10 linhas) mostra as primeiras 10 linhas retornadas pela sua fonte, junto com o tipo de dado detectado em cada coluna. Assim, você confirma que os dados estão corretos antes de continuar.
Etapa 4: Selecione uma chave primária
Toda sincronização do Decisioning Studio precisa de uma chave primária ou composta, ou seja, uma ou mais colunas que identificam cada linha de forma exclusiva. Depois que a validação for concluída, abra o menu suspenso Chave primária e selecione uma coluna para servir como chave primária. Selecionar várias colunas forma uma chave composta.
Uma boa chave primária é única para cada linha, nunca fica vazia e se mantém estável entre as execuções de sincronização. Evite valores gerados no momento da consulta, como UUID() ou CURRENT_TIMESTAMP, pois eles podem causar linhas duplicadas ou descartadas.
Etapa 5: Defina notificações e cronograma e crie a sincronização
- Na etapa Notificações, insira um ou mais E-mails de contato para receber notificações de erros de sincronização. Você também pode ativar as notificações de Erro de linha e Sincronização bem-sucedida.
- Na etapa Cronograma, ative Sincronização recorrente para executar a sincronização automaticamente de acordo com um cronograma. Com a Sincronização recorrente desativada, a sincronização só é executada quando você a dispara, seja manualmente pelo dashboard ou pelo endpoint Disparar uma sincronização.
- Revise o Resumo e crie a sincronização.
Como editar uma sincronização
Ao editar uma sincronização existente, qualquer alteração na sua consulta SQL precisa ser validada novamente antes que você possa salvar. As chaves primárias e compostas não podem ser alteradas e ainda precisam ser retornadas pela consulta.
As alterações válidas entram em vigor na próxima execução da sincronização.
Lidando com mudanças de schema
A CDI lida com mudanças no schema da fonte de forma aditiva. A cada execução de sincronização, a CDI compara o schema da sua fonte com o ativo existente do Decisioning Studio. Então, ela adiciona as novas colunas e preserva as que já existem.
| Mudança na sua tabela de origem | Comportamento da sincronização |
|---|---|
| Uma nova coluna é adicionada | A CDI adiciona a coluna ao ativo do Decisioning Studio. As linhas entregues antes de a coluna existir mostram null para ela. |
| Uma coluna é removida | A CDI para de atualizar essa coluna, mas a coluna e os dados existentes permanecem no ativo. As outras colunas continuam sincronizando. |
| Uma coluna é renomeada | É tratada como uma coluna removida mais uma nova coluna. A coluna original permanece no ativo, e a nova coluna é adicionada. |
| O tipo de dado de uma coluna muda | A CDI converte os valores sempre que possível. As linhas que não podem ser convertidas são relatadas como erros de linha nos detalhes da execução da sincronização. |
Quando a CDI detecta uma mudança de schema, ela aparece nos detalhes da execução da sincronização e na página de edição da sincronização. Além disso, seus contatos de notificação recebem um alerta por e-mail. Para mudar quais colunas são entregues, atualize sua consulta SQL e valide novamente.