Como funciona o mapeamento de registros

Visão geral

O Data Migrator oferece suporte ao mapeamento de registros durante a migração de dados para garantir que os registros sejam atualizados corretamente em várias execuções de migração. Atualmente, ID Externo Virtual (VEID) é a única estratégia de mapeamento de registros disponível, mas outra opção está em desenvolvimento.

Sem Mapeamento de Registros

Quando a Nenhuma opção é selecionada para uma migração, todos os registros de origem são inseridos na organização de destino. Os registros não são correspondidos entre a origem e o destino, o que pode criar duplicatas se os registros já existirem em ambos os locais.

VEID

VEID é uma estratégia com estado, baseada em mapeamento, que usa uma tabela interna de mapeamento para vincular registros de origem e destino. Ela lembra implantações anteriores e depende de mapeamentos históricos em vez de dados de destino em tempo real. Uma vez que existe um mapeamento de origem para destino, o relacionamento fica fixo, o que significa que não há ambiguidade para registros já migrados usando VEID.

Ela foi projetada para migrações repetidas quando:

• O Data Migrator é a única ferramenta de migração sendo usada

• A org de destino está vazia durante a primeira migração

• É necessária consistência de longo prazo entre as execuções

VEID garante:

• O mesmo registro de origem sempre atualiza o mesmo registro de destino mapeado

• Alterações nos campos de negócio não afetam a correspondência de registros

• As atualizações de registros são determinísticas depois que um mapeamento existe

No entanto, o VEID não avalia dados de destino em tempo real.

Como o VEID Funciona

O VEID segue um processo determinístico, orientado por mapeamento. O diagrama abaixo ilustra o fluxo completo.

1

Ler Registro de Origem

Cada registro de origem é processado individualmente durante a execução da migração.

2

Procurar Mapeamento no Banco de Dados do VEID

O sistema verifica se já existe um mapeamento para o ID do registro de origem.

3

Avaliar o Resultado do Mapeamento

Mapeamento Encontrado	Ação
Não	INSERIR um novo registro na org de destino.
Sim	ATUALIZAR o registro de destino já mapeado existente.

4

Salvar o Mapeamento

Quando não existe mapeamento, o sistema insere o registro na org de destino e cria um novo mapeamento. Nas migrações subsequentes, esse registro será atualizado em vez de ser inserido novamente. Esse processo se repete a cada execução de migração, permitindo que novos registros de origem adicionados sejam rastreados na tabela de mapeamento do VEID.

Limitações

Limitação Importante do VEID

• Ele não consegue mapear registros que já existem na organização de destino.

• Se outra ferramenta ou processo manual criar ou modificar registros na org de destino, os mapeamentos do VEID podem ficar desatualizados, podendo resultar em registros duplicados.

• Ele só pode rastrear registros migrados usando o Data Migrator.

Mapeamento Desatualizado

O VEID é tão confiável quanto sua tabela de mapeamento. Os mapeamentos ficam desatualizados quando registros são criados na org de destino, seja manualmente ou por outra ferramenta. O exemplo abaixo mostra como isso leva a registros duplicados.

Exemplo:

1. Um usuário executa uma migração de todos os registros de Contato para uma org vazia.

   1. Todos os registros de Contato são copiados da origem para a org de destino.

   2. Os mapeamentos do VEID são criados para cada registro.

2. Um usuário cria manualmente registros de Contato para Charlie e Alice tanto na org de destino quanto na org de origem.

3. O usuário executa outra migração de todos os registros de Contato da org de origem para a org de destino.

   1. Charlie e Alice não têm mapeamento VEID porque não foram migrados antes.

   2. Novos registros para Charlie e Alice são criados na org de destino.

   3. A org de destino agora tem registros duplicados para Charlie e Alice: um da criação manual e outro da migração.