Informes de conversión de esquemas de Oracle a Azure Database for PostgreSQL (servidor flexible)

La característica de conversión de esquemas de Oracle para Azure Database for PostgreSQL genera varios artefactos en dos fases: extraction y conversion. Estos artefactos le ayudan a validar el ámbito, comprender los resultados de la conversión y solucionar problemas. Cada fase genera informes estructurados, archivos CSV compatibles y archivos de registro en tiempo de ejecución. Revise primero los artefactos de extracción y, a continuación, revise los artefactos de conversión antes de promocionar el esquema convertido al destino de producción.

Artefactos de extracción

La fase de extracción se ejecuta primero, cuando la herramienta se conecta al origen de Oracle y detecta objetos de esquema. La herramienta genera los siguientes artefactos antes de que comience la conversión controlada por IA. Úselos para comprobar la conectividad, confirmar el ámbito e identificar los objetos que necesitan un planeamiento manual.

Informe de extracción de Oracle

El informe de extracción de Oracle resume lo que la herramienta detectó en el origen. Úselo para comprobar la conectividad y confirmar que se encontraron todos los objetos que espera migrar.

El informe incluye:

  • Detalles de conexión y versión de la instancia de Oracle.
  • Resumen del esquema con recuentos de objetos y tasa de éxito de extracción.
  • Desglose del tipo de objeto. Por ejemplo, tablas, índices, vistas, procedimientos, paquetes, funciones, desencadenadores y secuencias.
  • Tiempo de procesamiento y errores de extracción.

Captura de pantalla del informe de extracción de Oracle.

Objetos excluidos

El excluded_objects.csv archivo enumera los objetos de Oracle que la herramienta excluyó intencionadamente de la extracción. Por ejemplo, el código PL/SQL encapsulado, los disparadores de eventos del sistema, Java en la base de datos y otras categorías no se extraen por diseño. Cada fila identifica el esquema, el tipo de objeto, el nombre de objeto y el motivo de la exclusión.

Utilice este archivo para planificar la remediación manual o el cambio de plataforma de cualquier objeto que la herramienta haya omitido. Para obtener la lista completa de categorías que se omiten por diseño, consulte Limitaciones de la conversión de esquemas de Oracle a Azure Database for PostgreSQL.

Tipos no compatibles

El unsupported_types.csv archivo enumera los tipos de datos o construcciones de Oracle que encontró la herramienta, pero no admite la conversión automatizada. Cada fila identifica el esquema, el objeto y la columna o argumento donde se usó el tipo y el tipo de datos de origen.

Use este archivo para definir el ámbito de la corrección manual. Decida si quiere asignar cada aparición a un tipo nativo de PostgreSQL, refactorizar el objeto de origen o quitarlo del ámbito de migración.

Registro de extracción

Este registro captura eventos de ejecución detallados de la fase de extracción. Consulte el registro para solucionar errores de conectividad, privilegios que faltan, limitación o exclusiones inesperadas cuando el informe de extracción no explica completamente lo que ha ocurrido.

Fragmentación de artefactos

Una vez completada la extracción, la herramienta agrupa los objetos de Oracle extraídos en lotes compatibles con dependencias denominados fragmentos. La fragmentación mantiene cada llamada a Microsoft Foundry dentro del límite de tokens por minuto (TPM) de la implementación y preserva las dependencias de los objetos durante la conversión.

Informe de generación de fragmentos

El chunk_generation_report.md archivo describe cómo la herramienta agrupó los objetos extraídos en fragmentos. Úselo para comprender el tamaño del fragmento, la distribución de objetos y el orden de dependencias antes de que se ejecute la conversión, o para investigar por qué un objeto específico aterrizó en un fragmento específico.

El informe incluye:

  • Total de fragmentos generados y los objetos de cada fragmento.
  • Distribución de objetos por esquema y tipo de objeto.
  • Relaciones de dependencia que influyeron en la fragmentación.
  • Detalles de la planificación de los tokens por fragmento.

Artefactos de conversión

La fase de conversión se ejecuta después de la fase de fragmentación. Microsoft Foundry procesa un fragmento cada vez, por lo que permanece dentro del límite de token de implementación por minuto (TPM). La herramienta genera los siguientes artefactos durante y después de la fase de conversión. Úselos para validar los resultados de la conversión, resolver las tareas de revisión y planear la implementación.

Informe de conversión por bloque

Para cada fragmento, la herramienta genera un informe de conversión por fragmento. Este informe captura los objetos procesados en ese fragmento, el resultado de la conversión y las tareas de revisión generadas.

Use los informes por fragmento para investigar el comportamiento de un lote específico, correlacionar las tareas de revisión con el fragmento en el que se crearon o volver a ejecutar un único fragmento si ajusta la configuración de origen o de destino.

Informe de conversión técnica

Este informe técnico detallado de objetos por objeto abarca toda la ejecución de conversión. Captura las asignaciones de origen a destino, las transformaciones de tipo de datos y las transformaciones aplicadas por IA, las advertencias de conversión y la ubicación de los archivos PostgreSQL generados.

Utilice este informe al revisar el código generado por IA, al analizar una tarea de revisión específica o para generar un rastro de auditoría para una migración regulada.

Informe de resumen del cliente

El archivo customer_summary.md es el resumen del estado de preparación, pensado para directivos, que agrega los resultados de todos los fragmentos. Abra este informe primero después de que se complete la conversión. Úselo para validar los resultados generales de la conversión, planear la implementación y buscar las tareas manuales que necesitan su atención.

El informe incluye:

  • Estadísticas de conversión y tasa de éxito.
  • Mapeo objeto por objeto de Oracle a PostgreSQL.
  • Detalles de la transformación del tipo de datos.
  • Recuentos de tareas de revisión por importancia.
  • Instrucciones de implementación y referencias de archivo.
  • Recomendaciones de rendimiento y limitaciones conocidas.

Captura de pantalla del informe de resumen del cliente.

Revisión del informe de tareas

El archivo review_tasks.md refleja las tareas de revisión que se muestran en el panel Schema Review de la extensión Visual Studio Code PostgreSQL. Úselo para referencias sin conexión, seguimientos de auditoría o para compartir una instantánea de tareas pendientes y resueltas con las partes interesadas que no tienen instalada la extensión. Para evaluar y resolver tareas, use el panel Schema Review en Visual Studio Code. Para obtener más información, consulte Revisar tareas y carpetas de salida para la conversión de esquemas de Oracle a Azure Database for PostgreSQL.

Registro de conversión

Este registro captura eventos detallados en tiempo de ejecución de la fase de conversión. Consulte el registro para depurar la limitación de velocidad de Microsoft Foundry, los bloqueos del filtro de contenido, los errores de validación de la base de datos de trabajo o los errores en el nivel de fragmento que no se explican completamente en los informes por fragmento o en los informes de resumen.

Utiliza los informes

Revise los artefactos en el orden siguiente:

  1. Abra primero el informe de extracción de Oracle, excluded_objects.csvy .unsupported_types.csv Confirme que se detectaron todos los esquemas y tipos de objeto esperados y decida cómo controlar todos los objetos excluidos y el tipo no admitido antes de iniciar la conversión.
  2. Abra el informe de generación de fragmentos para confirmar que los objetos que espera se agruparon en fragmentos.
  3. Una vez finalizada la conversión, abra el informe de resumen del cliente para validar los resultados generales y busque los elementos que necesitan su atención.
  4. Clasifique y resuelva las tareas de revisión desde el panel Schema Review de la extensión de PostgreSQL para Visual Studio Code. Para obtener más información sobre la interfaz de usuario, los niveles de criticidad y el flujo de trabajo de resolución, consulte Revisar las tareas y las carpetas de salida para la conversión de esquemas de Oracle a Azure Database for PostgreSQL.
  5. Use los informes de conversión técnica y por fragmento para profundizar en objetos individuales, asignaciones o advertencias.
  6. Si se produce un error en la extracción o conversión, consulte el registro de extracción y el registro de conversión para diagnosticar la causa principal.

Contenido relacionado

  • Last updated on