View a markdown version of this page

AWSSupport-TroubleshootDMSTableErrors - AWS Systems Manager Runbook-Referenz für Automation

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

AWSSupport-TroubleshootDMSTableErrors

Beschreibung

Das AWS Systems Manager AWSSuport-TroubleshootDMSTableErrors Automatisierungs-Runbook hilft Ihnen dabei, den Problembehandlungsprozess für die in der Datenbank Table errors gefundene Migrationsaufgabe oder die serverlose Replikation von zu automatisieren. AWS Database Migration Service Diese Fehler treten auf, wenn Tabellen durch die Datenbankmigrationsaufgabe oder die im Service erstellte serverlose Replikation nicht vom Quellendpunkt (Quelldatenbank) zum Zielendpunkt (Zieldatenbank) migriert werden können. AWS DMS Dieses Runbook analysiert die Signaturfehlermeldungen aus CloudWatch Protokollen und konzentriert sich dabei insbesondere auf Aufgabenprotokolle für herkömmliche Datenbankmigrationsaufgaben und serverlose Protokolle für serverlose Replikation. Es enthält auch gezielte Vorschläge und Maßnahmen zur Behebung häufiger Fehlermeldungen, die bei Migrationen auftreten. Table error AWS DMS

Wie funktioniert es?

Das Runbook führt die folgenden Schritte aus:

  • Ruft Informationen über den bereitgestellten AWS DMS ARN ab. Dabei kann es sich entweder um eine Datenbankmigrationsaufgabe oder um eine serverlose Replikation handeln.

  • Überprüft, ob die bereitgestellte AWS DMS Ressource mindestens einmal gestartet wurde, indem der FreshStartDate Wert in der DescribeReplicationTasks API-Antwort (für die Datenbankmigrationsaufgabe) und der DescribeReplications API-Antwort (für serverlose Replikation) überprüft wird. Wenn die Ressource nicht gestartet wurde, löst die Automatisierung einen Fehler aus.

  • Wenn die Ressource gestartet wurde, sucht die Automatisierung anhand von TableStatistics Informationen nach den Tabellen in den TableError jeweiligen Bundesstaaten. Wenn keine Fehler gefunden werden, beendet die Automatisierung den Workflow, nachdem eine Meldung angezeigt wird, in der bestätigt wird, dass bei der angegebenen Datenbankmigrationsaufgabe oder der serverlosen Replikation keine Tabellenfehler gefunden wurden.

  • Wenn Tabellen mit TableError Status gefunden werden, prüft die Automatisierung, ob die CloudWatch Protokollierung für die angegebene AWS DMS Ressource aktiviert ist. Wenn die Protokollierung nicht aktiviert ist, beendet die Automatisierung den Workflow, nachdem eine Meldung angezeigt wird, die darauf hinweist, dass die Protokollierung nicht aktiviert ist.

    Hinweis: Es wird erwartet, dass die CloudWatch Protokollierung aktiviert ist, da sich die Automatisierung auf diese Protokolle stützt, um die Probleme mit den Tabellen im TableError Status zu analysieren und zu identifizieren.

  • Wenn die Protokollierung aktiviert ist, analysiert die Automatisierung die CloudWatch Protokolle und generiert einen Bericht für jede Tabelle, die sich im TableError Status befindet. Der Bericht enthält Vorschläge für häufig auftretende Fehlermeldungen und enthält relevante Fehlerprotokolle, anhand derer Probleme identifiziert und behoben werden können, die eine erfolgreiche Tabellenmigration vom AWS DMS Quellendpunkt zum AWS DMS Zielendpunkt verhindern.

Führen Sie diese Automatisierung aus (Konsole)

Art des Dokuments

Automatisierung

Eigentümer

Amazon

Plattformen

/

Parameter

  • AutomationAssumeRole

    Typ: Zeichenfolge

    Beschreibung: (Optional) Der Amazon-Ressourcenname (ARN) der AWS Identity and Access Management (IAM) -Rolle, die es Systems Manager Automation ermöglicht, die Aktionen in Ihrem Namen auszuführen. Wenn keine Rolle angegeben ist, verwendet Systems Manager Automation die Berechtigungen des Benutzers, der dieses Runbook startet.

  • DMSArn

    Typ: Zeichenfolge

    Beschreibung: (Erforderlich) ARN der Datenbankmigrationsaufgabe oder der serverlosen Replikation

    Zulässiges Muster: ^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

    Typ: Zeichenfolge

    Beschreibung: (Optional) Dieser Parameter definiert den Beginn des Zeitraums für die CloudWatch Protokollanalyse der jeweiligen Datenbankmigrationsaufgabe oder der serverlosen Replikation. Wenn angegeben, werden nur Protokolle erfasst und analysiert, die ab diesem bestimmten Zeitpunkt generiert wurden. Bitte beachten Sie, dass die Möglichkeit besteht, dass der Workflow zu einem Timeout kommt, wenn der Zeitraum zwischen dem startDate und zu lang endDate ist. Der Wert sollte im ISO 6081-Datums-/Uhrzeitformat angegeben werden.

    Zulässiges Muster: ^$|^(\\d{4})-(\\d{2})-(\\d{2})T(\\d{2}):(\\d{2}):(\\d{2})\\.(\\d{3})Z$

  • EndTimeRange

    Typ: Zeichenfolge

    Beschreibung: (Optional) Dieser Parameter legt das Ende des Zeitbereichs für die CloudWatch Protokollanalyse der jeweiligen Datenbankmigrationsaufgabe oder der serverlosen Replikation fest. Wenn angegeben, werden nur Protokolle erfasst und analysiert, die bis zu diesem bestimmten Zeitpunkt generiert wurden. Bitte beachten Sie, dass die Möglichkeit besteht, dass der Workflow zu einem Timeout kommt, wenn der Zeitraum zwischen dem startDate und zu lang endDate ist. Der Wert sollte im ISO 6081-Datums-/Uhrzeitformat angegeben werden.

    Zulässiges Muster: ^$|^(\\d{4})-(\\d{2})-(\\d{2})T(\\d{2}):(\\d{2}):(\\d{2})\\.(\\d{3})Z$

Erforderliche IAM-Berechtigungen

Der AutomationAssumeRole Parameter erfordert die folgenden Aktionen, um das Runbook erfolgreich zu verwenden.

  • dms:DescribeReplicationTasks

  • dms:DescribeReplications

  • dms:DescribeEndpoints

  • dms:DescribeReplicationConfigs

  • dms:DescribeTableStatistics

  • dms:DescribeReplicationTableStatistics

  • logs:FilterLogEvents

Beispiel für eine IAM-Richtlinie für die Rolle 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": "*"
                    }
                ]
            }

Anweisungen

Folgen Sie diesen Schritten, um die Automatisierung zu konfigurieren:

  1. Navigieren Sie AWSSupport-TroubleshootDMSTableErrors im Systems Manager unter Dokumente zu.

  2. Wählen Sie Execute automation (Automatisierung ausführen).

  3. Geben Sie für die Eingabeparameter Folgendes ein:

    • AutomationAssumeRole (Fakultativ):

      Der Amazon-Ressourcenname (ARN) der AWS AWS Identity and Access Management (IAM) -Rolle, die es Systems Manager Automation ermöglicht, die Aktionen in Ihrem Namen durchzuführen. Wenn keine Rolle angegeben ist, verwendet Systems Manager Automation die Berechtigungen des Benutzers, der dieses Runbook startet.

    • DMSArn

      ARN der Datenbankmigrationsaufgabe oder der serverlosen Replikation, die Tabellenfehler aufweist.

    • StartTimeRange

      (Optional) ISO 6081-Datums-/Uhrzeitformat, das den Beginn des Zeitbereichs für die Analyse der CloudWatch Protokolle der jeweiligen Datenbankmigrationsaufgabe oder der serverlosen Replikation definiert.

    • EndTimeRange

      (Optional) ISO 6081-Datums- und Uhrzeitformat, das das Ende des Zeitbereichs für die Analyse der CloudWatch Protokolle der jeweiligen Datenbankmigrationsaufgabe oder der serverlosen Replikation definiert.

  4. Wählen Sie unten auf der Seite die Schaltfläche „Ausführen“.

  5. Die Automatisierung wird initiiert.

  6. Das Dokument führt die folgenden Schritte aus:

    • validieren DMSInputTypeAndGatherDetails

      Validiert die angegebene AWS DMS ARN-Eingabe und erfasst die grundlegenden Details der Datenbankmigrationsaufgabe oder der serverlosen Replikation, die in den nächsten Schritten erforderlich sind.

    • Zweig OnTableErrors

      Verzweigt den Workflow basierend auf der Anzahl der im obigen Schritt gefundenen Tabellenfehler. Wenn die Anzahl größer als 0 ist, fahren Sie mit branchOnCWLoggingStatus Schritt - fort. Andernfalls fahren Sie mit outputNoTableErrors Schritt - fort.

    • outputNoTableErrors

      Gibt eine Meldung aus, die besagt, dass die Tabellenfehler in der angegebenen Datenbankmigrationsaufgabe oder der serverlosen Replikation nicht gefunden wurden.

    • Zweig OnCWLoggingStatus

      Verzweigt den Workflow basierend auf dem CloudWatch Protokollierungsstatus, den Sie im obigen Schritt gefunden haben. Falls aktiviert, fahren Sie mit gatherTableDetails Schritt - fort. Andernfalls fahren Sie mit outputNoCWLoggingEnabled Schritt - fort.

    • outputNoCWLoggingEnabled

      Gibt eine Meldung aus, die besagt, dass die CloudWatch Protokollierung in der angegebenen Datenbankmigrationsaufgabe oder der serverlosen Replikation nicht aktiviert ist.

    • sammeln TableDetails

      Sammelt die FullLoadEndTime Zeitstempel der fehlgeschlagenen Tabellen und berechnet die Zeitbereichswerte zur Analyse der Protokolle. CloudWatch

    • analysieren CloudWatchLogs

      Analysiert die in der CloudWatch Protokollgruppe gefundenen Protokolle anhand der Signaturfehlermeldungen und gibt den Bericht an den Benutzer zurück.

  7. Nach Abschluss der Ausführung finden Sie im Abschnitt Ausgaben die detaillierten Ergebnisse der Ausführung.

    • Ausgabe „Keine Tabelle“ -Fehler gefunden

      Wenn in der bereitgestellten Datenbankmigrationsaufgabe oder der serverlosen Replikation keine Tabellenfehler gefunden wurden, zeigt die Automatisierung dieselbe Ausgabe an.

    • Ausgabe: Keine CloudWatch Anmeldung aktiviert

      Wenn die CloudWatch Protokollierung in der bereitgestellten Datenbankmigrationsaufgabe oder der serverlosen Replikation nicht aktiviert ist, zeigt die Automatisierung die Ausgabe an, die dasselbe besagt, und enthält die Schritte zur Aktivierung der Protokollierung.

    • Bericht zur Protokollanalyse

      Gibt einen Bericht aus, in dem die Tabellen identifiziert werden, die sich im Table error Status der bereitgestellten Datenbankmigrationsaufgabe oder der serverlosen Replikation befinden. Dabei wird zwischen den Fehlertypen unterschieden, die aufgetretenen Fehlermeldungen aufgeführt und gezielte Korrekturmaßnahmen und Vorschläge für jede identifizierte Tabelle bereitgestellt.

Referenzen

Systems Manager Automation