View a markdown version of this page

AWSSupport-TroubleshootDMSTableErrors - AWS Systems Manager Referencia del manual de procedimientos de Automatizació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.

AWSSupport-TroubleshootDMSTableErrors

Descripción

El manual de AWS Systems Manager AWSSuport-TroubleshootDMSTableErrors automatización le ayuda a automatizar el proceso de solución de problemas que Table errors se encuentran en las tareas de migración de bases de datos o desde las que se replican sin servidor. AWS Database Migration Service Estos errores se producen cuando las tablas no pueden migrar del punto final de origen (base de datos de origen) al punto final de destino (base de datos de destino) mediante la tarea de migración de la base de datos o la replicación sin servidor creada en el servicio. AWS DMS Este manual analiza los mensajes de error de firma de los registros y se centra específicamente en CloudWatch los registros de tareas para las tareas tradicionales de migración de bases de datos y en los registros sin servidor para la replicación sin servidor. También proporciona sugerencias específicas y pasos para corregir los mensajes de error más comunes que aparecen durante las migraciones. Table error AWS DMS

¿Cómo funciona?

El manual lleva a cabo los siguientes pasos:

  • Obtiene información sobre el AWS DMS ARN proporcionado, que puede ser una tarea de migración de la base de datos o una replicación sin servidor.

  • Comprueba si el AWS DMS recurso proporcionado se ha iniciado al menos una vez comprobando el FreshStartDate valor de la respuesta de la DescribeReplicationTasks API (para la tarea de migración de bases de datos) y de la DescribeReplications API (para la replicación sin servidor). Si el recurso no se ha iniciado, la automatización genera un error.

  • Si el recurso se ha iniciado, la automatización comprueba las tablas de los TableError estados mediante la TableStatistics información. Si no se encuentra ningún error, la automatización finaliza el flujo de trabajo tras mostrar un mensaje confirmando que no se ha encontrado ningún error en la tabla en la tarea de migración de bases de datos o en la replicación sin servidor especificada.

  • Si se encuentran tablas con TableError estado, la automatización comprueba si el CloudWatch registro está habilitado para el AWS DMS recurso especificado. Si el registro no está habilitado, la automatización finaliza el flujo de trabajo después de mostrar un mensaje que indica que el registro no está habilitado.

    Nota: se espera que el CloudWatch registro esté habilitado, ya que la automatización se basa en estos registros para analizar e identificar los problemas relacionados con las tablas en TableError estado.

  • Si el registro está habilitado, la automatización analiza los CloudWatch registros y genera un informe para cada tabla que esté en TableError estado. El informe incluye sugerencias sobre los mensajes de error más comunes y proporciona los registros de errores pertinentes para ayudar a identificar y resolver los problemas que impiden la migración correcta de las tablas del punto final de AWS DMS origen al punto final de AWS DMS destino.

Ejecuta esta automatización (consola)

Tipo de documento

Automatización

Propietario

Amazon

Plataformas

/

Parámetros

  • AutomationAssumeRole

    Tipo: cadena

    Descripción: (opcional) el Nombre de recurso de Amazon (ARN) del rol de AWS Identity and Access Management (IAM) que permite a Systems Manager Automation realizar las acciones en su nombre. Si no se especifica ningún rol, Systems Manager Automation utiliza los permisos del usuario que comienza este manual de procedimientos.

  • DMSArn

    Tipo: cadena

    Descripción: ARN (obligatorio) de la tarea de migración de la base de datos o de la replicación sin servidor

    Valor permitido: ^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):dms:[a-z0-9-]+:\d{12}:(task|replication-config):[a-zA-Z0-9-]+$

  • StartTimeRange

    Tipo: cadena

    Descripción: (opcional) Este parámetro define el principio del intervalo de tiempo para el análisis de los CloudWatch registros de la tarea de migración de bases de datos o la replicación sin servidor en cuestión. Cuando se proporcionen, solo se recopilarán y analizarán los registros generados a partir de este momento específico. Tenga en cuenta que existe la posibilidad de que se agote el tiempo de espera del flujo de trabajo si el intervalo de tiempo entre startDate y endDate es demasiado largo. El valor debe proporcionarse en el formato de fecha y hora ISO 6081.

    Valor permitido: ^$|^(\\d{4})-(\\d{2})-(\\d{2})T(\\d{2}):(\\d{2}):(\\d{2})\\.(\\d{3})Z$

  • EndTimeRange

    Tipo: cadena

    Descripción: (opcional) Este parámetro establece el final del intervalo de tiempo para el análisis del CloudWatch registro de la tarea de migración de la base de datos o la replicación sin servidor determinada. Cuando se proporcionen, solo se recopilarán y analizarán los registros generados hasta este momento específico. Tenga en cuenta que existe la posibilidad de que se agote el tiempo de espera del flujo de trabajo si el intervalo de tiempo entre startDate y endDate es demasiado largo. El valor debe proporcionarse en el formato de fecha y hora ISO 6081.

    Valor permitido: ^$|^(\\d{4})-(\\d{2})-(\\d{2})T(\\d{2}):(\\d{2}):(\\d{2})\\.(\\d{3})Z$

Permisos de IAM necesarios

El parámetro AutomationAssumeRole requiere las siguientes acciones para utilizar el manual de procedimientos correctamente.

  • dms:DescribeReplicationTasks

  • dms:DescribeReplications

  • dms:DescribeEndpoints

  • dms:DescribeReplicationConfigs

  • dms:DescribeTableStatistics

  • dms:DescribeReplicationTableStatistics

  • logs:FilterLogEvents

Ejemplo de política de IAM para el rol Automation Assume

JSON

            {
                "Version":"2012-10-17",
                "Statement": [
                    {
                        "Sid": "VisualEditor0",
                        "Effect": "Allow",
                        "Action": [
                            "dms:DescribeReplicationConfigs",
                            "dms:DescribeEndpoints",
                            "dms:DescribeReplicationTableStatistics",
                            "dms:DescribeTableStatistics",
                            "logs:FilterLogEvents",
                            "dms:DescribeReplicationTasks",
                            "dms:DescribeReplications"
                        ],
                        "Resource": "*"
                    }
                ]
            }

Instrucciones

Siga estos pasos para configurar la automatización:

  1. Navegue hasta el Administrador de Sistemas, AWSSupport-TroubleshootDMSTableErrors en la sección Documentos.

  2. Elija Execute automation (Ejecutar automatización).

  3. Para los parámetros de entrada, introduzca lo siguiente:

    • AutomationAssumeRole (Opcional):

      El nombre de recurso de Amazon (ARN) del rol AWS AWS Identity and Access Management (IAM) que permite a Systems Manager Automation realizar las acciones en su nombre. Si no se especifica ningún rol, Systems Manager Automation utiliza los permisos del usuario que inicia este libro de ejecución.

    • DMSArn

      El ARN de la tarea de migración de la base de datos o de la replicación sin servidor que tiene errores de tabla.

    • StartTimeRange

      (Opcional) Formato de fecha y hora ISO 6081 que define el inicio del intervalo de tiempo para analizar los CloudWatch registros de la tarea de migración de la base de datos determinada o de la replicación sin servidor.

    • EndTimeRange

      (Opcional) Formato de fecha y hora ISO 6081 que define el final del intervalo de tiempo para analizar los CloudWatch registros de una determinada tarea de migración de bases de datos o replicación sin servidor.

  4. Seleccione el botón Ejecutar en la parte inferior de la página.

  5. Se inicia la automatización.

  6. Este documento realiza los siguientes pasos:

    • validar DMSInputTypeAndGatherDetails

      Valida la entrada AWS DMS ARN dada y recopila los detalles básicos de la tarea de migración de la base de datos o la replicación sin servidor que se requieren en los pasos siguientes.

    • sucursal OnTableErrors

      Diversifica el flujo de trabajo en función del número de errores de tabla encontrados en el paso anterior. Si el recuento es mayor que 0, continúe con el branchOnCWLoggingStatus paso -. De lo contrario, continúe con el outputNoTableErrors paso -.

    • salidaNoTableErrors

      Genera un mensaje que indica que los errores de la tabla no se encuentran en la tarea de migración de bases de datos o en la replicación sin servidor en cuestión.

    • sucursal OnCWLoggingStatus

      Diversifica el flujo de trabajo en función del estado de CloudWatch registro que se encuentra en el paso anterior. Si está activado, continúe con el gatherTableDetails paso -. De lo contrario, continúe con el outputNoCWLoggingEnabled paso -.

    • salidaNoCWLoggingEnabled

      Genera un mensaje que indica que el CloudWatch registro no está habilitado en la tarea de migración de bases de datos o replicación sin servidor determinada.

    • recopilar TableDetails

      Recopila las FullLoadEndTime marcas de tiempo de las tablas fallidas y calcula los valores del intervalo de tiempo para analizar los registros. CloudWatch

    • analizar CloudWatchLogs

      Analiza los registros encontrados en el grupo de CloudWatch registros en función de los mensajes de error de firma y devuelve el informe al usuario.

  7. Una vez finalizada la ejecución, consulte la sección Resultados para ver los resultados detallados de la ejecución.

    • No se han encontrado errores en el resultado de la tabla

      Si no se encuentran errores de tabla en la tarea de migración de bases de datos o en la replicación sin servidor proporcionada, la automatización muestra el resultado que indica lo mismo.

    • Salida de Sin inicio de CloudWatch sesión habilitado

      Si el CloudWatch registro no está habilitado en la tarea de migración de bases de datos o en la replicación sin servidor proporcionada, la automatización muestra el resultado que indica lo mismo y proporciona los pasos para habilitar el registro.

    • Informe de análisis de registros

      Genera un informe en el que se identifican las tablas en Table error estado procedentes de la tarea de migración de bases de datos proporcionada o de la replicación sin servidor, diferenciando los tipos de error, enumerando los mensajes de error encontrados y proporcionando sugerencias y pasos de corrección específicos para cada tabla identificada.

Referencias

Automatización de Systems Manager