Execute uma carga em massa
Antes de começar
- Tipos de entidade, padronização e validação configurados. Carregar primeiro e configurar depois significa recomputar tudo.
- A permissão
bulk-job.create.
1. Carregue na ordem de dependência
| Ordem | Carregue | Porque |
|---|---|---|
| 1 | Dados de referência | Atributos vinculados a lookups rejeitam códigos desconhecidos |
| 2 | Entidades | Relacionamentos precisam que as duas pontas existam |
| 3 | Relacionamentos |
2. Use a opção de carga inicial na primeira carga
Para a primeiríssima carga numa organização, a opção de carga inicial dispensa o histórico por linha, que não tem estado anterior a preservar. É substancialmente mais rápida.
Use-a uma vez. Em operação contínua ela descarta exatamente o histórico que você vai querer depois.
3. Submeta e acompanhe
Um trabalho em execução informa status e uma contagem de progresso ao vivo; falhas são listadas por linha.
O trabalho reporta uma situação, uma contagem de progresso e erros por linha.
O progresso é derivado de trabalho concluído em vez de estimado, então reflete a realidade — inclusive quando ele para.
4. Trate linhas que falharam
Sucesso parcial é normal e correto. Linhas válidas entram; falhas são registradas individualmente com o motivo.
Leia as falhas antes de reenviar. Um número grande de linhas falhando na mesma validação normalmente significa que a regra está errada, não os dados — e reenviar dados inalterados produz falhas idênticas.
Corrija e reenvie apenas as linhas que falharam.
5. Compare depois de carregar
Compare quando a carga estiver concluída, não durante.
O motor ajusta pesos usando o quão comum cada valor é nos seus dados. Durante uma carga essas frequências cobrem uma fração dos dados, então valores parecem mais raros do que são e concordâncias pontuam mais alto do que deveriam. Registros se consolidam com evidência que dados posteriores teriam enfraquecido.
Carregue, depois rode a manutenção para capturar frequências, depois compare.
6. Verifique
- O trabalho concluiu em vez de travar.
- A contagem de linhas que entraram bate com o esperado, menos as falhas registradas.
- Confira um registro: valores padronizados, lookups resolvendo, compostos estruturados.
A seguir
Última verificação no commit d3c2586b (2026-08-03)