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.
Después de ejecutar la conversión de esquemas de Oracle a Azure PostgreSQL en la extensión de PostgreSQL para Visual Studio Code, use el informe HTML para revisar los resultados registrados. El informe se aplica a las conversiones que utilizan Azure Database for PostgreSQL Flexible Server o Azure HorizonDB. Reúne los resultados de detección, extracción, conversión, detalles del entorno y vínculos a informes de nivel de objeto para una sesión de conversión.
Úselo para confirmar el alcance, investigar los objetos que requieren atención y compartir los resultados con su equipo de proyecto. Para el flujo de trabajo de conversión, consulte Tutorial: Convertir esquemas de Oracle a Azure PostgreSQL.
Abra el informe
El informe HTML se abre automáticamente cuando se completa la conversión de esquema. También puede abrirlo de cualquiera de las siguientes maneras:
- En la página Resumen de conversión , seleccione Informe de conversión.
- En el Explorador del área de trabajo, abra
.github\postgres-migrations\<migration-project>y localiceconvert\sessions\<session-id>\reports\report.htmlde la ejecución prevista. Busque dentro de ese proyecto si es necesario, en lugar de abrir un informe de nombre similar de otro proyecto.
Compruebe el identificador de sesión en el encabezado Conversión del informe para confirmar que está revisando la ejecución prevista. Comience con Resumen general y seleccione los vínculos de resumen o expanda los encabezados de sección para ver más detalles.
Actualizar los informes después de corregir objetos
Después de corregir objetos en Conversion Explorador de objetos, actualice los informes antes de revisar o compartir los resultados:
- Revise las definiciones corregidas y los resultados de compilación. Fix también puede corregir los objetos dependientes y resolverlos automáticamente después de una compilación correcta.
- Para un objeto que necesita una actualización manual del estado, seleccione Resolver en el Explorador de objetos de conversión para marcarlo como Convertido.
- Seleccione Actualizar en Conversion Explorador de objetos para actualizar los informes de conversión con los estados actualizados.
- Vuelva a abrir el informe y revise los resultados actualizados.
La actualización de informes no vuelve a ejecutar la conversión del esquema ni reemplaza los datos independientes y la validación de aplicaciones.
Leer el resumen general
El resumen separa los resultados de cada fase:
| Summary | Qué revisar |
|---|---|
| Descubrimiento | Objetos detectados en el origen, incluidos los recuentos de Para extraer, Excluidos y No válidos. |
| Extracción | Definiciones recuperadas de la fuente, junto con los recuentos de Fallidos y Excluidos. Una definición extraída no es un objeto convertido. |
| Conversión | Recuentos de conversiones y de no conversiones de la sesión de conversión. |
| Tasa de conversión (%) | Objetos convertidos divididos por el total de conversión, expresados como un porcentaje. |
El descubrimiento, la extracción y la conversión no cuentan necesariamente los mismos objetos. Por ejemplo, la conversión puede incluir objetos de esquema generados. Use el total de conversión que se muestra en el informe, no el total de detección o extracción, al interpretar la tasa de conversión. Expande Glosario para ver las reglas de recuento y las definiciones utilizadas por el informe.
En el ejemplo siguiente se muestra el informe antes de las correcciones de objetos.
En Conversión a nivel de esquema, revise los recuentos y la tasa de conversión de cada esquema. La columna Rol distingue:
- Seleccionado: un esquema de origen que eligió para la conversión.
- Incluido: un esquema adicional representado en el inventario de conversión.
Estas etiquetas describen el ámbito del informe. No significan que todos los esquemas a los que hace referencia tu fuente se seleccionaron, extrajeron o implementaron automáticamente. Compárelos con Esquemas dependientes en Detección y revise los resultados a nivel de objeto. Utilice Buscar esquemas para encontrar un esquema, o seleccione su nombre para abrir los resultados de tipos de objeto.
Ejemplo: Leer una tasa de conversión modificada
Supongamos que el resumen de conversión muestra 20 objetos totales: 18 Convertidos y dos No convertidos. La tasa de conversión es de 90%. Corrija uno de esos dos objetos, confirme la compilación, actualice su estado si es necesario y seleccione Actualizar. Si el total sigue siendo 20 y no se produce ningún otro cambio de estado, 19 objetos convertidos generan una tasa del 95 %.
Use los totales reales del informe, incluidos los objetos dependientes resueltos por Fix. El porcentaje revisado registra los cambios de estado de conversión; no mide la equivalencia en tiempo de ejecución ni el número de objetos implementados. Para conocer los pasos de corrección, consulte el ejemplo de Explorador de objetos de conversión.
Buscar objetos que necesitan atención
Comience con los 5 tipos de objetos para revisar para ver las cinco tasas de conversión más bajas entre los tipos con objetos no convertidos. Esta lista no clasifica la criticidad empresarial. Seleccione un tipo de objeto para investigarlo, o seleccione Ver más para abrir la sección completa Conversión de tipos de objeto.
En el informe principal, investigue los resultados de la conversión:
- Despliega Conversión y, a continuación, despliega Conversión de tipos de objeto.
- Para filtrar la tabla, selecciona Todos los tipos de objeto, elige uno o varios tipos y selecciona Hecho. En la tabla se muestra un total filtrado para los tipos seleccionados. Para restablecer todos los tipos, vuelve a abrir el control, selecciona Borrar filtro y, a continuación, selecciona Hecho.
- Seleccione un nombre de tipo de objeto para abrir su informe de nivel de objeto.
- Usa Nombre de esquema para restringir los resultados por esquema, cuando ese filtro esté disponible. Utiliza Buscar nombre para encontrar un nombre de origen de Oracle o un nombre de destino de PostgreSQL.
- Seleccione un encabezado de columna ordenable, como Nombre de origen o Estado, para ordenar las filas. Selecciónelo de nuevo para invertir el orden.
- Revise la columna Estado , que muestra Convertido o No convertido. Seleccione Notas, cuando esté disponible, para leer las notas de conversión grabadas del objeto.
El panel de notas identifica el objeto y proporciona la explicación grabada, como un cambio de conversión, un error de validación o una diferencia que requiere revisión. Revisa las notas sobre los objetos convertidos, así como sobre los que no se han convertido.
Important
Un resultado convertido no establece por sí mismo el éxito de la compilación, una implementación completa, la inclusión en el despliegue o un comportamiento de tiempo de ejecución equivalente. La compilación comprueba la sintaxis y la estructura, no los datos ni el comportamiento de la aplicación. Realice pruebas de tiempo de ejecución independientes antes de su uso en producción.
Revise los miembros del paquete
Vuelva al informe principal y expanda Conversión y Conversión de paquetes para revisar los resultados de nivel de paquete y de nivel de miembro. Utilice Nombre del esquema y Filtrar paquetes para buscar un paquete. En la tabla se muestran el estado del paquete, el recuento de miembros, los recuentos de miembros convertidos y no convertidos y la tasa de conversión de miembros.
Seleccione el nombre de un paquete para abrir su informe de miembros. Revise Nombre de origen, Tipo de origen, Nombre de destino, Tipo de destino, Cambio, Estado y Notas para comprender cómo se asignan los miembros individuales a PostgreSQL.
Un paquete puede estar No convertido incluso cuando algunos de sus miembros están Convertidos. Los recuentos de paquetes, los recuentos de cuerpos de paquete y los recuentos de miembros describen diferentes poblaciones. No agregue totales de miembros a los totales de tipo de objeto. Una tasa de n/a significa que no hay objetos ni miembros para ese cálculo, no una tasa de conversión de 0%.
Investigar descubrimiento y extracción
Si falta un objeto esperado en los resultados de la conversión, vuelva al informe principal y revise las fases anteriores:
- Despliegue Detección. Revise Tipos de objeto admitidos y Tipos de objeto no admitidos y seleccione un nombre de tipo de objeto para abrir sus detalles de detección.
- Revise los grupos aplicables Por extraer, Excluidos y No válidos. Utilice los filtros de esquema y de texto para buscar un objeto y leer el motivo de su exclusión o invalidez, si se proporciona.
- Revise los permisos de origen y los esquemas dependientes para el acceso registrado al origen y las dependencias de esquema. Los recuentos de referencia de dependencia no son recuentos de objetos.
- Despliega Extracción para revisar los recuentos de Extraídos, Fallidos, Excluidos e No válidos. Despliega Objetos extraídos por tipo para revisar las definiciones recuperadas de Oracle por tipo de objeto.
Se omitió un objeto Excluido de la extracción; ese estado no establece que existe un reemplazo en PostgreSQL. Un recuento Fallido de extracción representa las definiciones que no se pudieron recuperar, no el recuento no convertido de la fase de conversión.
Revisar el entorno y la información auxiliar
Usa las secciones restantes para comprender el contexto de la ejecución y planificar el trabajo de seguimiento:
| Section | Qué revisar |
|---|---|
| Medio ambiente | Detalles de origen, Destino (la base de datos de validación de esquema usada para esta ejecución, no una prueba de un destino de implementación posterior), extensiones usadas por la conversión de esquema y la configuración de LLM . |
| Siguientes pasos - Configuración | Instrucciones sobre la conectividad de destino, los permisos, los esquemas y los requisitos previos de extensión antes de la instalación. |
| Referencias | Vínculos a documentación pública, CSV de asignación de objetos y ubicación del informe. |
| Glosario | Definiciones de estados, tasas de conversión, recuentos de paquetes y miembros, y otros términos de informe. |
En Referencias, abra object_mapping_summary.csv para los nombres y tipos de objeto de origen y de destino, los estados registrados y las acciones necesarias. Las entradas de mapeo pueden diferir de los totales de objetos del informe, por lo que no utilices el recuento de filas del CSV como denominador de la tasa de conversión.
Utiliza Próximos pasos: configuración como guía de preparación. El propio informe no es un script de implementación.
Comparte el informe
Mantenga el directorio del informe unido para que los vínculos relativos a los informes de nivel de objeto sigan funcionando. Revise y compártalo solo a través de una ubicación aprobada.
El directorio del informe puede contener nombres de base de datos y esquemas, nombres de objeto, detalles del entorno y notas de conversión. Revise el contenido antes de compartirlo, siga los requisitos de control de datos de su organización y quite las credenciales o secretos de cualquier cosa que comparta.