Konvertierungsarbeitsbereich erstellen und Schema konvertieren

Auf dieser Seite wird beschrieben, wie Sie einen Konvertierungsarbeitsbereich erstellen und damit sofort eine deterministische Code- und Schemakonvertierung von Oracle zu PostgreSQL durchführen.

Sie haben zwei Möglichkeiten, interaktive Konvertierungsarbeitsbereiche zu erstellen:

  • Über eine direkte Datenbankverbindung: Database Migration Service stellt über ein Verbindungsprofil eine direkte Verbindung zu Ihrer laufenden Quelldatenbank her und ruft das Schema über eine Netzwerkverbindung ab.

  • Mit Schemadateien in Cloud Storage: Sie können Ihre Schemametadaten lokal mit von Google bereitgestellten Extraktionsskripts extrahieren, die resultierenden Dateien in einen Cloud Storage-Bucket hochladen und Ihren Arbeitsbereich vorbereiten, ohne eine Verbindung zur Quelldatenbank herzustellen.

Direkte Verbindung zur Quelldatenbank herstellen

Sie können einen interaktiven Konvertierungsarbeitsbereich erstellen und die Schemakonvertierung durchführen, indem Sie mit Database Migration Service direkt eine Verbindung zur Quelldatenbank herstellen. Bevor Sie den Arbeitsbereich auf diese Weise erstellen, müssen Sie ein Verbindungsprofil für Ihre Quelldatenbank erstellen.

Erforderliche Rollen für die direkte Verbindungsmethode

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Database Migration Admin (roles/datamigration.admin) für Ihr Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Erstellen eines Konvertierungsarbeitsbereichs benötigen.

Weitere Informationen zum Zuweisen von Rollen finden Sie in der Dokumentation zu Identity and Access Management unter Zugriff verwalten.

Diese vordefinierte Rolle enthält die Berechtigungen, die zum Erstellen eines Konvertierungsarbeitsbereichs in Database Migration Service erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen im Detail anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind erforderlich, um einen Konvertierungsarbeitsbereich in Database Migration Service zu erstellen:

  • cloudaicompanion.entitlements.get

    Diese Berechtigung ist in der Rolle roles/datamigration.admin enthalten. Sie ist für die durch Gemini verbesserten Conversion-Funktionen erforderlich.

  • datamigration.conversionworkspaces.apply
  • datamigration.conversionworkspaces.commit
  • datamigration.conversionworkspaces.convert
  • datamigration.conversionworkspaces.create
  • datamigration.conversionworkspaces.delete
  • datamigration.conversionworkspaces.get
  • datamigration.conversionworkspaces.getIamPolicy
  • datamigration.conversionworkspaces.list
  • datamigration.conversionworkspaces.rollback
  • datamigration.conversionworkspaces.seed
  • datamigration.conversionworkspaces.setIamPolicy
  • datamigration.conversionworkspaces.update

Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.

Konvertierungsarbeitsbereich mit einem Verbindungsprofil erstellen

So erstellen Sie einen Konvertierungsarbeitsbereich, in dem Database Migration Service eine Verbindung zu Ihrer Quelldatenbank herstellt und den ersten Snapshot Ihrer Quelldatenbankobjekte vorbereitet:

  1. Rufen Sie in der Google Cloud Console Konvertierungsarbeitsbereiche auf.

    Konvertierungsarbeitsbereiche aufrufen

  2. Klicken Sie auf Arbeitsbereich einrichten.
  3. Führen Sie auf der Seite Konvertierungsarbeitsbereich erstellen die folgenden Schritte aus:
    1. Geben Sie den Namen, die Kennung und die Region für den Konvertierungsarbeitsbereich ein.
    2. Wählen Sie im Drop-down-Menü Quelldatenbankmodul die Option Oracle aus.
    3. Wählen Sie unter Zieldatenbankmodul die Option Cloud SQL for PostgreSQL aus.

    4. Aktivieren Sie im Abschnitt Gemini-Einstellungen für Ihren Arbeitsbereich aktivieren die Kästchen, um die Gemini-basierten Konvertierungsfunktionen zu aktivieren. Sie können diese Funktionen auch später aktivieren, wenn Sie Code und Schema mit Gemini-Unterstützung konvertieren möchten.

      Für Gemini-basierte Konvertierungsfunktionen ist die Gemini for Google Cloud API erforderlich. Weitere Informationen finden Sie unter Gemini-basierte Konvertierungsfunktionen.

    5. Klicken Sie auf Arbeitsbereich erstellen und fortfahren.
  4. Führen Sie auf der Seite Quelle definieren und Schema-Snapshot abrufen die folgenden Schritte aus:
    1. Wählen Sie im Abschnitt Quellverbindungsmethode die Option Verbindungsprofil aus.
    2. Wählen Sie im Drop-down-Menü Quellverbindungsprofil das Verbindungsprofil für Ihre Quelldatenbank aus.
    3. Klicken Sie auf Schema-Snapshot abrufen und fortfahren.

    Database Migration Service stellt jetzt eine Verbindung zur Quelldatenbank her und ruft Ihr Schema ab. Dieser Vorgang kann einige Minuten dauern.

  5. Wählen Sie auf der Seite Objekte auswählen und konvertieren die Objekte aus, die Sie in die PostgreSQL-Syntax konvertieren möchten.

    Sie müssen nicht alle Objekte auf einmal konvertieren. Stattdessen können Sie jetzt nur einige Objekte auswählen und später weitere Objekte zur Konvertierung hinzufügen.

  6. Klicken Sie auf Konvertieren und fortfahren.

    Der Konvertierungsarbeitsbereich wird geöffnet.

  7. Wenn Sie zum ersten Mal einen neuen Arbeitsbereich öffnen, können Sie ein Upgrade durchführen, um auf die Gemini-basierte Funktion zur automatischen Konvertierung zuzugreifen. Gehen Sie dazu so vor:
    • Wählen Sie im Dialogfeld Einführung in die automatische Konvertierung von Gemini das Kästchen Arbeitsbereich upgraden, um die neue Funktion zu testen aus und klicken Sie auf Weiter.
    • Klicken Sie im Dialogfeld Quellobjekte mit Gemini konvertieren? auf Konvertieren.

      Database Migration Service führt den Konvertierungsprozess jetzt noch einmal aus, um die Gemini-basierten Konvertierungsverbesserungen zusätzlich zu den deterministischen Konvertierungsergebnissen anzuwenden. Weitere Informationen zur automatischen Konvertierung mit Gemini finden Sie unter Automatische Konvertierung mit Gemini.

In Cloud Storage gespeicherte Schemadateien verwenden

Sie können Ihre Schemametadaten lokal mit von Google bereitgestellten Extraktionsskripts extrahieren, die resultierenden Dateien in einen Cloud Storage-Bucket hochladen und Ihren Arbeitsbereich vorbereiten, ohne eine Verbindung zur Quelldatenbank herzustellen.

Erforderliche Rollen für die Verwendung der Schemadateien in Cloud Storage

Bitten Sie Ihren Administrator, die erforderlichen IAM-Rollen für Ihr Projekt für die folgenden am Migrationsprozess beteiligten Konten zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Erstellen eines Konvertierungsarbeitsbereichs mit in Cloud Storage gespeicherten Schemadateien benötigen:

  • Nutzerkonto, das den Konvertierungsarbeitsbereich erstellt: Database Migration Admin (roles/datamigration.admin)
  • Database Migration Service-Dienstkonto: Storage-Objekt-Betrachter (roles/storage.objectViewer) für den Cloud Storage-Bucket, in dem die Schemadateien gespeichert sind.

    Die E-Mail-Adresse des Database Migration Service-Dienstkontos hat das folgende Format: service-PROJECT_NUMBER@gcp-sa-datamigration.. Ersetzen Sie PROJECT_NUMBER durch die Projektnummer in Google Cloud . Weitere Informationen zu diesem Dienstkonto finden Sie unter Database Migration Service-Dienstkonto.

Weitere Informationen zum Zuweisen von Rollen finden Sie in der Dokumentation zu Identity and Access Management unter Zugriff verwalten.

Die vordefinierte Rolle roles/datamigration.admin enthält die Berechtigungen, die zum Erstellen eines Konvertierungsarbeitsbereichs in Database Migration Service erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen im Detail anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind erforderlich, um einen Konvertierungsarbeitsbereich in Database Migration Service zu erstellen:

  • cloudaicompanion.entitlements.get

    Diese Berechtigung ist in der Rolle roles/datamigration.admin enthalten. Sie ist für die durch Gemini verbesserten Conversion-Funktionen erforderlich.

  • datamigration.conversionworkspaces.apply
  • datamigration.conversionworkspaces.commit
  • datamigration.conversionworkspaces.convert
  • datamigration.conversionworkspaces.create
  • datamigration.conversionworkspaces.delete
  • datamigration.conversionworkspaces.get
  • datamigration.conversionworkspaces.getIamPolicy
  • datamigration.conversionworkspaces.list
  • datamigration.conversionworkspaces.rollback
  • datamigration.conversionworkspaces.seed
  • datamigration.conversionworkspaces.setIamPolicy
  • datamigration.conversionworkspaces.update

Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.

Konvertierungsarbeitsbereich mit Schemadateien erstellen

So erstellen Sie einen Konvertierungsarbeitsbereich mit Schemadateien:

  1. Rufen Sie die Python-Skripts aus der Google Cloud Console ab. Gehen Sie so vor:
    1. Rufen Sie in der Google Cloud Console Konvertierungsarbeitsbereiche auf.

      Konvertierungsarbeitsbereiche aufrufen

    2. Klicken Sie auf Arbeitsbereich einrichten.
    3. Auf der Seite Konvertierungsarbeitsbereich erstellen:
      1. Geben Sie den Namen, die Kennung und die Region des Arbeitsbereichs ein.
      2. Wählen Sie im Drop-down-Menü Quelldatenbankmodul die Option Oracle aus.
      3. Wählen Sie im Drop-down-Menü Zieldatenbankmodul die Option Cloud SQL for PostgreSQL aus.

      4. Aktivieren Sie im Bereich Gemini-Einstellungen für Ihren Arbeitsbereich aktivieren über die Kästchen die Gemini-basierten Konvertierungsfunktionen und klicken Sie auf Weiter.

        Sie können diese Funktionen auch später aktivieren, wenn Sie Code und Schema mit Unterstützung durch Gemini konvertieren möchten. Für Gemini-basierte Konvertierungsfunktionen ist die Gemini for Google Cloud API erforderlich. Weitere Informationen finden Sie unter Gemini-basierte Konvertierungsfunktionen.

    4. Wählen Sie auf der Seite Quelle definieren und Schema-Snapshot abrufen im Abschnitt Quellverbindungsmethode die Option Cloud Storage aus.
    5. Klicken Sie im Abschnitt Vor der Auswahl eines Ordners neben der Überschrift Oracle-Metadatenextraktor auf Öffnen. Folgen Sie der Anleitung in der Seitenleiste, um das Extraktionsdienstprogramm herunterzuladen und für Ihre Quelldatenbank auszuführen, um die JSON-Dateien mit den Schemametadaten zu erstellen. Für dieses Dienstprogramm müssen Sie eine Netzwerkverbindung zu Ihrer Quelldatenbank herstellen können.
  2. Erstellen Sie einen dedizierten Cloud Storage-Bucket, in den Sie die JSON-Dateien mit den Schemametadaten hochladen. Weitere Informationen zum Erstellen von Cloud Storage-Buckets finden Sie in der Cloud Storage-Dokumentation unter Buckets erstellen.
  3. Erstellen Sie im dedizierten Cloud Storage-Bucket einen leeren, dedizierten Ordner für die Datenbankschemadateien, die Sie in den vorherigen Schritten exportiert haben. Weitere Informationen zum Erstellen von Cloud Storage-Ordnern finden Sie in der Cloud Storage-Dokumentation unter Ordner erstellen und verwalten.
  4. Laden Sie nur die JSON-Schemadateien für Metadaten, die Sie mit den Python-Skripts erstellt haben, die Sie in den vorherigen Schritten aus der Google Cloud Console abgerufen haben, in den leeren, dedizierten Datenbankordner in Ihrem Cloud Storage-Bucket hoch.
  5. Erstellen Sie Ihren Arbeitsbereich in der Google Cloud Console weiter oder erstellen Sie einen neuen mit der Google Cloud CLI.

    Console

    1. Nachdem Sie die extrahierten Schemametadatendateien in einen Cloud Storage-Bucket hochgeladen haben, fahren Sie auf der Seite Quelle definieren und Schema-Snapshot abrufen fort.
    2. Klicken Sie im Feld Ordner auf Durchsuchen und wählen Sie den Ordner aus, der Ihre Schemadateien enthält.
    3. Klicken Sie auf Schema-Snapshot abrufen und fortfahren.

      Database Migration Service parst jetzt die Schemametadaten aus dem Bucket.

    4. Wählen Sie auf der Seite Objekte auswählen und konvertieren die Objekte aus, die Sie konvertieren möchten, und klicken Sie auf Konvertieren und fortfahren.

    gcloud

    Nachdem Sie die extrahierten Schemametadatendateien in einen Cloud Storage-Bucket hochgeladen haben, können Sie mit der Google Cloud CLI einen neuen Arbeitsbereich erstellen und initialisieren. Gehen Sie so vor:

    1. Leeren Konvertierungsarbeitsbereich erstellen
      Führen Sie den folgenden Befehl aus (zum Maximieren klicken):

      gcloud database-migration conversion-workspaces create

        gcloud database-migration conversion-workspaces create WORKSPACE_ID \
      --region=REGION \
      --source-database-engine=ORACLE \
      --destination-database-engine=POSTGRESQL

      Ersetzen Sie Folgendes:

      • WORKSPACE_ID: Die Kennung für Ihren Konvertierungsarbeitsbereich.
      • REGION: Die Region, in der Sie den Arbeitsbereich erstellen möchten.

    2. Arbeitsbereich mit Ihren Schemadateien in Cloud Storage initialisieren.
      Führen Sie den folgenden Befehl aus, um die in Ihrem Bucket gespeicherten Schemametadatendateien zu parsen und in den Konvertierungsarbeitsbereich zu laden (zum Maximieren klicken):

      gcloud database-migration conversion-workspaces seed

        gcloud database-migration conversion-workspaces seed WORKSPACE_ID \
      --region=REGION \
      --gcs-path=gs://BUCKET_NAME/PREFIX/

      Ersetzen Sie Folgendes:

      • WORKSPACE_ID: Die Kennung für Ihren Konvertierungsarbeitsbereich.
      • REGION: Die Region, in der Sie den Arbeitsbereich erstellen möchten.
      • BUCKET_NAME: Der Name des Cloud Storage-Bucket, der Ihre Schemadateien enthält.
      • PREFIX: Der Pfad zum Ordner mit den extrahierten Schemametadatendateien.

Legacy-Konvertierungsarbeitsbereiche

Legacy-Konvertierungsarbeitsbereiche sind eine ältere, eingeschränktere Art von Konvertierungsarbeitsbereichen. Wir raten davon ab, für Ihre Migrationen den alten Typ von Conversion-Arbeitsbereichen zu verwenden. Wenn Sie einen Legacy-Konvertierungsarbeitsbereich verwenden müssen, maximieren Sie den Abschnitt Legacy-Konvertierungsarbeitsbereich erstellen und Schema konvertieren, um weitere Informationen zu erhalten.

Legacy-Konvertierungsarbeitsbereich erstellen und Schema konvertieren

In Legacy-Konvertierungsarbeitsbereichen werden Ora2Pg-Konfigurationsdateien verwendet. Bevor Sie einen Legacy-Konvertierungsarbeitsbereich erstellen, müssen Sie zuerst Ihre Ora2Pg-Konfiguration außerhalb von Database Migration Service erstellen. Weitere Informationen finden Sie unter Mit Legacy-Konvertierungsarbeitsbereichen arbeiten.

  1. Rufen Sie in der Google Cloud Console Konvertierungsarbeitsbereiche auf.

    Konvertierungsarbeitsbereiche aufrufen

  2. Klicken Sie auf Arbeitsbereich einrichten.
  3. Führen Sie auf der Seite Konvertierungsarbeitsbereich erstellen die folgenden Schritte aus:
    1. Geben Sie den Namen, die Kennung und die Region für den Konvertierungsarbeitsbereich ein.
    2. Wählen Sie im Drop-down-Menü Quelldatenbankmodul die Option Oracle aus.
    3. Wählen Sie unter Zieldatenbankmodul die Option Cloud SQL for PostgreSQL aus.
    4. Maximieren Sie den Bereich Arbeitsbereichskonfigurationen anpassen und klicken Sie das Kästchen Legacy-Konvertierungsarbeitsbereich aktivieren an.
    5. Klicken Sie auf Arbeitsbereich erstellen und fortfahren.
  4. Führen Sie auf der Seite Mit Quelle verbinden und Objekte konvertieren die folgenden Schritte aus:
    1. Wählen Sie im Drop-down-Menü Quellverbindungsprofil das Verbindungsprofil für Ihre Quelldatenbank aus.

    2. Klicken Sie im Feld Konfigurationsdatei auf Durchsuchen und wählen Sie mit der Dateiauswahl des Systems Ihre Konvertierungszuordnungsdatei aus.

      Sie können mehrere Dateien für die Conversion-Zuordnung hochladen, indem Sie auf Datei hinzufügen klicken.

    3. Klicken Sie im Abschnitt Konfiguration konvertieren auf Schema abrufen und konvertieren.

      Database Migration Service stellt jetzt eine Verbindung zur Quelldatenbank her, ruft Ihr Schema ab und konvertiert es gemäß den in Ihrer Konvertierungszuordnungsdatei definierten Regeln in das SQL-Zielschema. Dieser Vorgang kann einige Minuten dauern.

  5. Klicken Sie auf Speichern und schließen.

    Die Detailseite des Konvertierungsarbeitsbereichs wird geöffnet.

Sie können das konvertierte Schema jetzt auf Ihre Zieldatenbank anwenden. Wenn Ihre Quelldatenbank Tabellen ohne Primärschlüssel enthält, müssen Sie nach dem Anwenden des konvertierten Schemas auch manuell Primärschlüssel-Einschränkungen in den konvertierten Tabellen in der Zieldatenbank erstellen. Weitere Informationen finden Sie unter Mit Legacy-Konvertierungsarbeitsbereichen arbeiten.

Nächste Schritte

Sie können jetzt mit Ihrem Konvertierungsarbeitsbereich arbeiten, um Konvertierungsprobleme zu beheben, Ihre Objekte mit dem interaktiven Editor zu ändern und das konvertierte Schema auf Ihre Zieldatenbank anzuwenden. Weitere Informationen finden Sie unter Oracle-Code und -Schema in PostgreSQL-Syntax konvertieren.