Schema-Konvertierungsberichte für die Konvertierung von Oracle zu Azure Database for PostgreSQL Flexible Server

Das Oracle to Azure Database for PostgreSQL Schema conversion feature generiert mehrere Artefakte in zwei Phasen: extraction und conversion. Diese Artefakte helfen Ihnen, den Bereich zu überprüfen, Konvertierungsergebnisse zu verstehen und Probleme zu beheben. Jede Phase erzeugt strukturierte Berichte, unterstützende CSV-Dateien und Laufzeitprotokolldateien. Überprüfen Sie zuerst die Extraktionsartefakte und gehen Sie dann die Konvertierungsartefakte durch, bevor Sie das konvertierte Schema für Ihr Produktionsziel freigeben.

Extraktionsartefakte

Die Extraktionsphase wird zuerst ausgeführt, wenn das Tool eine Verbindung mit der Oracle-Quelle herstellt und Schemaobjekte ermittelt. Das Tool generiert die folgenden Artefakte, bevor die KI-gesteuerte Konvertierung beginnt. Verwenden Sie sie, um die Konnektivität zu überprüfen, den Bereich zu bestätigen und Objekte zu identifizieren, die eine manuelle Planung benötigen.

Oracle-Extraktionsbericht

Der Oracle-Extraktionsbericht fasst zusammen, was das Tool auf dem Quellsystem ermittelt hat. Verwenden Sie sie, um die Konnektivität zu überprüfen und zu bestätigen, dass jedes Objekt, das Sie migrieren möchten, gefunden wurde.

Der Bericht enthält Folgendes:

  • Details und Version der Oracle-Instanzverbindung.
  • Schemazusammenfassung mit Objektanzahl und Extraktionserfolgsrate.
  • Aufschlüsselung des Objekttyps. Beispielsweise Tabellen, Indizes, Ansichten, Prozeduren, Pakete, Funktionen, Trigger und Sequenzen.
  • Verarbeitungszeit und alle Extraktionsfehler.

Screenshot des Oracle-Extraktionsberichts.

Ausgeschlossene Objekte

Die excluded_objects.csv Datei listet Oracle-Objekte auf, die das Tool absichtlich von der Extraktion ausgeschlossen hat. Beispielsweise werden Wrapped PL/SQL, System-Event-Trigger, Java in der Datenbank und andere Kategorien absichtlich nicht extrahiert. Jede Zeile identifiziert das Schema, den Objekttyp, den Objektnamen und den Grund für den Ausschluss.

Verwenden Sie diese Datei, um manuelle Korrekturen oder Umformungen für jedes Objekt zu planen, das das Tool übersprungen hat. Die vollständige Liste der Kategorien, die systembedingt übersprungen werden, finden Sie unter Einschränkungen bei der Oracle-zu-Azure Database for PostgreSQL-Schemakonvertierung.

Nicht unterstützte Typen

Die unsupported_types.csv-Datei listet Oracle-Datentypen oder -Konstrukte auf, auf die das Tool gestoßen ist, die jedoch nicht für die automatisierte Konvertierung unterstützt werden. Jede Zeile identifiziert das Schema, das Objekt und die Spalte oder das Argument, in dem der Typ verwendet wurde, und den Quelldatentyp.

Verwenden Sie diese Datei, um den Umfang der manuellen Behebung festzulegen. Entscheiden Sie, ob jedes Vorkommen einem PostgreSQL-nativen Typ zugeordnet, das Quellobjekt umgestalten oder aus dem Migrationsbereich entfernt werden soll.

Extraktionsprotokoll

In diesem Protokoll werden detaillierte Laufzeitereignisse aus der Extraktionsphase erfasst. Lesen Sie das Protokoll, um Konnektivitätsfehler, fehlende Berechtigungen, Drosselungen oder unerwartete Ausschlüsse zu beheben, wenn der Extraktionsbericht nicht vollständig erklärt, was passiert ist.

Blockierungsartefakte

Nach Abschluss der Extraktion gruppiert das Tool die extrahierten Oracle-Objekte in abhängigkeitsfähige Batches, die als Blöcke bezeichnet werden. Die Aufteilung in Blöcke sorgt dafür, dass jeder Aufruf an Microsoft Foundry innerhalb des TPM-Grenzwerts der Bereitstellung bleibt und die Objektabhängigkeiten während der Konvertierung erhalten bleiben.

Bericht zur Blockgenerierung

In chunk_generation_report.md der Datei wird beschrieben, wie das Tool die extrahierten Objekte in Blöcke gruppiert hat. Verwenden Sie sie, um vor der Ausführung der Konvertierung die Chunk-Größe, die Objektverteilung und die Reihenfolge der Abhängigkeiten zu verstehen oder um zu untersuchen, warum ein bestimmtes Objekt in einem bestimmten Chunk gelandet ist.

Der Bericht enthält Folgendes:

  • Gesamtmenge der generierten Blöcke und der Objekte in den einzelnen Blöcken.
  • Objektverteilung nach Schema und Objekttyp.
  • Abhängigkeitsbeziehungen, die die Blöcke beeinflusst haben.
  • Details zur Token-Planung pro Block.

Konvertierungsartefakte

Die Konvertierungsphase läuft nach der Blockierungsphase. Microsoft Foundry verarbeitet jeweils einen Block, sodass er innerhalb des TPM-Grenzwerts (Deployment Token-per-Minute) bleibt. Das Tool generiert die folgenden Artefakte während und nach der Konvertierungsphase. Verwenden Sie sie, um Konvertierungsergebnisse zu überprüfen, Überprüfungsaufgaben aufzulösen und die Bereitstellung zu planen.

Konvertierungsbericht pro Chunk

Für jeden Chunk generiert das Tool einen Konvertierungsbericht. Dieser Bericht erfasst die in diesem Abschnitt verarbeiteten Objekte, das Konvertierungsergebnis und alle ausgelösten Überprüfungsaufgaben.

Verwenden Sie die Berichte pro Block, um das Verhalten eines bestimmten Batches zu untersuchen, Überprüfungsaufgaben mit dem Abschnitt zu korrelieren, in dem sie erstellt wurden, oder führen Sie einen einzelnen Block erneut aus, wenn Sie die Quell- oder Zielkonfiguration anpassen.

Bericht zur technischen Konvertierung

In diesem detaillierten technischen Bericht zum Objekt wird der gesamte Konvertierungslauf behandelt. Es erfasst Quell-zu-Ziel-Zuordnungen, Datentyp- und KI-angewendete Transformationen, Konvertierungswarnungen und den Speicherort der generierten PostgreSQL-Dateien.

Verwenden Sie diesen Bericht, wenn Sie KI-generierten Code überprüfen, eine bestimmte Überprüfungsaufgabe untersuchen oder einen Überwachungspfad für eine regulierte Migration erstellen.

Kundenzusammenfassungsbericht

Die customer_summary.md Datei ist die für Führungskräfte aufbereitete Readiness-Zusammenfassung, die die Ergebnisse über alle Blöcke hinweg bündelt. Öffnen Sie diesen Bericht zuerst nach Abschluss der Konvertierung. Verwenden Sie sie, um die Gesamtkonvertierungsergebnisse zu überprüfen, die Bereitstellung zu planen und die manuellen Aufgaben zu finden, die Ihre Aufmerksamkeit erfordern.

Der Bericht enthält Folgendes:

  • Konvertierungsstatistiken und Erfolgsquote.
  • Objekt-nach-Objekt-Zuordnung von Oracle zu PostgreSQL.
  • Details zur Datentyptransformation.
  • Anzahl der Überprüfungsaufgaben nach Kritikalität.
  • Bereitstellungsanweisungen und Dateiverweise.
  • Leistungsempfehlungen und bekannte Einschränkungen.

Screenshot des Kundenzusammenfassungsberichts.

Bericht zu Prüfaufgaben

Die Datei review_tasks.md entspricht den im Bereich Schema Review der Visual Studio Code PostgreSQL-Erweiterung angezeigten Prüfaufgaben. Verwenden Sie sie als Offline-Referenz, für Prüfprotokolle oder zum Teilen einer Momentaufnahme ausstehender und erledigter Aufgaben mit Beteiligten, die die Erweiterung nicht installiert haben. Um Aufgaben zu triagen und aufzulösen, verwenden Sie den Bereich Schema Review im Visual Studio Code. Einzelheiten finden Sie unter Aufgaben und Ausgabeordner zur Schemakonvertierung von Oracle zu Azure Database for PostgreSQL überprüfen.

Konvertierungsprotokoll

In diesem Protokoll werden detaillierte Laufzeitereignisse aus der Konvertierungsphase erfasst. Ziehen Sie das Protokoll zur Fehlerbehebung bei Microsoft Foundry-Drosselung, Blockierungen durch Inhaltsfilter, Validierungsfehlern der Scratch-Datenbank oder Fehlern auf Block-Ebene heran, die in den blockbezogenen Berichten oder im Zusammenfassungsbericht nicht vollständig erläutert werden.

Die Berichte verwenden

Überprüfen Sie die Artefakte in der folgenden Reihenfolge:

  1. Öffnen Sie den Oracle-Extraktionsbericht und excluded_objects.csvunsupported_types.csv zuerst. Vergewissern Sie sich, dass alle erwarteten Schemas und Objekttypen ermittelt wurden, und entscheiden Sie, wie jedes ausgeschlossene Objekt und jeder nicht unterstützte Typ behandelt werden, bevor Sie mit der Konvertierung beginnen.
  2. Öffnen Sie den Bericht zur Blockgenerierung , um zu bestätigen, dass die erwarteten Objekte in Blöcke gruppiert wurden.
  3. Öffnen Sie nach Abschluss der Konvertierung den Zusammenfassenden Bericht des Kunden , um die Gesamtergebnisse zu überprüfen und die Elemente zu finden, die Ihre Aufmerksamkeit benötigen.
  4. Sichten und beheben Sie Überprüfungsaufgaben im Bereich Schemaüberprüfung der PostgreSQL-Erweiterung für Visual Studio Code. Ausführliche Informationen zur Benutzeroberfläche, zu den Kritikalitätsstufen und zum Lösungsworkflow finden Sie unter Prüfen von Aufgaben und Ausgabeordnern für die Schemakonvertierung von Oracle zu Azure Database for PostgreSQL.
  5. Verwenden Sie die blockbezogenen Berichte und Berichte zur technischen Konvertierung, um Details zu einzelnen Objekten, Zuordnungen oder Warnungen anzuzeigen.
  6. Wenn die Extraktion oder Konvertierung fehlschlägt, lesen Sie das Extraktionsprotokoll und das Konvertierungsprotokoll , um die Ursache zu diagnostizieren.

Verwandte Inhalte

  • Last updated on