View a markdown version of this page

Informes de evaluación de conversiones con DMS Schema Conversion - AWS Database Migration Service
Realizar una evaluaciónGuardar informes de evaluaciónVisualización del informe de evaluación

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Informes de evaluación de conversiones con DMS Schema Conversion

Una parte importante de la conversión de esquemas del DMS es el informe que genera para ayudarle a convertir el esquema. Este informe de evaluación de conversiones analiza los objetos de la base de datos de su esquema de origen e identifica qué objetos puede convertir DMS Schema Conversion automáticamente y qué objetos requieren una acción manual. Puede ver el informe en la AWS DMS consola o guardar una copia como archivo PDF o de valores separados por comas (CSV).

El informe de evaluación de conversiones incluye lo siguiente:

  • Un resumen ejecutivo

  • Recomendaciones para convertir objetos de base de datos que requieren una acción manual

Cuando tiene objetos de base de datos que DMS Schema Conversion no puede convertir automáticamente, el informe proporciona estimaciones que muestran cuánto esfuerzo se requiere para escribir el código equivalente para la instancia de base de datos de destino.

Temas

Realizar una evaluación para un informe de evaluación de conversiones con DMS Schema Conversion

Después de crear un proyecto de migración, utilice uno de los siguientes métodos para evaluar la complejidad de la conversión.

AWS Management Console
Para realizar una evaluación y generar un informe de evaluación de la conversión

  1. Inicie sesión en Consola de administración de AWS y abra la AWS DMS consola en https://console.aws.amazon.com/dms/v2/.

  2. Elija Proyectos de migración. Se abre la página Proyectos de migración.

  3. Elija el proyecto de migración y, a continuación, elija la conversión de esquemas.

  4. Elija Lanzar la conversión de esquemas. Se abre la página Conversión de esquemas.

  5. En el panel de la base de datos de origen, seleccione el nodo que desea evaluar. La acción Evaluar está disponible en el nodo Bases de datos, en los nodos de bases de datos individuales y en los nodos de esquema, como dbo. No está disponible en nodos de objetos individuales, como tablas o procedimientos.

  6. Seleccione al menos un nodo principal en el panel de la base de datos de origen. El menú Acciones solo está disponible cuando se selecciona un nodo principal.

  7. Abra el menú Acciones y seleccione Evaluar. Aparece un cuadro de diálogo de confirmación.

  8. Elija Evaluar en el cuadro de diálogo para confirmar su elección.

AWS CLI

En el siguiente ejemplo, se utiliza start-metadata-model-assessment para hacer una evaluación de la complejidad de la conversión de todos los objetos del esquema. ExampleSchema

aws dms start-metadata-model-assessment \
        --migration-project-identifier "arn:aws:dms:us-east-1:111122223333:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS" \
        --selection-rules '{"rules": [{"rule-type": "selection", "rule-id": "1", "rule-name": "1", "object-locator": {"server-name": "source-server", "schema-name": "ExampleSchema"}, "rule-action": "explicit"}]}'
nota

El --selection-rules parámetro toma una cadena JSON que especifica qué objetos de base de datos se deben incluir en la evaluación. Para ver la estructura JSON completa de las reglas de selección, consulteReglas de selección en la conversión de esquemas de DMS.

La respuesta contiene un RequestIdentifier que identifica la solicitud de evaluación.

{
    "RequestIdentifier": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
}

Como una evaluación se ejecuta de forma asincrónica, utilice aws dms wait metadata-model-assessed para bloquearlo hasta que la evaluación finalice antes de continuar.

aws dms wait metadata-model-assessed \
        --migration-project-identifier "arn:aws:dms:us-east-1:111122223333:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS"

El comando sondea cada 30 segundos y regresa cuando la evaluación alcanza un estado terminal. Sale con el código de retorno 255 si la evaluación no se completa después de 360 comprobaciones (aproximadamente 3 horas).

El inicio de una evaluación no genera cada vez un informe completamente nuevo partiendo de cero. El informe de evaluación de la conversión refleja el estado actual de su proyecto de migración, por lo que incluye los elementos de acción y los candidatos a generar IA para todo lo que haya evaluado o convertido hasta el momento. Para obtener más información, consulte Comprender las métricas de los informes de evaluación de conversiones.

Guardar el informe de evaluación de la conversión para la conversión del esquema de DMS

Tras realizar una evaluación o una conversión, puede guardar una copia del informe de evaluación de la conversión en formato PDF o en archivos de valores separados por comas (CSV).

AWS Management Console
Informe en PDF
Para guardar un informe de evaluación de conversiones como archivo PDF

  1. Elija Exportar y, a continuación, elija PDF. Revise el cuadro de diálogo y elija Exportar a PDF.

  2. La conversión de esquemas de DMS almacena el archivo PDF en el bucket de Amazon S3 que configuró en la configuración de acceso al bucket de S3 de su proyecto de migración.

  3. Abra el archivo del informe de evaluación en el bucket de Amazon S3.

Exportación a CSV
Para guardar un informe de evaluación de conversiones como archivos CSV

  1. Elija Exportar y, a continuación, elija CSV. Revise el cuadro de diálogo y elija Exportar a CSV.

  2. La conversión de esquemas de DMS almacena un archivo ZIP que contiene los archivos CSV en el bucket de Amazon S3 que configuró en la configuración de acceso al bucket de S3 de su proyecto de migración.

  3. Descargue y extraiga el archivo ZIP de su bucket de Amazon S3 para acceder a los archivos CSV.

Nombres de archivos y cubos de S3

El bucket de Amazon S3 en el que DMS Schema Conversion almacena los informes exportados es el bucket que especificó en la configuración de acceso al bucket de S3 al crear el proyecto de migración.

Los archivos se almacenan en una carpeta que coincide con el nombre de su proyecto de migración. Al exportar desde Consola de administración de AWS, los archivos se nombran según el motor de origen, el motor de destino y una marca de hora UTC: project-name/SOURCE_ENGINE_TARGET_ENGINE_YYYY-MM-DDTHH-MM-SS.sssZ — por ejemplo,. ora-pg-demo/ORACLE_POSTGRESQL_2026-07-01T09-00-47.846Z.pdf

El archivo CSV contiene al menos tres archivos organizados en una ruta de directorio de dos niveles. El directorio de nivel superior es el nombre del servidor de origen exactamente como está configurado en el proveedor de datos de origen (nombre de host o dirección IP). Los nombres de subdirectorio y archivo utilizan el nombre de host de la base de datos de destino:

  • source-server/target-host/target-host.csv— una fila por aparición de un elemento de acción.

  • source-server/target-host/target-host_Action_Items_Summary.csv— una fila por tipo de elemento de acción, con valores de esfuerzo.

  • source-server/target-host/target-host_Summary.csv— una fila por tipo de objeto, con recuentos de complejidad.

  • source-server/target-host/target-host_Stub_Objects.csv— una fila por objeto auxiliar generado para una unidad integrada no compatible. Este archivo solo está presente cuando la opción Convertir objetos integrados no compatibles en objetos auxiliares está habilitada en la configuración del proyecto de migración.

AWS CLI

En el siguiente ejemplo, se utiliza export-metadata-model-assessment para exportar el informe de evaluación de conversiones de un proyecto de migración como archivo PDF y CSV a su bucket de Amazon S3.

aws dms export-metadata-model-assessment \
        --migration-project-identifier "arn:aws:dms:us-east-1:111122223333:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS" \
        --selection-rules '{"rules":[{"rule-type":"selection","rule-id":"1","rule-name":"1","rule-action":"explicit","object-locator":{"server-name":"source-server","schema-name":"ExampleSchema"}}]}' \
        --assessment-report-types pdf csv
nota

El --selection-rules parámetro toma una cadena JSON que especifica qué objetos de base de datos se deben incluir en el informe. Para ver la estructura JSON completa de las reglas de selección, consulteReglas de selección en la conversión de esquemas de DMS.

La respuesta contiene la clave de objeto de Amazon S3 y la URL de descarga de cada archivo de informe.

Si no lo especifica--file-name, los archivos se almacenan en una carpeta que coincide con el nombre de su proyecto de migración, utilizando una marca de tiempo como nombre del archivoproject-name/YYYY-MM-DD-HH-MM-SS.zip: project-name/YYYY-MM-DD-HH-MM-SS.pdf y, por ejemplo,. sqlserver-pg-pma/2026-07-15-10-08-12.zip --file-nameEspecifica si deseas anular el prefijo de marca de hora de esa carpeta.

{
    "PdfReport": {
        "S3ObjectKey": "project-name/YYYY-MM-DD-HH-MM-SS.pdf",
        "ObjectURL": "https://amzn-s3-demo-bucket.s3.amazonaws.com/project-name/YYYY-MM-DD-HH-MM-SS.pdf"
    },
    "CsvReport": {
        "S3ObjectKey": "project-name/YYYY-MM-DD-HH-MM-SS.zip",
        "ObjectURL": "https://amzn-s3-demo-bucket.s3.amazonaws.com/project-name/YYYY-MM-DD-HH-MM-SS.zip"
    }
}
nota

El informe de evaluación de conversiones también está disponible después de ejecutar una operación de conversión, no solo después de ejecutar una evaluación explícita. Tras una conversión, el informe refleja los objetos que aún requieren una acción manual y marca los objetos que DMS Schema Conversion convirtió mediante IA generativa. Para obtener información sobre cómo ejecutar una conversión, consulte. Cómo convertir el esquema de su base de datos: guía paso a paso

Visualización del informe de evaluación de conversiones para la conversión de esquemas de DMS

Para ver su informe de evaluación de conversiones, utilice uno de los métodos siguientes.

importante

El informe de evaluación de conversiones solo cubre los objetos de la base de datos que se incluyeron en el ámbito de la operación de evaluación o conversión más reciente. Los objetos que no se seleccionaron al ejecutar Assess o Convert no aparecen en el informe, aunque existan en la base de datos de origen.

Cada nueva operación de evaluación o conversión sobrescribe el informe anterior. Las pestañas Resumen y Elementos de acción siempre reflejan únicamente la operación más reciente. Si necesitas conservar los resultados del informe actual, expórtalo como un archivo PDF o CSV antes de ejecutar una nueva evaluación o conversión. Para obtener instrucciones de exportación, consulteGuardar informes de evaluación.

AWS Management Console

Tras ejecutar una evaluación o una conversión, la conversión de esquemas de DMS agrega información en las siguientes pestañas:

  • Resumen

  • Elementos de acción

Pestaña de resumen

La pestaña Resumen muestra la información resumida del informe de evaluación de conversiones. Muestra el número de objetos de base de datos que DMS Schema Conversion puede convertir automáticamente en objetos de almacenamiento de bases de datos y objetos de código de bases de datos.

La conversión de esquemas de DMS convierte muchos objetos de base de datos automáticamente e identifica aquellos que requieren una acción manual para completar la conversión al motor de base de datos de destino. La pestaña Resumen proporciona una estimación del esfuerzo necesario para crear objetos de base de datos en la instancia de base de datos de destino que sean equivalentes a los de la instancia de origen.

Para ver el resumen de conversión de los objetos de almacenamiento de la base de datos, como tablas, secuencias, restricciones, tipos de datos, etc., elija Objetos de almacenamiento de base de datos.

Para ver el resumen de conversión de los objetos de código de la base de datos, como procedimientos, funciones, vistas, desencadenadores, etc., elija Objetos de código de base de datos.

Para cambiar el alcance del informe de evaluación, seleccione el nodo necesario en el árbol de la base de datos de origen. La conversión de esquemas del DMS actualiza el resumen del informe de evaluación para que coincida con el alcance seleccionado.

Pestaña Elementos de acción

La pestaña de elementos de acción contiene una lista de elementos de acción para los objetos de base de datos que la conversión de esquemas de DMS no puede convertir automáticamente a un formato compatible con el motor de base de datos de destino. Para cada elemento de acción, la conversión de esquemas del DMS proporciona la descripción del problema y la acción recomendada. La conversión de esquemas del DMS agrupa elementos de acción similares y muestra el número de repeticiones.

Para ver el código del objeto de base de datos relacional, seleccione un elemento de acción de la lista.

IA generativa

La Conversión de esquemas de DMS con la IA generativa agiliza el proceso de migración de bases de datos al ofrecer recomendaciones que lo ayudan a convertir objetos de código que no se habían convertido anteriormente y que, por lo general, requieren una conversión manual compleja. Actualmente, esta función está disponible para bases de datos de origen de Oracle, SQL Server, SAP ASE (Sybase ASE), IBM Db2 para LUW e IBM Db2 para convertirlas a z/OS PostgreSQL o Aurora PostgreSQL.

El informe de evaluación muestra qué objetos de código de base de datos son candidatos para la conversión mediante IA generativa. Puede exportar este informe a un PDF para obtener una lista breve de cinco objetos por elemento de acción. Puede exportar el informe a un archivo CSV para ver la lista completa de candidatos.

Cuando se habilita el esquema de conversión mediante IA generativa y se realiza una conversión, el informe de evaluación actualizado marca cada objeto de la base de datos con un elemento de acción correspondiente, tanto los objetos que se convirtieron correctamente mediante la IA generativa como los objetos que la IA generativa no pudo convertir, lo que facilita la identificación y el seguimiento de los resultados de la conversión. AI-assisted

Para localizar rápidamente los objetos convertidos por la IA generativa:

  1. Vaya a la pestaña Elementos de acción.

  2. En la esquina superior derecha, busque el menú desplegable.

  3. Seleccione Generado por IA entre las opciones.

Este método de filtrado le permite ver de manera eficiente todos los objetos de la base de datos que se han convertido correctamente con esta característica. Para obtener más información sobre la conversión de objetos de bases de datos con IA generativa, consulte. Alcance de la conversión con IA generativa

PDF report

El informe en PDF contiene los cuatro capítulos siguientes, en este orden:

  • Resumen ejecutivo: una descripción general de la complejidad de la migración. Muestra el número de objetos de base de datos que DMS Schema Conversion puede convertir automáticamente y el número de objetos que requieren una acción manual, desglosados por tipo de objeto (tablas, vistas, procedimientos, desencadenadores, etc.) y por categoría de complejidad (acciones simples, acciones de complejidad media y acciones complejas que se convierten automáticamente). Para obtener más información sobre estas categorías, consulte. Categorías de complejidad

  • Objetos de base de datos con acciones de conversión: un desglose de los objetos de base de datos específicos que requieren una acción manual, organizados por tipo de objeto. Cada entrada identifica el objeto por su nombre y muestra el código del elemento de acción.

  • Candidatos para la conversión con IA generativa: los objetos de base de datos que DMS Schema Conversion identifica como candidatos para la conversión automática mediante IA generativa. El PDF muestra hasta cinco objetos candidatos por tipo de elemento de acción. Para ver la lista completa de candidatos, exporte el informe en formato CSV.

  • Recomendaciones detalladas para las migraciones: un análisis por objeto de cada objeto de la base de datos que requiere una acción manual. Para cada objeto, este capítulo muestra el código del elemento de acción (consulteCódigos de elementos de acción), una descripción de la incompatibilidad específica con el motor de la base de datos de destino y la acción de conversión manual recomendada. A diferencia de la pestaña Elementos de acción del Consola de administración de AWS, que agrupa los elementos de acción por tipo en todos los objetos, en este capítulo se enumeran cada objeto afectado de forma individual.

Para exportar el informe en formato PDF, consulteGuardar informes de evaluación.

CSV report

Al exportar el informe de evaluación a CSV, DMS Schema Conversion crea un archivo que contiene al menos tres archivos CSV. El archivo utiliza una estructura de directorios de dos niveles: el directorio de nivel superior es el nombre del servidor de origen exactamente como está configurado en el proveedor de datos de origen (nombre de host o dirección IP), y los nombres de subdirectorio y archivo utilizan el nombre de host de la base de datos de destino.

Archivo de elementos de acción (.csv) target-host

El archivo CSV principal (sin sufijo) contiene una fila por cada aparición del elemento de acción. Contiene las siguientes columnas:

  • Categoría: el tipo de objeto de base de datos al que se aplica el elemento de acción, como procedure oview-constraint.

  • Ocurrencia: la ruta completa a la instancia de objeto de base de datos específica a la que afecta el elemento de acción, por ejemploSchemas.schema_name.Procedures.procedure_name.

  • Elemento de acción: el código numérico del elemento de acción que identifica el tipo de problema de conversión. Para obtener más información, consulte Códigos de elementos de acción.

  • Asunto: el nombre del objeto de base de datos específico o el elemento de código al que hace referencia el elemento de acción, como un identificador sin resolver. Este campo está vacío cuando el elemento de acción no hace referencia a un nombre de objeto específico.

  • Grupo: descripción genérica del tipo de problema que comparten cada vez que aparece el código de ese elemento de acción. La conversión de esquemas de DMS usa este valor para agrupar las ocurrencias relacionadas.

  • Descripción: una descripción detallada de la incompatibilidad específica de esta incidencia.

  • Referencias a la documentación: enlaces a la documentación relevante para resolver la incompatibilidad.

  • Acción recomendada: el paso de conversión manual sugerido para resolver la incompatibilidad.

  • Filtrado: indica si el elemento de acción se filtró para excluirlo de la vista del informe.

  • Complejidad estimada: la categoría de complejidad asignada a esta incidencia: acciones simples, acciones de complejidad media o acciones complejas convertidas automáticamente.

  • Línea: el número de línea del código del objeto fuente en el que se produce la incompatibilidad.

  • Posición: la posición del carácter en la línea en la que se produce la incompatibilidad.

  • Fuente: el motor de la base de datos de origen.

  • Destino: el motor de base de datos de destino.

  • Dirección IP y puerto del servidor: el host y el puerto del servidor de base de datos de origen.

  • Nombre de la base de datos: el nombre de la base de datos de origen.

  • Nombre del esquema: el nombre del esquema de origen que contiene el objeto afectado.

  • AI/ML Recomendación: la recomendación de la IA generativa para convertir este objeto, cuando la conversión generativa de la IA estaba habilitada y producía un resultado para este caso.

Archivo de resumen de los elementos de acción (target-host_ .csvAction_Items_Summary)

Contiene una fila por tipo de elemento de acción con las siguientes columnas:

  • Esquema: el nombre del esquema de origen que contiene los objetos afectados.

  • Elemento de acción: el código numérico del elemento de acción que identifica el tipo de problema de conversión. Para obtener más información, consulte Códigos de elementos de acción.

  • Número de ocurrencias: el número total de objetos de base de datos afectados por este tipo de elemento de acción.

  • Esfuerzos de la curva de aprendizaje: el esfuerzo único que se requiere para diseñar un enfoque de conversión para este tipo de elemento de acción. Se incurre en este coste una vez por tipo de elemento de acción, independientemente del número de incidencias. Los valores utilizan una escala ponderada que va de bajo (mínimo esfuerzo) a alto (mayor esfuerzo).

  • Esfuerzos para convertir una incidencia: el esfuerzo necesario para resolver cada incidencia individual de este tipo de elemento de acción, siguiendo el enfoque de conversión diseñado. Los valores utilizan la misma escala ponderada que los esfuerzos de la curva de aprendizaje.

  • Descripción del elemento de acción: descripción de la incompatibilidad que representa este tipo de elemento de acción.

  • Acción recomendada: el paso de conversión manual sugerido para resolver este tipo de elemento de acción.

Archivo de resumen (target-host_Summary.csv)

Contiene una fila por tipo de objeto de base de datos con las siguientes columnas:

  • Categoría: el tipo de objeto de base de datos que resume la fila, comoTABLE,VIEW,PROCEDURE,TRIGGER,,INDEX, CONSTRAINTSEQUENCE, oFUNCTION. El archivo también incluye filas métricas agregadas con un Category valor de Storage_objects_countCode_objects_count, oSQL_syntax_elements_number. Para obtener más información sobre estos valores agregados, consulteEstadísticas de conversión y métricas de SQL.

  • Número de objetos: el número total de objetos de base de datos de este tipo en el ámbito evaluado.

  • Objetos convertidos automáticamente: la cantidad de objetos que la conversión de esquemas de DMS puede convertir sin ninguna acción manual.

  • Objetos con acciones sencillas: el número de objetos cuya conversión requiere un pequeño esfuerzo manual.

  • Objetos con acciones de complejidad media: el número de objetos cuya conversión requiere un esfuerzo manual moderado.

  • Objetos con acciones complejas: la cantidad de objetos cuya conversión requiere un esfuerzo manual considerable.

  • Total de líneas de código: el número total de líneas de código fuente en todos los objetos de este tipo.

Para exportar el informe en formato CSV, consulteGuardar informes de evaluación.

Archivo de objetos auxiliares (target-host_ Stub_Objects .csv)

Este archivo solo está presente cuando la opción Convertir objetos integrados no compatibles en objetos auxiliares está habilitada en la configuración del proyecto de migración. Contiene una fila por cada objeto auxiliar generado para una versión integrada no compatible, con las siguientes columnas:

  • Categoría: el tipo de objeto auxiliar, por ejemplo. scalar-function

  • Nombre del objeto auxiliar: el nombre completo del código auxiliar generado, incluidos el esquema y la firma.

  • Número de apariciones: el número de veces que se hace referencia a este objeto de código auxiliar en el código convertido.