Schnellstartmigrationen mit Database Migration Service verwenden

MySQL | PostgreSQL | SQL Server

Auf dieser Seite wird beschrieben, wie Sie Schnellstart-Migrationen für homogene PostgreSQL-Migrationen zu Cloud SQL for PostgreSQL ausführen.

Übersicht

Schnellstart-Migrationen sind ein einfacher kontinuierlicher Migrationsablauf für homogene PostgreSQL-Szenarien. Bei Schnellstartmigrationen kann Database Migration Service automatisch alles einrichten, was Sie zum Migrieren Ihrer Datenbanken benötigen: Netzwerkkomponenten (Netzwerk-Attachments, Subnetze, Konfigurationen für private Verbindungen), Verbindungsprofile und Migrationsjobs.

Bei Schnellstart-Migrationen können Sie Ihre Daten in eine vorhandene Cloud SQL for PostgreSQL-Instanz verschieben oder beim Konfigurieren der Migration eine neue Instanz erstellen. Schnellstart-Migrationen eignen sich am besten für:

Einfache Migrationen, bei denen Sie keine genaue Kontrolle über die Parallelitätseinstellungen für Datendumps benötigen.
Migrieren Sie Ihre Datenbank von einem Google Cloud Projekt in ein anderes. Wenn Sie eine Schnellstartmigration konfigurieren, können Sie die Zielinstanz in einem anderen Projekt als die Quelle erstellen und Database Migration Service so einrichten, dass der Netzwerkanhang und das Subnetz im VPC-Netzwerk (Virtual Private Cloud) eines anderen Projekts erstellt werden.
Migration von Quellen mit einer privaten IP-Adresse in Ihrem VPC-Netzwerk (Virtual Private Cloud), z. B. selbstverwaltete Datenbanken in Compute Engine oder Cloud SQL for PostgreSQL-Instanzen, die für private Netzwerke aktiviert sind. Google Cloud

Für Quellen, die außerhalb von Google Cloud gehostet werden, sind möglicherweise zusätzliche Netzwerkkomponenten (z. B. eine Cloud VPN-Verbindung) erforderlich, damit sie über eine private IP-Adresse in Ihrem VPC-Netzwerk erreicht werden können.
Die einzige unterstützte Methode für die Datenbankverbindung sind Private Service Connect-Schnittstellen mit Konfigurationen für private Verbindungen von Database Migration Service. Ihrer Quelldatenbank muss im VPC-Netzwerk eine private IP-Adresse zugewiesen sein. Andere homogene Methoden für die Quellverbindung (z. B. Zulassungslisten für öffentliche IP-Adressen, umgekehrte SSH-Tunnel oder VPC-Peering) werden für Schnellstartmigrationen nicht unterstützt.

Weitere Informationen zu Schnellstart-Migrationen finden Sie in der Dokumentation zum Database Migration Service unter Schnellstart-Migrationen.

Hinweis

Prüfen Sie, ob Schnellstart-Migrationen Ihr Szenario vollständig unterstützen können. Weitere Informationen finden Sie in der Database Migration Service-Dokumentation unter Einschränkungen für die Schnellstartmigration.

Melden Sie sich in Ihrem Google-Konto an.

Wenn Sie noch kein Konto haben, melden Sie sich hier für ein neues Konto an.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Aktivieren Sie die Database Migration Service API, die Compute Engine API, die Network Connectivity Center API und die Cloud SQL Admin API.
APIs aktivieren

Erforderliche Rollen

Wenn Sie die Berechtigungen benötigen, um Schnellstartmigrationen zu Cloud SQL for PostgreSQL mit Database Migration Service auszuführen, bitten Sie Ihren Administrator, die erforderlichen IAM-Rollen (Identity and Access Management) für die an der Migration beteiligten Konten in den entsprechenden Projekten zuzuweisen. Weitere Informationen zum Zuweisen von Rollen finden Sie in der IAM-Dokumentation unter Zugriff verwalten.

Rollen und Berechtigungen im Quellprojekt

Weisen Sie bestimmten Konten im Projekt Google Cloud , in dem sich Ihre Quelldatenbank befindet, die folgenden Rollen zu:

Für das Nutzerkonto, mit dem die Migration durchgeführt wird: Compute-Netzwerkadministrator (roles/compute.networkAdmin)
Für das Database Migration Service-Dienstkonto des Zielprojekts: Compute-Netzwerkbetrachter(roles/compute.networkViewer)
Das Dienstkonto für Database Migration Service wird erstellt, wenn Sie die Database Migration Service API aktivieren. Die mit diesem Konto verknüpfte E‑Mail-Adresse wird automatisch generiert und kann nicht geändert werden. Diese E-Mail-Adresse hat das folgende Format:
```
service-DESTINATION_PROJECT_NUMBER@gcp-sa-datamigration.iam.gserviceaccount.com
```

Diese vordefinierten Rollen enthalten die Berechtigungen, die zum Einrichten der Konnektivität für Ihr Quelldatenbankprojekt im Rahmen einer Schnellstartmigration mit Database Migration Service erforderlich sind. Erweitern Sie den Abschnitt Erforderliche Berechtigungen (Quelle), um die erforderlichen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen (Quelle)

Die folgenden Berechtigungen sind erforderlich, um homogene Schnellstartmigrationen mit Database Migration Service durchzuführen:

Für das Nutzerkonto, mit dem die Migration durchgeführt wird:

compute.networks.*
compute.subnetworks.*
compute.networkAttachments.*

Für das Database Migration Service-Dienstkonto des Zielprojekts: compute.networkAttachments.get.

Rollen und Berechtigungen im Zielprojekt

Weisen Sie dem Nutzerkonto, das die Migration durchführt, die folgenden Rollen für das Google Cloud -Projekt zu, in dem sich Ihre Zieldatenbank befindet:

Administrator für die Datenbankmigration (roles/datamigration.admin)
Cloud SQL-Administrator (roles/cloudsql.admin)

Diese vordefinierten Rollen enthalten die Berechtigungen, die zum Einrichten der erforderlichen Migrationskomponenten in Ihrem Ziel-Datenbankprojekt im Rahmen einer Schnellstartmigration mit Database Migration Service erforderlich sind. Erweitern Sie den Abschnitt Erforderliche Berechtigungen (Ziel), um die erforderlichen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen (Ziel)

Die folgenden Berechtigungen sind erforderlich, um homogene Schnellstartmigrationen mit Database Migration Service durchzuführen:

datamigration.*
cloudsql.instances.create
cloudsql.instances.delete
cloudsql.instances.get
cloudsql.instances.list
cloudsql.instances.update
cloudsql.instances.connect
cloudsql.instances.executeSql
cloudsql.instances.export
cloudsql.instances.import
cloudsql.instances.login
cloudsql.operations.get
cloudsql.users.get
cloudsql.users.list
cloudsql.users.create
cloudsql.users.update
cloudsql.users.delete

Quelldatenbank konfigurieren

So konfigurieren Sie die PostgreSQL-Quelldatenbank:

Erstellen Sie in Ihrer Instanz ein dediziertes Nutzerkonto für die Migration.
- Informationen zu Cloud SQL for PostgreSQL-Quellen finden Sie in der Cloud SQL for PostgreSQL-Dokumentation unter Nutzer erstellen.
- Informationen zu anderen Quellen finden Sie in der Dokumentation Ihres Datenbankanbieters oder in der PostgreSQL-Dokumentation unter Nutzer erstellen und verwalten.
Weisen Sie dem dedizierten Migrationsnutzerkonto die erforderlichen Berechtigungen zu. Führen Sie die folgenden Befehle für jede Datenbank aus, die Sie migrieren möchten:
```
-- Grant the REPLICATION attribute
ALTER ROLE MIGRATION_USER REPLICATION;

-- Grant database-level permissions.
-- Repeat for each database you want to migrate.
GRANT CONNECT, CREATE ON DATABASE DATABASE_NAME TO MIGRATION_USER;

-- Grant schema-level usage.
-- Repeat for each schema in each database you want to migrate.
GRANT USAGE ON SCHEMA SCHEMA_NAME TO MIGRATION_USER;
```
Ersetzen Sie Folgendes:
- MIGRATION_USER durch den Namen des Migrationsnutzerkontos.
- Ersetzen Sie DATABASE_NAME durch den Namen der Datenbank, die Sie migrieren möchten.
- Ersetzen Sie SCHEMA_NAME durch den Namen des Schemas in der Datenbank, die Sie migrieren möchten.
Das Migrationsnutzerkonto muss Inhaberzugriff auf die Tabellen haben, die Sie migrieren. Führen Sie einen der folgenden Schritte aus, um diese Zugriffsebene zu gewähren:
- Weisen Sie dem Migrationskonto die PostgreSQL-Rolle SUPERUSER zu.
  - Weisen Sie für Cloud SQL for PostgreSQL-Quellen die Rolle cloudsqlsuperuser zu.
  - Weisen Sie für andere Quellen die Rolle SUPERUSER zu oder sehen Sie in der Dokumentation Ihres Datenbankanbieters nach einer entsprechenden Berechtigungsgruppe.
- Fügen Sie das Migrationsnutzerkonto der Nutzergruppe hinzu, zu der die Tabellen gehören. Führen Sie dazu diesen Befehl aus:
```
-- Grant table ownership.
GRANT TABLE_OWNER_GROUP_NAME TO MIGRATION_USER;
```
  Ersetzen Sie Folgendes:
  - TABLE_OWNER_GROUP_NAME durch den Namen der Nutzergruppe, zu der jede Tabelle gehört, die Sie migrieren möchten.
  - MIGRATION_USER durch den Namen des Migrationsnutzerkontos.
Bei Tabellen ohne Primärschlüssel: Database Migration Service repliziert während der CDC-Phase (Change Data Capture) keine UPDATE- oder DELETE-Vorgänge für Tabellen ohne Primärschlüssel. Wenn Sie solche Vorgänge in Ihre Replikation einbeziehen möchten, ändern Sie Tabellen ohne Primärschlüssel mit REPLICA IDENTITY:
```
ALTER TABLE TABLE_NAME REPLICA IDENTITY FULL;
ALTER TABLE TABLE_NAME REPLICA IDENTITY USING INDEX INDEX_NAME;
```
Ersetzen Sie Folgendes:
- TABLE_NAME ist der Name der Tabelle ohne Primärschlüssel.
- INDEX_NAME ist der eindeutige Index, mit dem Zeilen aus Tabellen ohne Primärschlüssel verfolgt werden können.
Konfigurieren Sie die Replikationseinstellungen mit Datenbank-Flags.
Selbstverwaltete Quellen

Wenn Sie Änderungen an Datenbank-Flags speichern, ist ein vollständiger Neustart der Datenbank erforderlich. In den folgenden Beispielen werden SQL-Abfragen zum Ändern von Flag-Werten verwendet. Wenn Sie SQL-Abfragen nicht direkt ausführen können, finden Sie in der Dokumentation Ihres Anbieters eine Anleitung zum Ändern dieser Flags.
1. Setzen Sie den Parameter wal_level auf logical. Führen Sie dazu diesen Befehl aus:
  ALTER SYSTEM SET wal_level = 'logical';
2. Setzen Sie den Parameter wal_sender_timeout auf 0. Dieser Wert deaktiviert das Zeitlimit, das zum Beenden inaktiver Replikationsverbindungen verwendet wird. Führen Sie dazu diesen Befehl aus:
  ALTER SYSTEM SET wal_sender_timeout = 0;
3. Konfigurieren Sie die maximale Anzahl von Replikations-Slots mit dem Parameter max_replication_slots. Dieser Parameter muss mindestens auf die Anzahl der Datenbanken festgelegt werden, die Sie pro Migrationsjob migrieren, zuzüglich einiger Reserven für die Tabellensynchronisierung.
  Wenn Sie beispielsweise 5 Datenbanken migrieren und 2 Migrationsjobs für die Quellinstanz erstellt werden, muss die Anzahl der Replikations-Slots mindestens 5 * 2 = 10 betragen, zuzüglich der Anzahl der Replikations-Slots, die Sie bereits verwenden.
  
  Führen Sie den folgenden Befehl aus, um diesen Parameter festzulegen:
  
  ALTER SYSTEM SET max_replication_slots = NUMBER_OF_SLOTS;
  Dabei steht NUMBER_OF_SLOTS für die maximale Anzahl von Replikations-Slots.
4. Konfigurieren Sie den Parameter max_wal_senders auf mindestens denselben Wert wie max_replication_slots, zuzüglich der Anzahl der Absender, die bereits auf Ihrer Instanz verwendet werden.
  Wenn für den Parameter max_replication_slots beispielsweise der Wert 10 festgelegt ist und Sie bereits zwei Absender verwenden, beträgt die Anzahl der gleichzeitig ausgeführten WAL-Senderprozesse 10 + 2 = 12.
  
  Führen Sie den folgenden Befehl aus, um diesen Parameter festzulegen:
  
  ALTER SYSTEM SET max_wal_senders = NUMBER_OF_SENDERS;
  Dabei steht NUMBER_OF_SENDERS für die Anzahl der gleichzeitig ausgeführten WAL-Senderprozesse.
5. Legen Sie max_worker_processes auf mindestens die Anzahl der Datenbanken fest, die Sie migrieren möchten, plus die Anzahl der max_worker_processes, die bereits auf Ihrer Instanz verwendet werden. Führen Sie den folgenden Befehl aus, um diesen Parameter festzulegen:
  ALTER SYSTEM SET max_worker_processes = NUMBER_OF_PROCESSES;
  Dabei steht NUMBER_OF_PROCESSES für die Anzahl der Datenbanken, die migriert werden.
Cloud SQL for PostgreSQL-Quellen

Bei Cloud SQL-Quellen konfigurieren Sie Datenbank-Flags in der Google Cloud -Konsole. Sie müssen die Instanz neu starten, damit die Änderungen an den Datenbankkennzeichnungen wirksam werden. Weitere Informationen zum Festlegen von Datenbank-Flags in Cloud SQL finden Sie in der Cloud SQL-Dokumentation unter Datenbank-Flags konfigurieren.
1. Legen Sie das Flag cloudsql.logical_decoding auf on fest.
2. Setzen Sie den Parameter wal_sender_timeout auf 0. Dieser Wert deaktiviert das Zeitlimit, das zum Beenden inaktiver Replikationsverbindungen verwendet wird.
3. Konfigurieren Sie die maximale Anzahl von Replikations-Slots mit dem Parameter max_replication_slots. Dieser Parameter muss mindestens auf die Anzahl der Datenbanken festgelegt werden, die Sie pro Migrationsjob migrieren, zuzüglich einiger Reserven für die Tabellensynchronisierung.
  Wenn Sie beispielsweise 5 Datenbanken migrieren und 2 Migrationsjobs für die Quellinstanz erstellt werden, muss die Anzahl der Replikations-Slots mindestens 5 * 2 = 10 betragen, zuzüglich der Anzahl der Replikations-Slots, die Sie bereits verwenden.
4. Konfigurieren Sie den Parameter max_wal_senders auf mindestens denselben Wert wie max_replication_slots plus die Anzahl der Absender, die bereits auf Ihrer Instanz verwendet werden.
  Wenn für den Parameter max_replication_slots beispielsweise der Wert 10 festgelegt ist und Sie bereits zwei Absender verwenden, beträgt die Anzahl der gleichzeitig ausgeführten WAL-Senderprozesse 10 + 2 = 12.
5. Setzen Sie max_worker_processes auf mindestens die Anzahl der Datenbanken, die Sie migrieren möchten, plus die Anzahl der max_worker_processes, die bereits auf Ihrer Instanz verwendet werden.

Schnellstart-Migration erstellen und ausführen

Bei Schnellstartmigrationen können Sie eine neue Cloud SQL-Instanz erstellen und Ihre Datenbanken dorthin migrieren oder Datenbanken zu einer bereits vorhandenen Instanz migrieren.

Schnellstart-Migrationen für neue Instanzen

So erstellen Sie eine neue Cloud SQL for PostgreSQL-Instanz und migrieren Ihre Datenbanken sofort dorthin:

Zur Seite Instanzen.
Zur Seite „Instanzen“
Klicken Sie auf Instanz erstellen > Aus einer vorhandenen Datenbank.
Wählen Sie im Fenster Vorhandene Datenbank migrieren die Option PostgreSQL-Migration schnell starten aus und klicken Sie auf Weiter.
Das Schnellstartformular für die Migration mit Database Migration Service wird geöffnet.
Führen Sie im Abschnitt Migration konfigurieren die folgenden Schritte aus:
1. Wählen Sie im Menü Zielregion die Region Ihrer Cloud SQL for PostgreSQL-Zielinstanz aus.
2. Geben Sie im Feld Migrationspräfix einen lesbaren String ein, der den Namen aller Migrationseinheiten hinzugefügt wird, die für die Schnellstartmigration erstellt werden: Verbindungsprofile, Konfiguration für private Verbindungen, Netzwerkanhang und zugehöriges Subnetz sowie Migrationsjob.
3. Wählen Sie im Menü Konfigurationstyp eine der folgenden Optionen aus:
  1. Bestehende Konfiguration für Verbindungen: Wählen Sie diese Option aus, wenn Sie bereits einen Netzwerk-Anhang und eine Konfiguration für private Verbindungen haben, die die Methode „Private Service Connect-Schnittstellen“ verwendet. Diese Option eignet sich am besten, wenn Sie zuvor Schnellstartmigrationen verwendet haben und dieselben Netzwerkressourcen wiederverwenden möchten.
  2. Neue Konfiguration für die Verbindung: Wählen Sie diese Option aus, um einen neuen Netzwerkanhang und das Subnetz des Netzwerkanhangs im VPC-Netzwerk der Quelldatenbank zu erstellen. Die Konfiguration für private Verbindungen wird im selben Projekt wie Ihre Zielinstanz erstellt.
Führen Sie im Abschnitt Quelle verbinden folgende Schritte aus:
1. Geben Sie einen Hostnamen oder die private IP-Adresse Ihrer Quelldatenbank ein. Die Adresse der Quelldatenbank muss über Ihr Quell-VPC-Netzwerk erreichbar sein.
2. Geben Sie den Port ein, der für den Zugriff auf den Host verwendet wird. Der PostgreSQL-Standardport ist 5432.
3. Geben Sie den Nutzernamen und das Passwort für das dedizierte Migrationskonto in Ihrer Quelldatenbank ein.
4. Wählen Sie im Menü Verschlüsselungstyp eine der folgenden Optionen aus:
  - Keine: Wenn für Ihre Quelldatenbank keine SSL/TLS-verschlüsselten Verbindungen erforderlich sind.
  - Erforderlich: Wenn für Ihre Quelldatenbank SSL/TLS-verschlüsselte Verbindungen erforderlich sind. Für diese Option ist keine Zertifikatsüberprüfung erforderlich.
5. Klicken Sie im Menü Zu migrierende Datenbanken auf Anpassen. Wählen Sie in der Seitenleiste nur die Datenbanken aus, die Sie zu Cloud SQL for PostgreSQL migrieren möchten.
Führen Sie im Abschnitt Ziel konfigurieren die folgenden Schritte aus:
1. Wählen Sie im Menü Zielinstanztyp die Option Neue Instanz aus.
  Database Migration Service verwendet die Standardkonfiguration von Cloud SQL for PostgreSQL für eine neue Instanz. Klicken Sie auf Anpassen, um Instanzfunktionen wie den Maschinentyp, die Verfügbarkeit in Zonen oder die Datenschutzeinstellungen anzupassen. Weitere Informationen zur Instanzkonfiguration finden Sie unter Instanzen erstellen.
Klicken Sie auf Migration starten.
Database Migration Service erstellt jetzt den Migrationsjob und beginnt mit der Migration. Sie können den Migrationsfortschritt in den Details des Migrationsjobs im Database Migration Service überwachen. Weitere Informationen finden Sie in der Dokumentation zu Database Migration Service unter Migrationsjobs verwalten.

Schnellstart-Migrationen für vorhandene Instanzen

So migrieren Sie Datenbanken zu einer vorhandenen Cloud SQL-Instanz:

Zur Seite Instanzen.
Zur Seite „Instanzen“
Wählen Sie die Cloud SQL-Instanz aus, zu der Sie Ihre Datenbanken migrieren möchten.
Klicken Sie auf der Instanz-Detailseite auf Datenbank migrieren.
Das Schnellstartformular für die Migration mit Database Migration Service wird geöffnet.
Führen Sie im Abschnitt Migration konfigurieren die folgenden Schritte aus:
1. Wählen Sie im Menü Zielregion die Region Ihrer Cloud SQL for PostgreSQL-Zielinstanz aus.
2. Geben Sie im Feld Migrationspräfix einen lesbaren String ein, der den Namen aller Migrationseinheiten hinzugefügt wird, die für die Schnellstartmigration erstellt werden: Verbindungsprofile, Konfiguration für private Verbindungen, Netzwerkanhang und zugehöriges Subnetz sowie Migrationsjob.
3. Wählen Sie im Menü Konfigurationstyp eine der folgenden Optionen aus:
  1. Vorhandene Verbindungskonfiguration: Wählen Sie diese Option aus, wenn Sie bereits einen Netzwerkanhang und eine Konfiguration für private Verbindungen haben, die Private Service Connect-Schnittstellen im VPC-Netzwerk der Quelldatenbank verwendet. Diese Option eignet sich am besten, wenn Sie zuvor Schnellstartmigrationen verwendet haben und dieselben Netzwerkressourcen wiederverwenden möchten.
  2. Neue Verbindungskonfiguration: Wählen Sie diese Option aus, um eine neue Netzwerkverbindung, ein neues Subnetz für die Netzwerkverbindung und eine private Verbindungskonfiguration im VPC-Netzwerk der Quelldatenbank zu erstellen.
Führen Sie im Abschnitt Quelle verbinden folgende Schritte aus:
1. Geben Sie einen Hostnamen oder die private IP-Adresse Ihrer Quelldatenbank ein. Die Adresse der Quelldatenbank muss über Ihr Quell-VPC-Netzwerk erreichbar sein.
2. Geben Sie den Port ein, der für den Zugriff auf den Host verwendet wird. Der PostgreSQL-Standardport ist 5432.
3. Geben Sie den Nutzernamen und das Passwort für das dedizierte Migrationskonto in Ihrer Quelldatenbank ein.
4. Wählen Sie im Menü Verschlüsselungstyp eine der folgenden Optionen aus:
  - Keine: Wenn für Ihre Quelldatenbank keine SSL/TLS-verschlüsselten Verbindungen erforderlich sind.
  - Erforderlich: Wenn für Ihre Quelldatenbank SSL/TLS-verschlüsselte Verbindungen erforderlich sind. Für diese Option ist keine Zertifikatsüberprüfung erforderlich.
5. Klicken Sie im Menü Zu migrierende Datenbanken auf Anpassen. Wählen Sie in der Seitenleiste nur die Datenbanken aus, die Sie zu Cloud SQL for PostgreSQL migrieren möchten.
Klicken Sie auf Migration starten.
Database Migration Service erstellt jetzt den Migrationsjob und beginnt mit der Migration. Sie können den Migrationsfortschritt in den Details des Migrationsjobs im Database Migration Service überwachen. Weitere Informationen finden Sie in der Dokumentation zu Database Migration Service unter Migrationsjobs verwalten.

Migration abschließen

Wenn Sie sich entscheiden, Ihre Anwendung auf die neue Cloud SQL-Instanz umzustellen, schließen Sie die Migration mit den folgenden Schritten ab:

Beenden Sie alle Schreibvorgänge in die Quelldatenbank. Sie können sie in den schreibgeschützten Modus versetzen, um die Betriebsfunktionen beizubehalten.
Migrationsjob hochstufen
Optional: Migrierte Daten auf Vollständigkeit prüfen

Nächste Schritte

Weitere Informationen zu anderen Migrationsabläufen und den vollständigen Funktionen des Database Migration Service