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 nem 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 nem reestruturar seus dados na origem. 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ê precisará de:
- Uma fonte de data warehouse ativa do Cloud Data Ingestion. Se ainda não configurou uma, consulte Fontes do Cloud Data Ingestion.
- O nome da tabela ou visualização que você deseja sincronizar, exatamente como aparece no seu data warehouse.
- Uma coluna na sua tabela que contenha um identificador de usuário compatível e uma coluna com um carimbo de data/hora que a Braze possa usar para rastreamento de alterações.
A Braze executa apenas consultas somente leitura nos seus dados e não modifica suas tabelas subjacentes. Objetos temporários podem ser criados durante a execução da consulta, mas não são mantidos.
Criação de uma sincronização com o mapeador visual
Etapa 1: Configurar a sincronização
- Acesse Configurações de dados > Ingestão de dados na nuvem > Sincronizações e selecione Criar sincronização de dados.
- Escolha um nome para sua sincronização e selecione uma fonte de dados ativa. Só é possível usar fontes ativas.
- Em Destino dos dados, selecione Braze Data Platform.
- Selecione um Tipo de dados.
- Selecione Próximo: 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 da visualização exatamente como aparece no seu data warehouse.
- Selecione Mapear esquema de origem. A Braze lê o esquema da sua tabela ou visualização e lista cada coluna com o tipo de dados detectado. Assim, você pode mapear cada coluna para um campo da Braze.
Etapa 3: Revisar os mapeamentos
A seção Revisar mapeamento acompanha dois mapeamentos obrigatórios. Sua sincronização só pode ser criada depois que os dois estiverem concluídos:
- 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 registro de data e hora para rastrear alterações. Cada execução da sincronização importa as linhas em queupdated_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 aparece marcado como Novo atributo e é criado na primeira execução da sincronização.
- Mapear para um campo existente. Pesquise no menu suspenso do campo de destino para mapear uma coluna para um atributo padrão ou personalizado que já existe no seu espaço de trabalho.
- Mapear para um novo campo. Digite diretamente no menu suspenso do campo de destino para mapear uma coluna para 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, procure um atributo existente no menu suspenso de destino. Por exemplo, se a 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 dados não corresponde ao tipo detectado na coluna exibem um alerta de Incompatibilidade de tipo. Você ainda pode continuar, mas os valores incompatíveis podem não ser sincronizados e aparecer como erros de linha. Você pode ver os erros de linha nos detalhes de execução da sincronização.
Etapa 4: Visualizar e validar
Selecione Visualizar e validar para executar uma verificação somente leitura na sua tabela ou visualização. A prévia mostra as 10 primeiras linhas com os nomes dos campos mapeados e inclui somente as colunas que você vai importar.
Etapa 5: Concluir a criação da sincronização
- Na etapa Notificações, insira pelo menos um e-mail de contato para receber notificações de erros de sincronização. Se quiser, ative os alertas de Erro de linha (enviados quando uma porcentagem das linhas não é atualizada) e as notificações de Sincronização bem-sucedida.
- Na etapa Cronograma, ative Sincronização recorrente para executar a sincronização de forma agendada, ou deixe essa opção desativada para uma sincronização única.
- Revise a etapa Resumo. Ela lista sua configuração, quais atributos são novos e quais já existem, além das colunas excluídas da importação por problemas de tipo de dados ou pelas suas seleções.
- Selecione Criar sincronização. Você também pode selecionar Salvar como rascunho em qualquer etapa para terminar depois.
Tratamento de alterações no esquema
O mapeador visual verifica o esquema da sua tabela ou visualização a cada execução de sincronização. A resposta depende do tipo de alteração:
| Alteração na tabela de origem | Comportamento da sincronização |
|---|---|
| Uma nova coluna é adicionada | A sincronização continua, mas novas colunas não são sincronizadas automaticamente. Para incluir uma coluna, edite a sincronização e faça o mapeamento dela. |
| Uma coluna mapeada é removida | A execução da sincronização falha e a sincronização é pausada. A alteração no esquema aparece 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 coluna nova. |
| O tipo de dado de uma coluna muda | Não é detectado como alteração no esquema. Valores incompatíveis são informados como erros de linha nos registros de sincronização. |
Para retomar uma sincronização pausada depois que uma coluna for removida, selecione Editar sincronização e revise seus mapeamentos. A coluna removida fica sinalizada e não aparece mais no mapeador. Ao salvar seus mapeamentos, você confirma que a sincronização deve continuar sem essa coluna. Se os dados tiverem sido movidos para outra coluna, mapeie a nova coluna antes de salvar.
Perguntas frequentes
Posso editar meus mapeamentos depois que uma sincronização for criada?
Sim. Edite a sincronização e selecione Visualizar e editar mapeamento. O esquema atual da tabela de origem é carregado com os mapeamentos que você salvou ao criar a sincronização. A partir daí, você pode editar seus mapeamentos.
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. Nesses casos, use a opção SQL na etapa de definição de dados para estruturar seus dados com uma consulta. Para saber mais, consulte Cloud Data Ingestion: Editor SQL.
Minhas sincronizações de CDI existentes mudam?
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 é gravada como uma atualização de campo na Braze. A cobrança de pontos de dados funciona da mesma forma que em outras sincronizações de dados de usuários da CDI. Excluir as colunas de que você não precisa mantém suas sincronizações eficientes. Para saber mais, consulte Práticas recomendadas da Cloud Data Ingestion.