Von Cloud SQL for PostgreSQL zu AlloyDB for PostgreSQL migrieren

Wenn Sie AlloyDB for PostgreSQL evaluieren oder eine vorhandene Arbeitslast migrieren möchten, ohne eine kontinuierliche Replikation einzurichten, können Sie eine Cloud SQL for PostgreSQL-Sicherung direkt in einen Clustervon AlloyDB kopieren.

Auf dieser Seite wird davon ausgegangen, dass Sie mit Cloud SQL vertraut sind. Wenn Sie AlloyDB noch nicht kennen, lesen Sie die AlloyDB-Übersicht.

Informationen zum Migrieren Ihrer Daten von Cloud SQL zu AlloyDB mithilfe der kontinuierlichen Datenreplikation finden Sie unter Database Migration Service für PostgreSQL zu AlloyDB.

Die folgenden Konfigurationen werden nicht unterstützt:

  • Projektübergreifende und regionenübergreifende Wiederherstellungen
  • Instanzen mit kundenverwalteten Verschlüsselungsschlüsseln (CMEK)

Hinweis

  1. 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

  2. Verify that billing is enabled for your Google Cloud project.

  3. Aktivieren Sie die AlloyDB, Compute Engine und Service Networking APIs, falls sie noch nicht aktiviert sind.

    Erforderliche Rollen zum Aktivieren von APIs

    Zum Aktivieren von APIs benötigen Sie die Berechtigung serviceusage.services.enable. Wenn Sie das Projekt erstellt haben, haben Sie diese Berechtigung wahrscheinlich bereits über die Inhaberrolle (roles/owner). Andernfalls können Sie diese Berechtigung über die Rolle „Service Usage-Administrator“ (roles/serviceusage.serviceUsageAdmin) erhalten. Informationen zum Zuweisen von Rollen

    APIs aktivieren

  4. Folgende Voraussetzungen müssen erfüllt sein:

Erforderliche Rollen

Um die Berechtigungen zu erhalten, die Sie zum Kopieren einer Cloud SQL for PostgreSQL-Sicherung in einen AlloyDB-Cluster benötigen, weisen Sie sich die folgenden IAM-Rollen für Ihr Projekt zu:

  • Cloud SQL-Betrachter (roles/cloudsql.viewer) oder eine beliebige benutzerdefinierte Rolle, die die Berechtigung cloudsql.backupRuns.export enthält.
  • AlloyDB Admin (roles/alloydb.admin)

Cloud SQL-Sicherung in einen AlloyDB-Cluster kopieren

Wenn Sie ein Cloud SQL-Sicherungselement in einenStandard Kostenlosen Testzeitraum -Cluster wiederhergestellt. Erweiterungsversionen und PostgreSQL-Nebenversionen können sich unterscheiden.

Beim Kopieren einer Sicherung aus Cloud SQL wird nur die Konfiguration der Elemente unterstützt, die im Standardcluster von AlloyDB unterstützt werden.

So kopieren Sie eine Cloud SQL-Sicherung in einenvon AlloyDB:

Console

  1. Rufen Sie in der Google Cloud Console die Seite Cluster auf.

    Zu den Clustern

  2. Klicken Sie auf Daten migrieren und wählen Sie dann Aus Cloud SQL-Sicherung kopieren aus.
  3. Aktivieren Sie auf der Seite Aus Cloud SQL-Sicherung kopieren die erforderlichen APIs. Wenn Sie die APIs bereits aktiviert haben, müssen Sie sie nicht noch einmal aktivieren.
  4. Wählen Sie auf der Seite Clustertyp auswählen die Option Bereitgestellter Cluster aus.
  5. Klicken Sie auf Clustertyp auswählen.
  6. Wählen Sie die Cloud SQL-Instanz aus, aus der Sie eine Sicherung kopieren möchten, und klicken Sie dann auf Instanz auswählen. Sie können Cloud SQL-Instanzen filtern.
    Es werden nur kompatible Datenbankversionen angezeigt. Replikate haben keine Sicherungen und werden nicht in der Liste der verfügbaren Instanzen angezeigt.
  7. Wählen Sie die Sicherung aus, aus der Sie Daten importieren möchten, und klicken Sie dann auf Sicherung auswählen. Auf dieser Seite werden die letzten 1.000 Sicherungen angezeigt.
  8. Geben Sie auf der Seite Bereitgestellten Cluster erstellen Ihre Netzwerkinformationen ein. Die Cluster-ID wird standardmäßig ausgefüllt, Sie können den bereitgestellten Cluster aber auch anpassen.
  9. Klicken Sie auf Cluster erstellen.

Nach Abschluss des Vorgangs wird automatisch eine primäre Instanz erstellt. Sie sehen einen neuen AlloyDB-Cluster mit den Daten, die aus der von Ihnen ausgewählten Cloud SQL for PostgreSQL-Sicherung kopiert wurden.

Wenn Sie eine Cloud SQL for PostgreSQL-Sicherung in einen AlloyDB-Cluster kopieren, werden die Konfigurationen einzelner Nutzer und IAM-Gruppennutzer von AlloyDB zugeordnet und beibehalten. AlloyDB migriert auch Datenbank-Flags, die sowohl in Cloud SQL for PostgreSQL als auch in AlloyDB unterstützt werden. Berechtigungen auf Ressourcenebene werden nicht automatisch migriert. Nachdem die Kopie erstellt wurde, müssen Sie Berechtigungen und alle Datenbank-Flags, die aufgrund einer Abweichung nicht migriert wurden, manuell einrichten.

Auf der Seite Bereitgestellten Cluster erstellen können Sie prüfen, welche Datenbank-Flags in Cloud SQL for PostgreSQL in AlloyDB unterstützt werden.

gcloud

Wenn Sie die Google Cloud CLI verwenden möchten, können Sie die gcloud CLI installieren und initialisieren oder Cloud Shell verwenden.

  1. Führen Sie den Befehl gcloud alloydb clusters migrate-cloud-sql aus:
          gcloud alloydb clusters migrate-cloud-sql CLUSTER_ID \
        --cloud-sql-backup-id=CLOUD_SQL_BACKUP_ID \
        --cloud-sql-instance-id=CLOUD_SQL_INSTANCE_ID \
        --cloud-sql-project-id=CLOUD_SQL_PROJECT_ID \
        --password=PASSWORD \
        --region=REGION \
        --database-version=DATABASE_VERSION \
        --subscription-type=STANDARD

    Ersetzen Sie Folgendes:

    • CLUSTER_ID: AlloyDB-Cluster-ID.
    • CLOUD_SQL_BACKUP_ID: Cloud SQL-Sicherungs-ID, von der migriert werden soll. Dies muss die Sicherungs-ID sein.
    • CLOUD_SQL_INSTANCE_ID: ID der Cloud SQL-Instanz, von der migriert werden soll. Dies muss die Instanz-ID sein.
    • CLOUD_SQL_PROJECT_ID: Cloud SQL-Projekt-ID, von der migriert werden soll. Dies muss die Projekt-ID sein.
    • PASSWORD: Das anfängliche PostgreSQL-Nutzerpasswort, das bei der Clustererstellung eingerichtet werden soll.
    • REGION: Standort, z. B. asia-east1 oder us-east1. Eine vollständige Liste der Regionen finden Sie unter Standorte.
    • DATABASE_VERSION: Datenbankversion des Clusters. Dies muss einer der folgenden Werte sein: POSTGRES_14, POSTGRES_15, POSTGRES_16, POSTGRES_17 oder POSTGRES_18. Die Datenbankversion muss mit der Version der Cloud SQL-Sicherung übereinstimmen.
  2. Führen Sie den Befehl gcloud alloydb operations describe aus, um den Status des Sicherungsvorgangs zu prüfen:
          gcloud alloydb operations describe OPERATION_ID \
        --region=REGION_ID \
        --project=PROJECT_ID

    Ersetzen Sie Folgendes:

    • OPERATION_ID: Der Name des AlloyDB-Vorgangs.
    • REGION_ID: die Region, in der der AlloyDB-Cluster bereitgestellt wird.
    • PROJECT_ID: Projekt-ID.
  3. Verwenden Sie den Befehl gcloud alloydb instances create, um eine primäre Instanz zu erstellen.

REST API

  1. Rufen Sie die Methode backupRuns.list auf, um eine Liste der Sicherungen für die Instanz abzurufen, aus der Sie Ihre Sicherung wiederherstellen möchten:
          GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID/backupRuns

    Ersetzen Sie Folgendes:

    • PROJECT_ID: Projekt-ID.
    • INSTANCE_ID: Instanz-ID.

    Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

    curl (Linux, macOS oder Cloud Shell)

    Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der Google Cloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in der gcloud CLI anmeldet.

    Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

    Führen Sie den folgenden Befehl aus:

            curl -X GET \
               -H "Authorization: Bearer $(gcloud auth print-access-token)" \
               -H "Content-Type: application/json; charset=utf-8" \
               "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID/backupRuns"

    PowerShell (Windows)

    Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in der gcloud CLI anmeldet.

    Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

    Führen Sie den folgenden Befehl aus:

             $cred = gcloud auth print-access-token
         $headers = @{ "Authorization" = "Bearer $cred" }
         Invoke-WebRequest \
          -Method GET \
          -Headers $headers \
          -ContentType: "application/json; charset=utf-8" \
          -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID/backupRuns" | Select-Object -Expand Content

    Sie erhalten eine JSON-Antwort ähnlich wie diese:

    Antwort

    Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Liste von BackupRun-Objekten:

          {
        "kind": string,
        "items": [
          {
            object (BackupRun)
          }
        ],
        "nextPageToken": string
      }

    Die API-Antwort gibt eine Liste der Sicherungen für die Instanz als Arrayliste zurück, einschließlich "id": string.

  2. Rufen Sie die Methode clusters.restoreFromCloudSQL auf: 
            POST https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/clusters:restoreFromCloudSQL

    Ersetzen Sie Folgendes:

    • PROJECT_ID: Projekt-ID.
    • REGION: die Region, in der der AlloyDB-Cluster bereitgestellt wird.

    JSON-Text der Anfrage:

          {
        "clusterId": string,
        "cluster": {
          "databaseVersion": "POSTGRES_14/POSTGRES_15/POSTGRES_16/POSTGRES_17/POSTGRES_18",
          "subscriptionType": "STANDARD"
        },
        // Union field source can be only one of the following:
        "cloudsqlBackupRunSource": {
          object (CloudSQLBackupRunSource)
        }
        // End of list of possible types for union field source.
      }

    Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

    curl (Linux, macOS oder Cloud Shell)

    Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in der gcloud CLI anmeldet.

    Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

    Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

            curl -X POST \
               -H "Authorization: Bearer $(gcloud auth print-access-token)" \
               -H "Content-Type: application/json; charset=utf-8" \
               -d @request.json \
               "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/clusters:restoreFromCloudSQL"

    PowerShell (Windows)

    Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in der gcloud CLI anmeldet.

    Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

    Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

            $cred = gcloud auth print-access-token
        $headers = @{ "Authorization" = "Bearer $cred" }
        Invoke-WebRequest \
          -Method POST \
          -Headers $headers \
          -ContentType: "application/json; charset=utf-8" \
          -InFile request.json \
          -Uri "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/clusters:restoreFromCloudSQL"|Select-Object -Expand Content

    Sie erhalten eine JSON-Antwort ähnlich wie diese:

    Antwort

    Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Operation.

    AlloyDB erstellt einen neuen Cluster im angegebenen Projekt und am angegebenen Standort und stellt das Volume aus der Sicherung wieder her, die in der CloudSQLBackupRunSource-Nachricht angegeben ist.

  3. Wenn der Cluster den Status READY hat, erstellen Sie die primäre Instanz, indem Sie die Methode projects.locations.clusters.instances.create aufrufen:
          POST https://alloydb.googleapis.com/v1/{parent=projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID}/instances

    Ersetzen Sie Folgendes:

    • PROJECT_ID: Projekt-ID.
    • REGION: die Region, in der der AlloyDB-Cluster bereitgestellt wird.
    • CLUSTER_ID: die Cluster-ID.

    JSON-Text der Anfrage:

            {
          "instanceId": "string",
          "instance": {
            "object": "Instance"
          }
        }

    Der Anfragetext enthält eine Instanz von Instance.

    Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

    curl (Linux, macOS oder Cloud Shell)

    Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in der gcloud CLI anmeldet.

    Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

    Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

            curl -X POST \
             -H "Authorization: Bearer $(gcloud auth print-access-token)" \
             -H "Content-Type: application/json; charset=utf-8" \
             -d @request.json \
             "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID/instances"

    PowerShell (Windows)

    Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in der gcloud CLI anmeldet.

    Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

    Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

             $cred = gcloud auth print-access-token
         $headers = @{ "Authorization" = "Bearer $cred" }
         Invoke-WebRequest \
           -Method POST \
           -Headers $headers \
           -ContentType: "application/json; charset=utf-8" \
           -InFile request.json \
           -Uri "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID/instances"|Select-Object -Expand Content

    Sie erhalten eine JSON-Antwort ähnlich wie diese:

    Antwort

    Bei Erfolg enthält der Antworttext eine neu erstellte Instanz von Operation.

  4. Nachdem die Instanz auf den Status READY aktualisiert wurde, stellen Sie eine Verbindung zur Instanz her und greifen Sie auf die wiederhergestellten Daten aus dem Cloud SQL-Snapshot zu.

Nächste Schritte