Extensión Database Migration Assessment for Oracle

La extensión Database Migration Assessment for Oracle de Azure Data Studio le ayuda a valorar una carga de trabajo de Oracle para migrar a Azure SQL y a Azure Database for PostgreSQL. La extensión identifica un destino de Azure SQL o PostgreSQL adecuado con recomendaciones de ajuste de tamaño correcto y la complejidad de la migración.

Requisitos previos

• Azure Data Studio, versión 1.39 o posterior.
• Una base de datos de Oracle que ejecute la versión 11g o superior.
• Los usuarios de Oracle deben tener asignados privilegios CONNECT y SELECT ANY DICTIONARY.

Instalación de la extensión de Azure Data Studio

Siga estos pasos para instalar la extensión Database Migration Assessment for Oracle en Azure Data Studio.

1. Abra el administrador de extensiones en Azure Data Studio. Puede seleccionar el icono de extensiones o seleccionar Extensiones en el menú Vista.

2. Escriba Oracle en la barra de búsqueda.

3. Seleccione la extensión Database Migration Assessment for Oracle y vea sus detalles.

4. Seleccione Instalar.

   

Configurar los valores de la extensión

Puede configurar varias opciones de extensión después de instalarla.

1. Vaya a extensiones y seleccione Database Migration Assessment for Oracle, luego, el icono Administrar configuración y, después, la configuración de extensión.

   

2. En la configuración de extensión, edite los ajustes necesarios para cumplir los requisitos del entorno.

   

   Nota:

   Para realizar la valoración de código de Oracle a PostgreSQL, la ruta de acceso de inicio del cliente de Oracle y la ruta de instalación de Ora2Pg son parámetros obligatorios.

Ejecución de la valoración

Una vez instalada la extensión de valoración, el siguiente paso es conectar la base de datos a Oracle, recopilar información de metadatos de la instancia de Oracle y generar un informe de valoración.

1. Vaya al icono de conexiones en la barra de menús.

   

2. En Detalles de conexión, rellene los campos.

   1. En el campo Tipo de conexión, seleccione Oracle.
   2. En el campo Origen de datos, escriba la instancia y el nombre de servidor de Oracle.
      1. También puede proporcionar el nombre de TNS. (Asegúrese de que la variable de entorno ORACLE_HOME está establecida y de que el archivo TNSNAMES.ORA se encuentra en <ORACLE_HOME>/network/admin folder).
      2. En el caso de la base de datos de contenedor, puede conectar la base de datos raíz del contenedor mediante el identificador del servicio CDB o usar el nombre del servicio de base de datos conectable para conectarse a la base de datos conectable.
   3. Proporcione el nombre de usuario de la base de datos en el campo Id. de usuario.
   4. Proporcione la contraseña de la base de datos en el campo Contraseña.

   

3. Seleccione Conectar.

4. Ahora, aparece una nueva conexión en el menú de detalles de conexión.

5. Haga clic con el botón derecho en la conexión de Oracle y seleccione Administrar.

   

6. Seleccione Valoración de la migración.

   

7. Seleccione Ejecutar nueva valoración.

   

8. Proporcione los detalles de la valoración.

   1. En el campo Nombre de la valoración, escriba un título, por ejemplo, demo1.
   2. Escriba la configuración de la valoración.

      1. Escriba la base de datos de migración de destino en el campo Plataforma de destino. Actualmente, admite Azure SQL y PostgreSQL como destinos.

         Nota:

         El destino de PostgreSQL está en versión preliminar. Esta opción de destino se interrumpirá. Debe exportar las evaluaciones anteriores.

      2. En la sección Recopilación de datos de rendimiento, seleccione Run performance data collection on Oracle database (connected) [Ejecutar la recopilación de datos de rendimiento en la base de datos de Oracle (conectada)] o Add AWR report (Agregar un informe de AWR).

         Se recomienda usar la opción conectada si se ejecuta esta herramienta durante una carga máxima o realista. De lo contrario, proporcione los informes de AWR generados en el pasado para una recomendación de rendimiento y ajuste de tamaño.

         Nota:

         La opción de evaluación de informes de AWR no está habilitada para la base de datos conectable.

      3. Escriba el valor del multiplicador en el campo Scale factor (Factor de escala).

         • Si la SKU recomendada debe tener en cuenta otras cargas máximas, el multiplicador del factor de escala debe ser mayor que 1. Por ejemplo, carga de ráfaga, uso estacional y planeamiento de capacidad futuro. Cuando se migra una carga de trabajo parcial de esquema de Oracle, el multiplicador debe ser menor que 1.

      4. En el campo Uso de percentil, escriba el valor del percentil para cambiar el tamaño del destino de Azure.

         • El valor de percentil de la muestra de rendimiento establecido para determinar el tamaño del destino de Azure.

   

9. Hay dos tipos de evaluación:

   • Valoración de la carga de trabajo. En esta valoración, el módulo de valoración de Oracle realiza una detección superficial de los objetos de esquema y clasifica la complejidad del esquema para la migración en varias categorías una estimación de alto nivel para las horas de conversión. Esta evaluación previa ayuda a encontrar la viabilidad de la migración a la plataforma de destino.

   • Valoración del código. La valoración del código realiza una valoración profunda de los objetos de esquema de Oracle y, después, sugiere una preparación general de los objetos de código con tipos de objetos "Preparados", "Necesita revisión" y "No preparados" a nivel granular y sus horas de conversión asociadas con mayor precisión.

     Nota

     La extensión usa el convertidor de esquemas Ora2Pg de código abierto para la valoración de código.

     Si el cliente de Oracle o Ora2Pg no está instalado en la misma máquina que Azure Data Studio, instálelos manualmente o use el script de instalación de Ora2Pg desde GitHub.

     Si el cliente de Oracle y Ora2Pg están instalados, asegúrese de que la ruta de acceso de inicio del cliente de Oracle y la ruta de instalación de Ora2Pg estén actualizadas en la configuración de la extensión.

     • Al seleccionar Evaluación de código para escenarios de SQL, seleccione los esquemas a los que desea acceder para la conversión y migración de Oracle a SQL. De forma predeterminada, se seleccionan todos los esquemas aptos para la evaluación.

10. Elija Ejecutar validación para realizar los requisitos previos y varias reglas de validación relacionadas con los permisos de seguridad, las opciones de configuración, etc. Si se produce un error en la validación, debe corregir los errores para continuar.

11. Cuando la validación se realiza correctamente, puede seleccionar Ejecutar evaluación.

12. Ahora, verá la nueva valoración en la sección "Últimas cinco valoraciones".

    

13. Seleccione el vínculo de la valoración para ver la página de detalles de la valoración. Puede ver el estado de la valoración más reciente.

    

14. Seleccione Actualizar o espere hasta que finalice la valoración. De forma predeterminada, la página de estado de valoración se actualiza cada 15 segundos. El estado muestra uno de los cuatro estados: correcto, erróneo, en curso o cancelado.

Visualización de la valoración

Una vez completada la valoración, se genera una salida consolidada con tarjetas para cada destino de Azure SQL: SQL Server en Azure Virtual Machines, Azure SQL Database y Azure SQL Managed Instance o Azure Database for PostgreSQL: servidor flexible.

Cada tarjeta tiene varias secciones. La tarjeta muestra la viabilidad general de la migración al destino. Puede explorar en profundidad varias cargas de trabajo en varias categorías de complejidad de migración:

• La sección de compatibilidad de características proporciona el resultado de la revisión de la valoración de características.
• La recomendación de SKU proporciona el tamaño adecuado del destino.
• La evaluación de código proporciona la complejidad del código de los objetos de la base de datos.

Al seleccionar Ver detalles del informe, primero se muestra el resumen de la valoración.

Si el destino seleccionado es Database for Azure PostgreSQL, la pestaña Detalles de la base de datos o la pestaña Evaluación de código está visible en función de la selección del tipo de evaluación.

La pestaña Detalles de la base de datos siguiente proporciona el desglose por esquema. Muestra la lista de esquemas detectados, la viabilidad de la migración y el tiempo estimado para convertir el esquema en horas.

Esta estimación se basa en un modelo estadístico que se aplica al recuento de objetos, líneas de código, características habilitadas y tamaño de la base de datos. Para obtener una estimación más precisa sobre la conversión de código, use la evaluación de código.

Nota:

El sistema siguiente o los esquemas integrados de Oracle se excluyen de la valoración de carga de trabajo:

APEX, APPQOSSYS, AUDSYS, CSMIG, CTXSYS, DBMS_PRIVILEGE_CAPTURE, DBSFWUSER, DBSNMP, DIP, DMSYS, DVF, DVSYS, EXFSYS, FLOW_, GSMADMIN_INTERNAL, LBACSYS, MDDATA, MDSYS, MGDSYS, MGMT_VIEW, MTMSYS, ODM, ODM_MTR, OJVMSYS, OLAPSYS, ORACLE_OCM, ORDDATA, ORDPLUGINS, ORDSYS, OSE$HTTP$ADMIN, OUTLN, OWBSYS, OWBSYS_AUDIT, PERFSTAT, SDE, SI_INFORMTN_SCHEMA, SPATIAL_CSW_ADMIN_USR, SPATIAL_WFS_ADMIN_USR, SQLTXPLAIN, SYS, SYSMAN, SYSTEM, TRACESRV, TSMSYS, WEBSYS, WKPROXY, WKSYS, WK_PROXY, WK_TEST, WMSYS, XDB, XS$NULL

La recomendación de SKU proporciona los siguientes elementos:

• Destino adecuado de Azure.

• Nivel de servicio.

• Los umbrales de métrica se usan para proporcionar la SKU recomendada.

  

La recomendación de SKU evalúa varias métricas de rendimiento, como CPU, memoria, IOPS, latencia y almacenamiento. En función del uso y los datos de configuración, el recomendador proporciona el destino adecuado y el nivel de servicio adecuado. La recomendación de SKU se basa en la instancia raíz del contenedor o en el uso de la base de datos conectable. La selección de esquema se omite y no se aplica al ajuste de tamaño de la SKU.

Nota:

Si la característica del repositorio de cargas de trabajo automático (AWR) está habilitada en la instancia de Oracle, el recomendador de SKU usará las vistas DBA_HIST_ para recopilar los metadatos de las métricas de rendimiento. De lo contrario, el recomendador usará la configuración del servidor y otra información de vistas del sistema para cambiar el tamaño del destino de Azure SQL.

La compatibilidad de código (solo para destinos PostgreSQL) proporciona un resumen de los objetos de esquema que se pueden convertir en un destino de Azure. El informe proporciona el desglose de los objetos que se pueden convertir automáticamente, los que están preparados con condiciones y los que deben corregirse y convertirse manualmente.

El informe muestra el número total de objetos y horas de esfuerzo de conversión necesarias para migrar código a la base de datos de Azure PostgreSQL. La representación gráfica proporciona el desglose de cada tipo de objeto de esquema como tablas, vistas y clústeres. Los esfuerzos se clasifican como "Ready - automatically converted" (Listo: convertido automáticamente), "Revisión necesaria" y "Not ready - requires manual conversion" (No está listo: requiere conversión manual).

Una exploración en profundidad de las secciones "No está listo" y "Revisión necesaria" proporciona la lista de tareas de corrección y las horas de esfuerzo de cada tarea.

La valoración de características incluye las características asignadas de destino de datos de Oracle a Azure y el esfuerzo necesario para migrar esas funcionalidades al destino de Azure.

Para descargar el informe para su visualización sin conexión, seleccione Download combined reports (Descargar informes combinados) o Download individual reports (Descargar informes individuales).

También puede cancelar una valoración en curso, eliminar una valoración o mover las valoraciones a otro directorio.

Ruta de acceso de valoración de cambios

1. Vaya al marketplace de extensiones y busque Database Migration Assessment for Oracle.
2. Seleccione el icono Administrar y seleccione Configuración de extensiones.
3. Proporcione la nueva ruta de valoración en Valoración de Oracle: Ruta de valoración.

Solución de problemas

Registros

La extensión almacena errores, advertencias y otros registros de diagnóstico en el directorio de registro predeterminado:

• Windows: C:\Users\<username>.dmaoracle\logs\
• Linux: ~/.dmaoracle/logs
• macOS: /Users/<username>/.dmaoracle/logs

Nota

De manera predeterminada, la extensión almacena los últimos siete archivos de registro.

Para cambiar el directorio de registro, actualice la propiedad LogDirectory en el archivo de configuración de la extensión.

Sistema operativo	Ruta de acceso
Windows	C:\Users\<username>\.azuredatastudio\extensions\microsoft.azuredatastudio-dma-oracle-<VersionNumber>\bin\service\Properties\ConfigSettings\extension-settings.json
Linux	~/.azuredatastudio/extensions/microsoft.azuredatastudio-dma-oracle-<VersionNumber>/<VersionNumber>/bin/service/Properties/ConfigSettings/extension-settings.json
macOS	/Users/<username>/.azuredatastudio/extensions/microsoft.azuredatastudio-dma-oracle-<VersionNumber>/<VersionNumber>/bin/service/Properties/ConfigSettings/extension-settings.json

Para obtener más información sobre cómo solucionar problemas, visite Solución de problemas de evaluación de migración de bases de datos para errores de extensión de Oracle.

Limitaciones y problemas conocidos

• La ruta de acceso proporcionada no existe.

  Motivo: faltan archivos o faltan permisos en la carpeta de la valoración.

  Posible solución:

  • El usuario tiene permiso de lectura y escritura en la carpeta de valoración.
  • Si falta un archivo o una carpeta, elimine la valoración y genere una nueva.

• Se encontró una excepción de tiempo de espera de conexión al interactuar con Oracle.

  Motivo: no se pudo conectar a la instancia de Oracle.

  Posible solución:

  • Compruebe si las reglas de firewall bloquean el puerto de escucha de Oracle.
  • Ejecute tnsping y compruebe si se resuelve el id. de servicio.

Contacto con Microsoft para obtener ayuda

Si necesita más ayuda de Microsoft, póngase en contacto con @dmasupport. Para obtener una solución alternativa más rápida, puede adjuntar los registros desde el directorio de registro predeterminado.

Contenido relacionado

• Extensión para Oracle (versión preliminar)
• Extensión Azure SQL Migration para Azure Data Studio
• Database Schema Conversion Toolkit (DSCT)
• Extensión de la funcionalidad de Azure Data Studio