Migração de Banco de Dados Oracle para PostgreSQL

Expõe riscos de migração e valida o trabalho de migração contra diferenças comportamentais conhecidas entre Oracle/PostgreSQL documentadas na pasta references/.

Quando usar

1. Planejamento — Antes de iniciar o trabalho de migração em um procedimento, gatilho, consulta ou cliente refcursor. Identifique quais insights de referência se aplicam para que os riscos sejam abordados antecipadamente.
2. Validação — Após a conclusão do trabalho de migração, confirme se todos os insights aplicáveis foram abordados e se os testes de integração cobrem as novas semânticas do PostgreSQL.

Fluxo de Trabalho

Determine o tipo de tarefa:

Planejando uma migração? Siga o fluxo de trabalho de avaliação de risco. Validando trabalho concluído? Siga o fluxo de trabalho de validação.

Fluxo de trabalho de avaliação de risco (planejamento)

Risk Assessment:
- [ ] Step 1: Identify the migration scope
- [ ] Step 2: Screen each insight for applicability
- [ ] Step 3: Document risks and recommended actions

Etapa 1: Identifique o escopo da migração

Liste os objetos de banco de dados afetados (procedimentos, gatilhos, consultas, views) e o código da aplicação que os chama.

Etapa 2: Verifique a aplicabilidade de cada insight

Revise o índice de referência em references/REFERENCE.md. Para cada entrada, determine se o escopo da migração contém padrões afetados por esse insight. Leia o arquivo de referência completo apenas quando o insight for potencialmente relevante.

Etapa 3: Documente riscos e ações recomendadas

Para cada insight aplicável, anote o risco específico e o padrão de correção recomendado do arquivo de referência. Sinalize qualquer insight que exija uma decisão de design (por exemplo, se preservar a semântica de string vazia como NULL do Oracle ou adotar o comportamento do PostgreSQL).

Fluxo de trabalho de validação (pós-migração)

Validation:
- [ ] Step 1: Map the migration artifact
- [ ] Step 2: Cross-check applicable insights
- [ ] Step 3: Verify integration test coverage
- [ ] Step 4: Gate the result

Etapa 1: Mapeie o artefato de migração

Identifique o objeto migrado e resuma o conjunto de alterações.

Etapa 2: Verifique os insights aplicáveis

Para cada referência em references/REFERENCE.md, confirme se o comportamento ou requisito de teste é reconhecido e abordado no trabalho de migração.

Etapa 3: Verifique a cobertura de testes de integração

Confirme se os testes exercitam tanto o caminho feliz quanto os cenários de falha destacados nos insights aplicáveis (exceções, ordenação, riscos de comportamento/desempenho UNION ALL, consumo de refcursor, transações concorrentes, timestamps, atualidade de materialized views, etc.).

Etapa 4: Gate o resultado

Retorne uma lista de verificação afirmando que cada insight aplicável foi abordado, os scripts de migração foram executados e os testes de integração foram aprovados.