Ingestão de dados na nuvem: Mapeador visual
Esta página explica como usar o mapeador visual para sincronizar uma tabela ou view do seu data warehouse com a Braze sem escrever SQL ou reestruturar seus dados.
O mapeador visual está disponível para sincronizações de atributos, eventos personalizados e disparos de Canvas em todas as fontes de data warehouse da Ingestão de dados na nuvem. Para outros tipos de sincronização, consulte Escolha uma opção de definição de dados.
Com o mapeador visual, você pode sincronizar uma tabela ou view existente do seu data warehouse sem escrever SQL ou reestruturar seus dados. Em vez de criar uma tabela específica da Braze com as colunas EXTERNAL_ID, UPDATED_AT e PAYLOAD, você mapeia as colunas da sua tabela existente para campos da Braze diretamente no dashboard.
Pré-requisitos
Antes de criar uma sincronização com o mapeador visual, você precisa de:
- Uma fonte de data warehouse ativa de Cloud Data Ingestion. Se você ainda não configurou uma, consulte Integrações de data warehouse.
- O nome da tabela ou view que você deseja sincronizar, conforme aparece no seu data warehouse.
- Uma coluna na sua tabela que contenha um identificador de usuário compatível e uma coluna com um timestamp que a Braze possa usar para rastreamento de alterações.
A Braze executa apenas consultas somente leitura nos seus dados e não modifica as tabelas subjacentes. Objetos temporários podem ser criados durante a execução da consulta, mas não são persistidos.
Criando uma sincronização com o mapeador visual
Etapa 1: Configurar a sincronização
- Acesse Configurações de Dados > Cloud Data Ingestion > Sincronizações e selecione Criar sincronização de dados.
- Escolha um nome para a sincronização e selecione uma fonte de dados ativa. Somente fontes ativas podem ser usadas.
- Em Destino dos dados, selecione Braze Data Platform.
- Selecione um Tipo de dados.
- Selecione Avançar: Definição de dados.
Etapa 2: Mapear o esquema de origem
- Na etapa Definição de dados, selecione Visual.
- Insira o nome da tabela ou view exatamente como ele aparece no seu data warehouse.
- Selecione Mapear esquema de origem. A Braze lê o esquema da sua tabela ou view e lista todas as colunas com o tipo de dado detectado para que você possa mapeá-las para um campo da Braze.
Etapa 3: Revisar seus mapeamentos
A seção Revisar mapeamento rastreia dois mapeamentos obrigatórios. Sua sincronização não pode ser criada até que ambos estejam completos:
- Mapeie uma coluna para um identificador de usuário aceito pela Braze:
external_id,braze_id,email,phoneou um alias de usuário. As opções de identificador aparecem em Identificadores no menu suspenso do campo de destino. - Mapeie uma coluna para
updated_at. A Braze usa esse timestamp para rastreamento de alterações, em que cada execução da sincronização importa as linhas cujoupdated_até posterior ao último valor sincronizado.
Para cada coluna restante, você pode:
- Manter o mapeamento padrão. Cada coluna é mapeada para um campo da Braze com o mesmo nome. Se o campo ainda não existir no seu espaço de trabalho, ele será marcado como Novo atributo e será criado durante a primeira execução da sincronização.
- Mapear para um campo existente. Pesquise no menu suspenso do campo de destino para mapear uma coluna a um atributo padrão ou personalizado existente no seu espaço de trabalho.
- Mapear para um novo campo. Digite diretamente no menu suspenso do campo de destino para mapear uma coluna a um novo atributo personalizado.
- Excluir a coluna. Desmarque a caixa de seleção Importar para deixar uma coluna fora da sincronização.
Antes de criar um novo atributo, pesquise no menu suspenso de destino por um já existente. Por exemplo, se sua tabela tem uma coluna fav_color, mas seu espaço de trabalho já rastreia favorite_color, considere mapear fav_color para favorite_color em vez de criar outro atributo.
Campos cujo tipo de dado não corresponde ao tipo detectado da sua coluna exibem um aviso de Incompatibilidade de tipo. Você ainda pode prosseguir, mas valores incompatíveis podem falhar na sincronização como erros de linha. Você pode visualizar os erros de linha nos detalhes de execução de uma sincronização.
Etapa 4: Pré-visualizar e validar
Selecione Pré-visualizar e validar para executar uma verificação somente leitura na sua tabela ou view. A prévia mostra as 10 primeiras linhas usando os nomes dos campos mapeados e inclui apenas as colunas que você está importando.
Etapa 5: Concluir a criação da sincronização
- Na etapa Notificações, insira pelo menos um e-mail de contato para notificações de erros de sincronização. Opcionalmente, você pode ativar alertas de Erro de linha (enviados quando uma porcentagem de linhas falha na atualização) e notificações de Sincronização bem-sucedida.
- Na etapa Cronograma, ative a Sincronização recorrente para executar a sincronização em um cronograma, ou deixe desativada para uma sincronização única.
- Revise a etapa Resumo. Ela lista sua configuração, quais atributos são novos versus existentes e quaisquer colunas excluídas da importação devido a problemas de tipo de dado ou às suas seleções.
- Selecione Criar sincronização. Você também pode selecionar Salvar como rascunho em qualquer etapa para concluir depois.
Tratamento de alterações no esquema
O mapeador visual verifica o esquema da sua tabela ou view a cada execução de sincronização e responde de acordo com o tipo de alteração:
| Alteração na tabela de origem | Comportamento da sincronização |
|---|---|
| Uma nova coluna é adicionada | A sincronização continua, mas as novas colunas não são sincronizadas automaticamente. Para incluir uma, edite a sincronização e mapeie-a. |
| Uma coluna mapeada é removida | A execução da sincronização falha e a sincronização é pausada. A alteração no esquema é exibida nos detalhes da execução da sincronização, e seus contatos de notificação recebem um alerta por e-mail. |
| Uma coluna mapeada é renomeada | Tratada como uma coluna removida mais uma nova coluna. |
| O tipo de dados de uma coluna muda | Não é detectado como uma alteração de esquema. Valores incompatíveis são reportados como erros de linha nos logs de sincronização. |
Para retomar uma sincronização pausada após a remoção de uma coluna, selecione Edit sync e revise seus mapeamentos. A coluna removida é sinalizada e não aparece mais no mapeador. Salvar seus mapeamentos confirma que a sincronização deve continuar sem aquela coluna. Como alternativa, se os dados foram movidos para uma coluna diferente, mapeie a nova coluna antes de salvar.
Perguntas frequentes
Posso editar meus mapeamentos depois que uma sincronização é criada?
Sim. Edite a sincronização e selecione View and edit mapping. O esquema atual da tabela de origem é carregado, com os mapeamentos anteriores da criação da sincronização salvos. Você pode editar seus mapeamentos a partir daí.
Posso transformar meus dados no mapeador visual?
Não. O mapeador visual sincroniza os valores das colunas exatamente como aparecem na sua fonte. Ele não oferece suporte a transformações, lógica condicional ou junções entre tabelas. Para esses casos de uso, use a opção SQL na etapa de definição de dados para formatar seus dados com uma consulta. Para saber mais, consulte Ingestão de dados na nuvem: editor SQL.
Minhas sincronizações CDI existentes são alteradas?
Não. As sincronizações que usam o formato de tabela existente com as colunas EXTERNAL_ID, UPDATED_AT e PAYLOAD continuam funcionando, e você ainda pode criá-las.
Como meu uso da Braze é afetado?
Cada coluna que você importa e mapeia grava como uma atualização de campo na Braze, e a cobrança de pontos de dados funciona da mesma forma que outras sincronizações de dados de usuários via CDI. Excluir colunas desnecessárias mantém suas sincronizações eficientes. Para saber mais, consulte Práticas recomendadas de ingestão de dados na nuvem.