Tutorial: Conversión de aplicaciones de Oracle a Azure Database for PostgreSQL (servidor flexible) (versión preliminar)

Este tutorial le guía a través de la conversión del código de aplicación cliente de Oracle a Azure Database for PostgreSQL mediante la extensión de Visual Studio Code para PostgreSQL con el modo de agente de GitHub Copilot para automatizar y validar la transformación de código.

Abarca la configuración del entorno, la importación del código base de la aplicación, la ejecución del proceso de conversión y la revisión del código compatible con PostgreSQL generado. Antes de comenzar, asegúrese de que ha completado un proyecto de conversión de esquema para obtener resultados óptimos.

Esto es lo que puede esperar durante la conversión:

Configuración del entorno: Configuración del modo de agente de GitHub Copilot con el modelo de IA adecuado
Importación de código base: organización del código de la aplicación en la estructura del proyecto de migración
Procesamiento de IA: GitHub Copilot procesa y convierte el código de aplicación mediante el contexto de base de datos
Ejecución de tareas TODO: generación automatizada de listas de tareas y conversión sistemática
Generación de informes: informe de conversión completo con resultados y recomendaciones
Comparación de archivos: herramientas de diferencias integradas para revisar el código original frente al convertido

Prerequisites

En esta sección se describen los requisitos previos para usar la funcionalidad de conversión de aplicaciones de Oracle a Azure Database for PostgreSQL en Visual Studio Code antes de iniciar una conversión.

Requisitos del sistema

Requirement	Especificación
versión de Visual Studio Code	1.95.2 o superior
suscripción de GitHub Copilot	Pro+, Business, Enterprise

Compatibilidad con sistema operativo

Plataforma	Architecture
Windows	x64 y ARM64
Linux	x64 y ARM64
macOS	x64 (Intel) y ARM64 (Apple Silicon)

Requisitos del modelo de IA

Necesita uno de los siguientes modelos de IA configurados en modo de agente de GitHub Copilot:

Modelo	Versión
Claude	Sonnet 4.6 o Opus 4.6 o superior

Antes de iniciar la conversión de la aplicación, establezca el modelo del modo de agente de GitHub Copilot en Claude Sonnet 4.6 o Claude Opus 4.6 o superior para obtener resultados óptimos de transformación de código.

Compatibilidad de versiones de PostgreSQL

Base de datos de destino	Versión
Servidor flexible de base de datos de Azure para PostgreSQL	PostgreSQL versión 15 o posterior
Azure HorizonDB	PostgreSQL versión 17 o posterior

Recomendación de conversión de esquema

Aunque no es necesario realizar una conversión de esquema de base de datos de antemano, primero se recomienda completar una migración de esquema. Si ya ha convertido el esquema de Oracle en PostgreSQL, el proceso de conversión de aplicaciones proporciona resultados de transformación de código de mayor calidad y contexto más precisos a través de:

Notas de codificación: artefactos de metadatos generados durante la conversión del esquema (consulte ¿Qué son las notas de codificación ? a continuación)
Contexto de base de datos: acceso directo a objetos de esquema convertidos
Asignaciones de tipos de datos: entendimiento preciso de las transformaciones de tipo

Otros requisitos previos

Conexión de base de datos a tu instancia de Azure Database for PostgreSQL
Acceso al mercado de extensiones de Visual Studio Code y a los servicios de GitHub Copilot

¿Qué son las notas de codificación?

Las notas de codificación son artefactos de metadatos generados automáticamente durante la fase de conversión del esquema. Capturan detalles de transformación clave e información de la conversión de esquema de Oracle a PostgreSQL que el proceso usa más adelante para mejorar la conversión de código de la aplicación.

Las notas de codificación pueden incluir información como:

Asignaciones de tipos de datos y cambios estructurales
Detalles de conversión de secuencias, identidades y tipos compuestos
Ajustes en implementaciones de fecha y hora o intervalo
Referencias a tablas con restricciones de integridad referencial
Resúmenes de paquetes complejos de Oracle, incluidas las firmas de procedimientos y funciones
Sugerencias adicionales generadas por ia para mejorar la precisión de la traducción de código

Durante la conversión de aplicaciones, el modelo de IA usa estas notas como señales contextuales para generar código compatible con PostgreSQL más preciso y semántico.

Proceso de conversión de aplicaciones

En esta sección se explica el flujo de trabajo de conversión de aplicaciones completo: configurar el entorno, importar el código base, ejecutar la conversión, revisar el informe generado y comparar los cambios de archivo.

Paso 1: Configurar el entorno

Abra Visual Studio Code con la extensión PostgreSQL instalada.
Abra la interfaz de chat GitHub Copilot.
Seleccione Claude Sonnet 4.6 o Claude Opus 4.6 para el modelo.

El uso de Claude Sonnet 4.6 o Claude Opus 4.6 es necesario para obtener resultados óptimos de conversión de aplicaciones. Los modelos inferiores pueden producir conversiones menos precisas.

Paso 2: Abrir el proyecto de migración

Abra el área de trabajo que contiene el proyecto de conversión de esquema.
Vaya a la estructura de carpetas del proyecto de migración:
```
.github/postgres-migration/project_name/
```
Compruebe que la estructura del proyecto incluye las carpetas y archivos necesarios de la conversión del esquema.

Paso 3: Copiar el código base en el proyecto de migración

Localice la carpeta application_code en su proyecto.

.github/postgres-migration/project_name/application_code/

Copie la carpeta codebase que desea migrar a la carpeta dentro de la application_code carpeta del proyecto.
Organice los archivos lógicamente para facilitar la conversión sistemática.

Mantenga el código de aplicación original en una ubicación independiente como copia de seguridad. Copie solo los archivos que desea convertir en la estructura del proyecto de migración.

Paso 4: Iniciar la migración de código de cliente

En el panel Migración de extensiones de PostgreSQL, seleccione Migrar aplicación para iniciar el Asistente para la conversión de aplicaciones.
En el formulario que se carga, seleccione la carpeta que copió en el directorio raíz de su área de trabajo.
Elija la base de datos que tiene el contexto de la aplicación:
- La base de datos PostgreSQL donde desplegó el DDL convertido o
- La base de datos PostgreSQL donde ya existe el esquema de la aplicación
Seleccione Convertir aplicación.

Esta acción inicia los siguientes procesos:

Invoca una solicitud compuesta personalizada y una herramienta de modo agente
Genera una lista TODO de tareas en las que el Modo Agente procede a trabajar.
Se conecta a y lee la base de datos para mejorar el contexto
Convierte sistemáticamente los archivos de código de la aplicación

Paso 5: Supervisar el progreso de la conversión

Observa la interfaz GitHub Copilot Agent Mode mientras procesa archivos.
El agente trabaja sistemáticamente con la lista de tareas por hacer generada.
Revisar las preguntas o mensajes del agente que puedan requerir una respuesta.
Permita que el proceso de conversión se complete completamente antes de revisar los resultados.

Paso 6: Conversión de Java mejorada con la extensión de modernización de aplicaciones GitHub Copilot (opcional)

Si trabajar con código Java: puede mejorar el proceso de conversión instalando la extensión de modernización de aplicaciones GitHub Copilot antes de iniciar la conversión.

Compilación de pruebas automáticas

Las dos extensiones de VS Code se comunican entre sí para proporcionar una integración sin problemas. Al convertir Java código, la extensión de modernización de aplicaciones realiza automáticamente una compilación de prueba del código convertido para identificar los errores de sintaxis o los problemas de compilación al principio del proceso.

Generación automática de pruebas unitarias

En función del código base convertido, la extensión de modernización de aplicaciones genera automáticamente pruebas unitarias para ayudar a validar que la aplicación convertida se comporta correctamente. Esta integración aprovecha las funcionalidades de la extensión de modernización de aplicaciones para:

Análisis de las clases y métodos de Java convertidos
Generación de casos de prueba adecuados para rutas de acceso de código críticas
Creación de accesorios de prueba que funcionan con las conexiones de base de datos postgreSQL

La instalación de la extensión de modernización de aplicaciones GitHub Copilot es muy recomendable para Java proyectos de migración, ya que acelera significativamente la validación y mejora la calidad de la conversión a través de comprobaciones automatizadas de compilación y generación de pruebas.

Paso 7: Revisión del informe de conversión de código

Cuando la conversión de la aplicación finaliza en modo agente, genera y abre automáticamente un informe completo.
El informe proporciona resultados detallados y los pasos siguientes recomendados para la conversión.

Para obtener instrucciones de informe completas: consulte los informes generados de la conversión de aplicaciones de Oracle Database a Azure Database for PostgreSQL (Versión preliminar) para obtener información detallada sobre cómo interpretar los resultados de la conversión, comprender los estados de los archivos y planear la estrategia de validación.

Paso 8: Comparar los cambios de código mediante la característica de diferencias de archivos

Haga clic con el botón derecho en un archivo convertido (por ejemplo, un .java archivo) y seleccione Comparar pares de archivos de migración de aplicaciones.
Se abre una vista en paralelo de los archivos originales y convertidos.
Úselo para validar las transformaciones críticas antes de las pruebas.

Estrategia de comparación de archivos efectivos: consulte los informes generados por la conversión de aplicaciones de Oracle a Azure Database para PostgreSQL (versión preliminar) para obtener instrucciones sobre cómo priorizar qué archivos revisar primero y cómo centrar sus esfuerzos de validación.

Paso 9: Validación del código de aplicación convertido

Pasos de validación esenciales:

Configuración de un entorno de prueba que no es de producción con el esquema de PostgreSQL convertido
Prueba de la conectividad de la base de datos con las nuevas cadenas de conexión de PostgreSQL
Ejecución de flujos de trabajo empresariales críticos para comprobar el comportamiento de la aplicación
Validar los resultados de la consulta SQL con los resultados esperados de Oracle
Aborde las áreas marcadas identificadas en el informe de conversión

Importante

En ocasiones, los sistemas de inteligencia artificial pueden cometer errores. Para evitar regresiones funcionales, problemas de seguridad o problemas de acceso a datos, valide de forma independiente todo el código de aplicación convertido antes de implementarlo en producción.

Enfoque sistemático de validación: use los marcos de validación en las mejores prácticas para convertir el código de aplicación de Oracle a Azure Database for PostgreSQL (Versión preliminar) para priorizar las pruebas según la complejidad de su integración con Oracle y los resultados del informe de conversión.

Pasos posteriores a la conversión

Después de completar la conversión de la aplicación:

Ejecutar pruebas unitarias: ejecute el conjunto de pruebas de la aplicación en el código convertido.
Pruebas de integración: pruebe la aplicación con la base de datos postgreSQL.
Pruebas de rendimiento: valide que el rendimiento de las consultas cumpla los requisitos.
Revisión de código: haga que los miembros del equipo revisen el código convertido para obtener precisión.
Actualización de documentación: actualice cualquier documentación que haga referencia a características específicas de Oracle.

Estrategias de validación integrales: Consulte Mejores prácticas para convertir código de aplicaciones Oracle a Azure Database para PostgreSQL (Vista previa) para obtener información detallada sobre marcos de validación, prioridades de las pruebas, y enfoques de coordinación del equipo según la complejidad de su conversión.

Para obtener más información sobre la extensión de Visual Studio Code, visite extensión postgreSQL para Visual Studio Code

Comentarios

¿Le ha resultado útil esta página?

Se actualizó por última vez el 2026-06-08