Behandeln von Fehlern in der Azure PostgreSQL-Migrationserweiterung
Hinweis
Diese Erweiterung ist auf dem Pfad für die Ausmusterung. Sie müssen alle vorherigen Bewertungen exportieren.
In diesem Artikel wird erläutert, wie Sie Probleme und Fehler ermitteln, diagnostizieren und beheben, die bei der Verwendung der Azure PostgreSQL-Migrationserweiterung auftreten können.
Problembehandlung
Um Probleme mit einer Azure PostgreSQL-Migrationserweiterung zu beheben, müssen Sie die Fehler- und Warnungsdetails aus den generierten Protokollen ermitteln. In diesem Abschnitt wird erläutert, wie Sie auf die Protokolle zugreifen.
Protokolle
Die Erweiterung speichert Fehler, Warnungen und andere Diagnoseprotokolle im Standardprotokollverzeichnis:
- Windows –
C:\Users\<username>\.postgresmigration\logs\
- Linux:
~/.postgresmigration/logs
- macOS:
/Users/<username>/.postgresmigration/logs
Hinweis
Die Erweiterung speichert standardmäßig die letzten sieben Protokolldateien.
Details zu Fehlercodes
Im folgenden Abschnitt finden Sie weitere Informationen zu Fehlercodes, Meldungen, möglichen Ursachen und den zugehörigen Wartungsaktionen.
Fehlercode: GE-0000
Fehlermeldung: Unbekannter Fehler bei der Datensammlung. Versuchen Sie, eine neue Bewertung zu erstellen.
Mögliche Ursachen: Es handelt sich um einen allgemeinen Fehler, der aus mehreren Gründen auftreten kann.
Gegenmaßnahmen: Versuchen Sie, eine neue Bewertung zu erstellen. Um den Fehler weiter zu untersuchen, gehen Sie die Protokolle durch, um die Ursache zu ermitteln. Wenn das Problem weiterhin besteht, wenden Sie sich an Microsoft.
Fehlercode: FSMB-0000
Fehlermeldung: Unbekannter Fehler beim Generieren der Bewertungsausgabe.
Mögliche Ursachen: Dieser Fehler kann aus einem der angegebenen Gründe auftreten:
Der oder Benutzer*in verfügt möglicherweise nicht über Schreibberechtigungen für den Bewertungsdatenordner.
Der Bewertungsdatenordner wird bereits von einem anderen Programm verwendet.
Korrekturaktionen: Sie müssen sicherstellen, dass der angemeldete Benutzer über Schreibberechtigungen für den Bewertungsdatenordner verfügt. Falls Sie den Pfad des Bewertungsdatenordners geändert haben, überprüfen Sie, ob der in den Erweiterungseinstellungen angegebene aktuelle Bewertungspfad korrekt ist. Versuchen Sie, eine neue Bewertung zu erstellen, nachdem Sie geöffnete Bewertungsdateien geschlossen haben.
Fehlercode: FSMB-0001
Fehlermeldung: Fehler beim Zugriff auf Bewertungsdaten.
Mögliche Ursachen: Dieser Fehler kann aus einem der angegebenen Gründe auftreten:
Der oder die Benutzer*in verfügt möglicherweise nicht über die entsprechende Berechtigung für den Zugriff auf den Bewertungsdatenordner.
Der Bewertungsdatenordner ist nicht vorhanden oder wird von einem anderen Programm verwendet.
Korrekturaktionen: Sie müssen sicherstellen, dass der angemeldete Benutzer über Lese- und Schreibberechtigungen für den Bewertungsdatenordner verfügt. Falls Sie den Pfad des Bewertungsdatenordners geändert haben, überprüfen Sie, ob der in den Erweiterungseinstellungen angegebene aktuelle Bewertungspfad korrekt ist.
Fehlercode: FSMB-0002
Fehlermeldung: Fehler beim Parsen der Bewertungsdaten. Eine Metadatendatei ist entweder beschädigt oder wurde extern geändert. Versuchen Sie, eine neue Bewertung zu erstellen.
Mögliche Ursachen: Dieser Fehler kann aus einem der angegebenen Gründe auftreten:
Die Metadatendatei ist entweder beschädigt oder wurde extern geändert.
Es wird Unterstützung beim ordnungsgemäßen Parsen der JSON-Datei für die Metadatendatei benötigt.
Gegenmaßnahmen: Möglicherweise müssen Sie die aktuelle Bewertung löschen und dann versuchen, eine neue zu erstellen. Wenn das Problem weiterhin besteht, wenden Sie sich an Microsoft.
Fehlercode: FSMB-0003
Fehlermeldung: Fehler beim Speichern der Bewertungsausgabe mit einem Dateisystemfehler.
Mögliche Ursachen: Dieser Fehler kann aus einem der angegebenen Gründe auftreten:
Der Benutzer verfügt möglicherweise nicht über die geeignete Berechtigung für die Verwendung des Bewertungsdatenordners.
Der Bewertungsdatenordner wird bereits von einem anderen Programm verwendet.
Korrekturaktionen: Sie müssen sicherstellen, dass der angemeldete Benutzer über Lese- und Schreibberechtigungen für den Bewertungsdatenordner verfügt. Falls Sie den Pfad des Bewertungsdatenordners geändert haben, überprüfen Sie, ob der in den Erweiterungseinstellungen angegebene aktuelle Bewertungspfad korrekt und vorhanden ist. Versuchen Sie, eine neue Bewertung zu erstellen, nachdem Sie geöffnete Bewertungsdateien geschlossen haben.
Fehlercode: FSMB-0004
Fehlermeldung: Serialisierungsmodulfehler beim Speichern der Bewertungsausgabe
Mögliche Ursachen: Die generierten Bewertungsdaten konnten nicht in das JSON-Format konvertiert werden.
Gegenmaßnahmen: Sie können versuchen, eine neue Bewertung auszuführen. Um den Fehler weiter zu untersuchen, gehen Sie die Protokolle durch, um die Ursache zu ermitteln. Wenn das Problem weiterhin besteht, wenden Sie sich an Microsoft.
Fehlercode: MDS-0001
Fehlermeldung: Dateisystemfehler beim Lesen der Bewertungsdaten.
Mögliche Ursachen: Dieser Fehler kann aus einem der angegebenen Gründe auftreten:
Der oder die Benutzer*in verfügt möglicherweise nicht über die entsprechende Berechtigung für den Zugriff auf den Bewertungsdatenordner.
Der Bewertungsdatenordner ist nicht vorhanden oder wird von einem anderen Programm verwendet.
Korrekturaktionen: Sie müssen sicherstellen, dass der angemeldete Benutzer über Lese- und Schreibberechtigungen für den Bewertungsdatenordner verfügt. Falls Sie den Pfad des Bewertungsdatenordners geändert haben, überprüfen Sie, ob der in den Erweiterungseinstellungen angegebene aktuelle Bewertungspfad korrekt ist.
Fehlercode: MDS-0002
Fehlermeldung: Serialisierungsmodulfehler beim Lesen der Bewertungsdaten.
Mögliche Ursachen: Dieser Fehler kann aus einem der angegebenen Gründe auftreten:
Der oder die Benutzer*in verfügt möglicherweise nicht über die entsprechende Berechtigung für den Zugriff auf den Bewertungsdatenordner.
Der Bewertungsdatenordner ist nicht vorhanden oder wird von einem anderen Programm verwendet.
Die Bewertungsdaten wurden von einer älteren Version der Erweiterung generiert, die nicht mehr unterstützt wird.
Korrekturaktionen: Sie müssen sicherstellen, dass der angemeldete Benutzer über Lese- und Schreibberechtigungen für den Bewertungsdatenordner verfügt. Falls Sie den Pfad des Bewertungsdatenordners geändert haben, überprüfen Sie, ob der in den Erweiterungseinstellungen angegebene aktuelle Bewertungspfad korrekt ist. Versuchen Sie, die aktuelle Bewertung zu löschen, und führen Sie dann eine neue Bewertung aus.
Fehlercode: MDS-0003
Fehlermeldung: Unbekannter Fehler beim Speichern der Bewertungsausgabe.
Mögliche Ursachen: Dieser Fehler kann aus einem der angegebenen Gründe auftreten:
Der oder die Benutzer*in verfügt möglicherweise nicht über die entsprechende Berechtigung für den Zugriff auf den Ordner, der zum Speichern der Bewertung ausgewählt wurde.
Der Ordner wird bereits von einem anderen Programm verwendet.
Korrekturaktionen: Sie müssen sicherstellen, dass der angemeldete Benutzer über Lese- und Schreibberechtigungen für den Bewertungsdatenordner verfügt. Falls Sie den Pfad des Bewertungsdatenordners geändert haben, überprüfen Sie, ob der in den Erweiterungseinstellungen angegebene aktuelle Bewertungspfad korrekt ist. Versuchen Sie, eine neue Bewertung zu erstellen, nachdem Sie alle geöffneten Bewertungsdateien geschlossen haben.
Fehlercode: MDS-0004
Fehlermeldung: Serialisierungsmodulfehler beim Speichern der Bewertungsausgabe.
Mögliche Ursachen: Dieser Fehler kann aus einem der angegebenen Gründe auftreten:
Die Metadatendatei ist entweder beschädigt oder wurde extern geändert.
Es wird Unterstützung beim ordnungsgemäßen Parsen der JSON-Datei für die Metadatendatei benötigt.
Gegenmaßnahmen: Möglicherweise müssen Sie die aktuelle Bewertung löschen und dann versuchen, eine neue zu erstellen. Wenn das Problem weiterhin besteht, wenden Sie sich an Microsoft.
Fehlercode: FSRP-0000
Fehlermeldung: Terminalfehler beim Zugriff auf Lookupdaten Eine Nachschlagedatei ist entweder gelöscht oder beschädigt. Installieren Sie die Erweiterung neu, und versuchen Sie es erneut.
Mögliche Ursachen: Dieser Fehler kann aus einem der angegebenen Gründe auftreten:
Die Nachschlagemetadatendatei ist entweder gelöscht oder beschädigt.
Die Nachschlagemetadatendatei wird bereits von einem anderen Programm verwendet.
Gegenmaßnahmen: Versuchen Sie, die Erweiterung neu zu installieren, schließen Sie alle geöffneten Bewertungsdateien, und erstellen Sie dann eine neue Bewertung. Wenn das Problem weiterhin besteht, wenden Sie sich an Microsoft.
Fehlercode: FSRP-0001
Fehlermeldung: Terminalfehler beim Zugriff auf Lookupdaten Eine Nachschlagedatei ist entweder gelöscht oder beschädigt. Installieren Sie die Erweiterung neu, und versuchen Sie es erneut.
Mögliche Ursachen: Dieser Fehler kann aus einem der angegebenen Gründe auftreten:
Die Nachschlagemetadatendatei ist entweder gelöscht oder beschädigt.
Die Nachschlagemetadatendatei wird bereits von einem anderen Programm verwendet.
Gegenmaßnahmen: Versuchen Sie, die Erweiterung neu zu installieren, schließen Sie alle geöffneten Bewertungsdateien, und erstellen Sie dann eine neue Bewertung. Wenn das Problem weiterhin besteht, wenden Sie sich an Microsoft.
Fehlercode: GE-0001
Fehlermeldung: Unbekannter Fehler beim Ausführen von mindestens einer Bewertungskomponente
Mögliche Ursachen: Ein unbekannter interner Fehler ist aufgetreten.
Wartungsaktionen: Versuchen Sie, eine neue Bewertung zu erstellen. Um weitere Untersuchungen anzustellen, gehen Sie das Protokoll durch, um die Ursache des Fehlers zu verstehen. Wenn das Problem weiterhin besteht, wenden Sie sich an Microsoft.
Fehlercode: GE-1002
Fehlermeldung: Der konfigurierte Bewertungsordner ist nicht vorhanden.
Mögliche Ursachen: Der angegebene Bewertungsordnerpfad ist lokal nicht vorhanden.
Gegenmaßnahmen: Überprüfen Sie, ob der Pfad des Bewertungsordners auf dem lokalen Computer vorhanden ist. Falls Sie den Pfad des Bewertungsdatenordners geändert haben, überprüfen Sie, ob der in den Erweiterungseinstellungen angegebene aktuelle Bewertungspfad korrekt ist.
Fehlercode: PGSQLC-0000
Fehlermeldung: Unbekannter Fehler bei der Datensammlung. Versuchen Sie, eine neue Bewertung zu erstellen.
Mögliche Ursachen: Es handelt sich um einen allgemeinen Fehler, der aus mehreren Gründen auftreten kann.
Gegenmaßnahmen: Versuchen Sie, eine neue Bewertung zu erstellen. Um den Fehler weiter zu untersuchen, gehen Sie die Protokolle durch, um die Ursache zu ermitteln. Wenn das Problem weiterhin besteht, wenden Sie sich an Microsoft.
Fehlercode: PGSQLC-0001
Fehlermeldung: Unbekannter Fehler beim Sammeln von PostgreSQL-Serverkompatibilitätsdaten.
Mögliche Ursachen: Dieser Fehler tritt während der Sammlung von Serverkompatibilitätsdaten auf.
Gegenmaßnahmen: Um den Fehler weiter zu untersuchen, gehen Sie die Protokolle durch, um die Ursache zu ermitteln. Wenn das Problem weiterhin besteht, wenden Sie sich an Microsoft.
Fehlercode: PGSQLC-0002
Fehlermeldung: Unbekannter Fehler beim Sammeln von PostgreSQL-Datenbankkompatibilitätsdaten.
Mögliche Ursachen: Dieser Fehler tritt während der Sammlung von Datenbankkompatibilitätsdaten auf.
Gegenmaßnahmen: Um den Fehler weiter zu untersuchen, gehen Sie die Protokolle durch, um die Ursache zu ermitteln. Wenn das Problem weiterhin besteht, wenden Sie sich an Microsoft.
Fehlercode: PGSQLC-0003
Fehlermeldung: Fehler beim Verarbeiten der Leistungsdaten.
Mögliche Ursachen: Dieser Fehler ist während der Sammlung von PostgreSQL-Leistungsdaten aufgetreten.
Wartungsaktionen: Versuchen Sie, eine neue Bewertung zu erstellen. Um weitere Untersuchungen anzustellen, gehen Sie das Protokoll durch, um die Ursache des Fehlers zu verstehen. Wenn das Problem weiterhin besteht, wenden Sie sich an Microsoft.
Fehlercode: PGSQLA-1000
Fehlermeldung: Das Serverkompatibilitätsmodul für die Azure PostgreSQL-Zielplattform ist mit einem unbekannten Fehler fehlgeschlagen.
Mögliche Ursachen: Das Serverkompatibilitätsmodul konnte die Serverkompatibilitätsdaten nicht verarbeiten.
Wartungsaktionen: Versuchen Sie, eine neue Bewertung zu erstellen. Um den Fehler weiter zu untersuchen, gehen Sie die Protokolle durch, um die Ursache zu ermitteln. Wenn das Problem weiterhin besteht, wenden Sie sich an Microsoft.
Fehlercode: PGSQLA-2000
Fehlermeldung: Unbekannter Fehler in Datenbankkompatibilitätsdaten für die Azure PostgreSQL-Zielplattform.
Mögliche Ursachen: Das Datenbankkompatibilitätsmodul konnte die Datenbankkompatibilitätsdaten nicht verarbeiten.
Wartungsaktionen: Versuchen Sie, eine neue Bewertung zu erstellen. Um den Fehler weiter zu untersuchen, gehen Sie die Protokolle durch, um die Ursache zu ermitteln. Wenn das Problem weiterhin besteht, wenden Sie sich an Microsoft.
Fehlercode: PGSQLA-3001
Fehlermeldung: Bei der SKU-Empfehlung für die Azure PostgreSQL-Zielplattform ist ein unbekannter Fehler aufgetreten.
Mögliche Ursachen: Die SKU-Empfehlung konnte die Leistungsdaten nicht verarbeiten.
Gegenmaßnahmen: Versuchen Sie, eine neue Bewertung zu erstellen. Um den Fehler weiter zu untersuchen, gehen Sie die Protokolle durch, um die Ursache zu ermitteln. Wenn das Problem weiterhin besteht, wenden Sie sich an Microsoft.
Fehlercode: PGSQLDA-0001
Fehlermeldung: Unbekannter Fehler beim Aggregieren der gesammelten Leistungsdatendetails.
Mögliche Ursachen: Fehler beim Verarbeiten der Leistungsdaten.
Gegenmaßnahmen: Um den Fehler weiter zu untersuchen, gehen Sie die Protokolle durch, um die Ursache zu ermitteln. Wenden Sie sich an Microsoft, um Hilfe zu erhalten.
Fehlercode: PGDC-10000
Fehlermeldung: Fehler beim Sammeln erforderlicher Daten mit einem zugrunde liegenden PG-Fehler. Diesen Fehlercode finden Sie in der Postgres-Dokumentation.
Mögliche Ursachen: Fehler bei der Bewertung aufgrund eines zugrunde liegenden PostgreSQL-Fehlers.
Korrekturaktionen: Möglicherweise finden Sie die Lösung dieses Problems in der PG-Dokumentation. Wenn das Problem weiterhin besteht, wenden Sie sich an Microsoft.
Fehlercode: PGDC-10001
Fehlermeldung: Verbindung unterbrochen. Überprüfen Sie Ihre Netzwerkkonnektivität. Diesen Fehlercode finden Sie in der Postgres-Dokumentation.
Mögliche Ursachen: Fehler bei der Bewertung aufgrund eines Netzwerkkonnektivitätsproblems.
Korrekturaktionen: Möglicherweise finden Sie die Lösung dieses Problems in der PG-Dokumentation. Wenn das Problem weiterhin besteht, wenden Sie sich an Microsoft.
Fehlercode: PGDC-10002
Fehlermeldung: Timeout der Verbindung mit dem PostgreSQL-Server. Navigieren Sie zum Bereich „Verbindungen“, und aktualisieren Sie die Verbindung mit dem PostgreSQL-Server.
Mögliche Ursachen: Dieser Fehler kann aus einem der angegebenen Gründe auftreten:
Erzwungene Beendigung oder Timeout der PostgreSQL-Serververbindung.
Die Netzwerkkonnektivität mit dem PostgreSQL-Server ist instabil oder ging verloren.
Korrekturaktionen: Versuchen Sie, die Verbindung mit dem PostgreSQL-Server wiederherzustellen, oder aktualisieren Sie die Verbindung. Pingen Sie zudem den PostgreSQL-Server, um zu überprüfen, ob die Netzwerkkonnektivität zwischen Ihrem Computer und dem PostgreSQL-Server stabil ist. Überprüfen Sie, ob die Timeoutparameter in der Datei „postgresql.conf“ richtig festgelegt sind.
Fehlercode: PGDC-10003
Fehlermeldung: Anmeldefehler aufgrund ungültiger Anmeldeinformationen. Überprüfen Sie die Anmeldeinformationen für die Datenbank, und versuchen Sie es noch mal.
Mögliche Ursachen: Anmeldefehler könnten auf ungültige Anmeldeinformationen zurückzuführen sein.
Korrekturaktionen: Sie müssen sicherstellen, dass die angegebenen PostgreSQL-Serveranmeldeinformationen korrekt sind. Überprüfen Sie die Anmeldeinformationen für die Datenbank, und versuchen Sie es noch mal.
Fehlercode: PGDC-10004
Fehlermeldung: Der verbundene PostgreSQL-Server ist aufgrund einer zugrunde liegenden PG-Ausnahme nicht verfügbar.
Mögliche Ursachen: Die Datenbank ist möglicherweise ausgefallen oder nicht bereit, Verbindungen zu akzeptieren.
Gegenmaßnahmen: Überprüfen Sie, ob die Datenbank online ist, sich in einem fehlerfreien Zustand befindet und neue Verbindungen zulässt. Weitere Informationen finden Sie in der Postgres-Dokumentation.
Fehlercode: PGDC-10005
Fehlermeldung: Der Benutzer verfügt nicht über die Berechtigung für den Zugriff auf die Tabelle/Sicht für die Bewertung.
Mögliche Ursachen: Dieser Fehler kann aus einem der angegebenen Gründe auftreten:
Fehlende Connect-Berechtigung.
Fehlende Select-Berechtigung.
Korrekturaktionen: Erteilen Sie dem Bewertungsbenutzer die erforderliche Berechtigung. Wenn das Problem weiterhin besteht, wenden Sie sich an Microsoft.
Fehlercode: PGDC-10006
Fehlermeldung: Es ist kein solcher Host bekannt. Stellen Sie eine Verbindung mit einem gültigen Host her.
Mögliche Ursachen: Der Host ist ungültig. Entweder ist die IP-Adresse/der Hostname falsch, oder die Portnummer ist falsch.
Korrekturaktionen: Überprüfen Sie, ob Hostname und Portnummer korrekt sind. Wenn das Problem weiterhin besteht, wenden Sie sich an Microsoft.