Defina o propósito da fonte
Determine a fonte exata, proprietário, classificação de dados e fluxo de trabalho de negócios pretendido. Um conector genérico não é permitido para escanear tabelas arbitrárias ou pontos finais.
Comece com um uso concreto: qual pergunta de negócio precisa de quais campos de qual fonte? Registre o responsável, o destino aprovado, a classificação dos dados e as premissas de retenção. Escolha o menor escopo de fonte que sustente a pergunta. Credenciais são um mecanismo de acesso, não uma permissão para ampliar a coleta além dessa finalidade.
- Escolha um adaptador e destino explícito suportados.
- Use os campos mínimos permitidos e o alcance de linha.
- Mantenha as credenciais fonte no plano de dados do cliente.
Revisão do limite de ingestão
Concorde a pseudonimização, endereços permitidos, mapeamentos de campos e prazos antes de habilitar a coleta. Registre o esquema de origem e as impressões digitais das visualizações para que o desvio se torne visível.
Revise a estrutura e o significado dos dados, além do transporte. Identifique o tempo de negócio, os identificadores de entidades, a ordenação e eventuais valores ausentes. Um lote sintaticamente válido ainda pode mapear a semântica de negócio errada. Mantenha as identidades de esquema e de mapeamento para que mudanças posteriores possam ser detectadas e revisadas.
Custódia junto à fonte e ingestão controlada
Comece pela visão, stream, endpoint ou diário exato aprovado.
- Preserve a identidade fonte e o tempo de negócios.
- Linhas, bytes, páginas e duração da solicitação vinculadas.
- Revisão de fontes mudam em vez de silenciosamente expandir a coleção.
Reparação de entrega interrompida
Uma conexão de fonte precisa de reconhecimento confiável e comportamento de recuperação. Teste a perda de reconhecimento, reinicializações e gerações de fonte alteradas contra o perfil do conector declarado.
Um conector pode entregar um lote com sucesso, mas perder a confirmação. A recuperação precisa distinguir esse caso de um lote que nunca chegou. Ensaie a interrupção usando o perfil compatível exato, guardando a identidade da entrada, o comprovante e o comportamento do checkpoint, em vez de supor que toda fonte tem a mesma semântica de reprocessamento.
O que uma fonte de sinistros revisada deve contribuir para um modelo?
Selecione os identificadores de caso, as transições de status e os timestamps de negócio permitidos a partir de uma visão de fonte aprovada. Registre os mapeamentos e as referências de entrada e, depois, teste um lote interrompido contra o contrato do perfil.
Revise se os registros admitidos sustentam o fluxo de trabalho pretendido. Uma leitura bem-sucedida não comprova cobertura completa dos sinistros nem integração nativa com a plataforma de sinistros.
- Verifique o comportamento do outbox e do checkpoint.
- Verifique a digestão de entrada reconhecida.
- Reserva de receita e fonte de origem de snapshot.
Escolha um perfil e, depois, qualifique a fonte
O catálogo de perfis de fonte implementados inclui diários de eventos, visões SQLite, visões PostgreSQL, PostgreSQL CDC, streams Redis, leituras REST delimitadas e leituras MCP organizacionais. Cada perfil tem seu próprio contrato de operação.
O PostgreSQL CDC é um perfil de laboratório isolado. Um adaptador genérico não estabelece compatibilidade nativa com um aplicativo de fornecedor, com a rede do cliente nem com a captura de mudanças em produção. Qualifique a fonte, as credenciais, o esquema e a implantação exatos antes de ampliar seu uso.
Revise o limite antes da coleta
| Limite | Pergunta a ser resolvida | Evidências a guardar |
|---|---|---|
| Escopo da fonte | Quais registros e campos exatos são permitidos? | Finalidade e mapeamento da fonte revisados. |
| Custódia de credenciais | Onde as credenciais ficam e quem faz a rotação delas? | Referências de responsável e custódia, sem segredos. |
| Entrega interrompida | Como este perfil reconhece um lote já admitido? | Identidade da entrada, comprovante e evidências de checkpoint. |
- Registre as versões do adaptador e da fonte.
- Mantenha as credenciais fora dos prompts e das respostas do modelo.
- Separe uma conexão de laboratório bem-sucedida da aceitação em produção.
Mantenha a linhagem durante as mudanças
Os dados se tornam evidências úteis quando um revisor consegue identificar de onde vieram e como entraram no modelo. Guarde referências de fonte, identidade do snapshot, mapeamentos revisados e os limites de coleta relevantes junto com o modelo.
Trate uma mudança de geração, esquema ou destino da fonte como um evento de revisão. Não reinterprete silenciosamente registros antigos com um novo mapeamento. Preserve as evidências anteriores para que uma discrepância posterior possa ser rastreada até a fonte, o mapeamento ou o modelo, em vez de adivinhada.
Mantenha as evidências e suas condições juntas. Um sucesso posterior não apaga uma falha anterior nem amplia o escopo original.
- Guarde as identidades da fonte e do mapeamento.
- Explique lacunas, duplicatas e premissas de ordenação.
- Revise mudanças na coleta com o responsável.
Prepare um resumo de integração da fonte
Reúna o responsável pela fonte e a equipe de plataforma em torno da menor conexão útil. Acorde os dados permitidos, a finalidade, o perfil, o comportamento em caso de falha e as evidências a guardar antes de conectar uma fonte sensível.
Use entradas sintéticas ou devidamente aprovadas para ensaiar o contrato. Mantenha a decisão de aceitação separada do checklist: selecionar um item aqui não registra um conector nem concede acesso a um sistema.
Preparação da revisão
0 / 6 preparados- Nomeie o responsável pela fonte e pelas credenciais.
- Defina os limites de coleta e recuperação.
- Registre o trabalho de qualificação do cliente que ainda falta.