Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
La característica de conversión de esquemas de Oracle a Azure PostgreSQL en la extensión de Visual Studio Code PostgreSQL le ayuda a convertir los objetos de esquema de base de datos de Oracle existentes en definiciones compatibles con PostgreSQL Azure. Puede usar Azure Database for PostgreSQL servidor flexible o Azure HorizonDB para la validación del esquema y la implementación del esquema convertido.
La herramienta lee los metadatos de Oracle, genera Azure lenguaje de definición de datos postgreSQL (DDL) y comprueba la sintaxis y la estructura en una base de datos de validación de esquemas. No migra filas de tabla ni valida el comportamiento equivalente de la aplicación. Revise la salida con informes de conversión y Explorador de objetos de conversión y, a continuación, use GitHub Copilot para obtener explicaciones y correcciones.
Para ejecutar la primera conversión, siga el tutorial de conversión de esquemas.
En el diagrama siguiente se muestra la detección de esquemas de Oracle, la conversión asistida por IA y las comprobaciones de compilación, seguidas de revisión e implementación en Azure Database for PostgreSQL servidor flexible o Azure HorizonDB.
Architecture
El flujo de trabajo usa los siguientes componentes:
| Component | Role |
|---|---|
| Origen de Oracle | Proporciona definiciones de esquema y metadatos. |
| extensión Visual Studio Code PostgreSQL | Administra el proyecto de conversión de esquemas, el flujo de trabajo de conversión y los artefactos locales. |
| Microsoft Foundry | Hospeda la implementación del modelo usada para la conversión automatizada. |
| Base de datos de validación de esquemas | Proporciona compilación y comprobaciones estáticas disponibles en cualquiera de los dos servicios de Azure admitidos. |
| GitHub Copilot | Ayuda con explicaciones y correcciones de objetos a través de Ask y Fix. |
- Implementación y pruebas: Elija el destino de la implementación en Azure Database for PostgreSQL servidor flexible o Azure HorizonDB. Decide dónde probar el esquema convertido.
- Configuración de ia: Configure la implementación y autenticación del modelo Microsoft Foundry para la conversión automatizada. Inicie sesión en GitHub Copilot por separado para usar Ask and Fix.
Para obtener información sobre cómo estos servicios tratan las definiciones de esquemas y el código, consulte las preguntas frecuentes sobre el tratamiento de datos.
Instalación de la extensión
La conversión de esquemas está integrada en la extensión PostgreSQL publicada por Microsoft (ms-ossdata.vscode-pgsql). Siga los requisitos previos del tutorial y los pasos de instalación, incluido el inicio de sesión en Copilot para el flujo de trabajo de revisión asistida.
Flujo de trabajo de conversión de esquema
El flujo de trabajo comienza con el descubrimiento, seguido de la extracción y conversión. La herramienta valida las definiciones de Azure PostgreSQL generadas en una base de datos de validación de esquemas, y usted revisa los resultados en Conversion Explorador de objetos antes de preparar los archivos de implementación.
Discovery
La detección sigue a la conexión de Oracle y a la selección de esquema antes de configurar la base de datos de validación de esquemas. Comprueba los permisos de origen y hace un inventario de los objetos del esquema sin extraer DDL. Los recuentos describen el inventario de origen y la extracción planeada, no los resultados de la conversión.
| Result | Lo que te dice |
|---|---|
| Detectado | Objetos encontrados durante la detección. |
| Para extraerse | Objetos previstos para la extracción de DDL. |
| Excluidos | Objetos omitidos del ámbito de extracción planeado. |
| Objetos no válidos | Objetos marcados como no válidos por el descubrimiento. |
Revise la compatibilidad y exclusiones del tipo de objeto, junto con las dependencias de esquema, antes de confirmar el ámbito. Los esquemas dependientes enumeran los esquemas que no has seleccionado. El hecho de que un esquema aparezca en esta lista no confirma que esté incluido en el ámbito de la conversión.
Para ver los pasos detallados, consulte Revisar los resultados de Discovery en el tutorial.
Extracción
La extracción lee el DDL de Oracle y los metadatos del ámbito fuente revisado. Las definiciones extraídas sirven de entrada para la conversión; la extracción correcta no significa que se haya convertido un objeto.
Conversion
Los agentes de conversión de esquemas usan modelos en Microsoft Foundry para traducir las definiciones de Oracle extraídas a DDL de PostgreSQL e intentar la compilación en la base de datos de validación de esquemas. Revise tanto los objetos convertidos como los no convertidos en el Explorador de objetos de conversión y valide de forma independiente su comportamiento antes de la implementación.
Base de datos de validación de esquemas
Seleccione una base de datos vacía o una base de datos dedicada sin usar en Azure Database for PostgreSQL servidor flexible o Azure HorizonDB para la validación de conversión. Alinee la versión principal de PostgreSQL de la base de datos de validación de esquemas y las extensiones necesarias con el destino de la implementación. La herramienta usa esquemas correspondientes a los esquemas de Oracle que seleccione; no usa un prefijo independiente para los esquemas de validación.
Warning
La herramienta quita los schemas coincidentes con DROP SCHEMA ... CASCADE y los vuelve a crear. Esta acción elimina sus objetos y datos existentes y puede quitar objetos dependientes en otros esquemas. No seleccione una base de datos que contenga nada que necesite conservar.
El usuario de conexión necesita permiso para conectarse, crear esquemas y objetos de validación y quitar los esquemas coincidentes. El nivel CREATE de base de datos no concede permiso para eliminar un esquema propiedad de otro rol. Consulte Privilegios de PostgreSQL necesarios.
Las comprobaciones estáticas y de compilación pueden identificar errores de sintaxis, dependencia y tipo en este entorno. No prueban los datos de producción, el comportamiento de la aplicación ni todas las rutas de acceso en tiempo de ejecución.
Explorador de objetos de conversión
Utiliza el Explorador de objetos de conversión para examinar las correspondencias entre el origen y el destino, comparar las definiciones de Oracle y PostgreSQL, y leer las notas de conversión. Seleccione Solicitar una explicación o Corregir para aplicar correcciones asistidas por Copilot al objeto y sus objetos dependientes. Después de la compilación correcta, los objetos dependientes corregidos se resuelven automáticamente.
Seleccione Resolver para cambiar el estado registrado de un objeto a Convertido y, a continuación, seleccione Actualizar para actualizar los informes de conversión. Un cambio de estado no reemplaza la compilación ni las pruebas independientes de la aplicación. Para las ediciones manuales, compile las definiciones corregidas en la base de datos seleccionada y revise los resultados de la ejecución.
Para obtener pasos detallados, consulte Revisar objetos convertidos en Conversion Explorador de objetos.
Modo de agente de Copilot de GitHub
Ask y Fix proporcionan contexto de objeto para GitHub Copilot. Revise las modificaciones propuestas y los resultados de compilación antes de aceptar una corrección. La ayuda de Copilot no cambia qué objetos admite automáticamente el convertidor ni recupera código fuente no disponible. Consulte Solucionar problemas de conversión con GitHub Copilot.
Deployment
La Setup Experience genera instrucciones y scripts que usan los archivos de objeto en postgres_ddl. Revise el alcance del despliegue y las correcciones y, a continuación, ejecute la configuración en el destino elegido. La generación de archivos no las implementa. Revise los resultados de la implementación y pruebe de forma independiente los datos y el comportamiento de la aplicación.
Modos de conectividad de Oracle
Thin mode no necesita bibliotecas cliente de Oracle; Thick mode las usa. La extensión selecciona el modo en función del cliente que detecta. Prepare la máquina que ejecuta Visual Studio Code para los requisitos de la conexión de Oracle, incluido el cifrado de red nativo o la suma de comprobación. Consulte Configuración del cliente de Oracle en el tutorial.
Autenticación para Microsoft Foundry
Use una clave de API de recursos o Microsoft Entra ID con permiso para invocar el modelo. Una clave de API pertenece al recurso Foundry, no a una implementación individual. El nombre de implementación identifica la implementación del modelo dentro de ese recurso. Siga los requisitos previos de autenticación de Foundry y los pasos de configuración del asistente.
Seguridad y redes
Al usar la característica de conversión de esquemas, asegúrese de que el entorno de Visual Studio Code puede conectarse de forma segura a la base de datos de Oracle de origen y al servidor flexible Azure Database for PostgreSQL o Azure clúster de HorizonDB que hospeda la base de datos de validación de esquemas.
Microsoft recomienda conectarse al recurso de Microsoft Foundry mediante un punto de conexión privado. Para obtener más información, consulte Configurar un vínculo privado para Microsoft Foundry.
Para el control de datos del modelo, consulte Datos, privacidad y seguridad para Foundry Models.
Importante
La salida de la conversión de Foundry y Sugerencias de Copilot requieren revisión independiente. La compilación y la revisión asistida por IA no establecen una lógica de negocios equivalente ni una preparación para producción. Pruebe el manejo de datos de prueba, las dependencias, los controles de seguridad y el comportamiento de la aplicación antes de su uso en producción.
Objetos de esquema admitidos
La herramienta convierte objetos de código y esquema de Oracle comunes. La compatibilidad con un tipo de objeto no significa que cada definición de origen se convierta completamente. Compruebe las limitaciones y los resultados de sus propios objetos de origen.
Un estado convertido registra un resultado; no certifica la compilación, la implementación completa ni la inclusión en el despliegue. Inspeccione las definiciones y notas, incluidos los marcadores de posición y las dependencias.
Objetos de esquema de base de datos
Los tipos de objeto admitidos incluyen tablas, restricciones, índices únicos y árbol B, secuencias, desencadenadores de nivel de fila y nivel de instrucción, vistas, vistas, vistas, vistas materializadas, esquemas y sinónimos públicos y privados. El comportamiento de sinónimos, actualización y almacenamiento específico de Oracle puede requerir un trabajo manual.
Objetos de código de Oracle
Las construcciones de código admitidas incluyen paquetes, funciones, procedimientos, lógica de desencadenador, tipos de objeto y cuerpos de tipo, y colecciones como VARRAY, tablas anidadas y SUBTYPE declaraciones. Revise las implementaciones de miembro y los autores de llamadas, no solo el estado del objeto primario.
Conversión de paquetes
Los miembros del paquete se pueden asignar a varias definiciones de PostgreSQL. Revise los asistentes de estado generados, las constantes, las colecciones, los cursores y el control de excepciones. Los paquetes de solo especificación pueden generar marcadores de posición. Consulte la guía de validación de objetos complejos y la revisión del paquete en Conversion Explorador de objetos.
Consultas jerárquicas
Revise las consultas generadas WITH RECURSIVE con los resultados de Oracle, incluidas las raíces, la ordenación, las rutas de acceso y los ciclos. La compilación por sí sola no valida esos resultados.
Control de transacciones
Las rutinas que usan PRAGMA AUTONOMOUS_TRANSACTION pueden depender de dblink y de los cambios en quienes las llaman. Valide de forma independiente las conexiones, los límites de transacción y el control de errores; consulte la guía de validación de objetos complejos.
Validar PL/pgSQL convertido con plpgsql_check
La creación de una rutina PL/pgSQL no valida todas las rutas de ejecución. Cuando se admite y configura, plpgsql_check agrega comprobaciones estáticas de cuerpos rutinarios en la base de datos de validación de esquemas. Sin ella, esas comprobaciones adicionales no están disponibles. Ni la compilación ni un estado convertido demuestran que se ejecutaron o que el comportamiento coincide con Oracle. Para conocer los pasos de disponibilidad, precarga e instalación, consulte Permitir e instalar extensiones necesarias.
Versiones de Oracle admitidas
La conversión de esquema admite las siguientes versiones de base de datos de Oracle. Para conocer el entorno de conversión y los requisitos de PostgreSQL, consulte los requisitos previos del tutorial.
- Oracle 21c
- Oracle 19c
- Oracle 18c
- Oracle 12.2
- Oracle 12.1
Compatibilidad con la extensión PostgreSQL
Para notificar un error o solicitar una característica, abra un problema en el repositorio vscode-pgsql GitHub. Antepón Schema Conversion: al título de la incidencia. En el caso de fallos, incluya la versión de la extensión, la fase en la que falló y los mensajes de error pertinentes con los datos sensibles ocultos. Elimine las credenciales, los secretos y los detalles confidenciales del esquema antes de compartirlos.
Contenido relacionado
- Tutorial: Conversión de esquemas de Oracle a Azure PostgreSQL
- Procedimientos recomendados para la conversión de esquemas de Oracle a Azure PostgreSQL
- Revise los objetos convertidos en el Explorador de objetos de conversión
- Ver el informe de conversión HTML
- Implemente los esquemas convertidos con la experiencia de instalación
- Limitaciones de conversión de esquemas de Oracle a Azure PostgreSQL
- Preguntas frecuentes sobre la conversión de esquemas