Upgrade einer Instanz auf die neue Netzwerkarchitektur ausführen


Auf dieser Seite wird beschrieben, wie Sie Ihre Cloud SQL-Instanzen von der alten Netzwerkarchitektur auf die neue Netzwerkarchitektur aktualisieren.

Diese Seite zum Aktualisieren der Cloud SQL-Netzwerkarchitektur gilt nur für einige Cloud SQL-Instanzen. Wenn Ihre Cloud SQL-Instanzen ein VPC-Netzwerkprojekt (Virtual Private Cloud) verwenden, das vor August 2021 erstellt wurde, müssen Sie die Cloud SQL-Netzwerkarchitektur für Ihre Instanzen aktualisieren.

Überblick

Die folgende Tabelle zeigt die Vorteile der neuen Netzwerkarchitektur im Vergleich zur alten Netzwerkarchitektur:

Voraussetzung Alte Netzwerkarchitektur Neue Netzwerkarchitektur
Mit dem Database Migration Service von Cloud SQL zu AlloyDB for PostgreSQL und von AlloyDB for PostgreSQL zu Cloud SQL migrieren Erfordert die Konfiguration einer privaten IP-Adresse für die Migration Es ist keine zusätzliche Netzwerkkonfiguration erforderlich.

Beispiel: Migration von Cloud SQL zu AlloyDB for PostgreSQL oder Migration von AlloyDB for PostgreSQL zu Cloud SQL.
Ihre Cloud SQL-Instanz über eine private IP-Adresse mit privaten Diensten wie Cloud Build oder Vertex AI verbinden Aufgrund von Netzwerk-Peering-InTransitivität nicht unterstützt Unterstützt
Instanzen, die mit Assured Workloads konform sind Nicht unterstützt Unterstützt
Verwaltetes Microsoft Active Directory Nicht unterstützt Unterstützt
Private Service Connect Nicht unterstützt Unterstützt
Standardmäßiges Cloud SQL-Instanzkontingent pro Projekt 100 1000

Upgrade planen

Planen Sie vor dem Upgrade der Netzwerkarchitektur Ihrer Cloud SQL-Instanzen das Upgrade gemäß den folgenden Upgradeeinschränkungen:

  • Wenn Sie Ihre Netzwerkarchitektur aktualisieren, kommt es bei der Datenbankinstanz zu einer Ausfallzeit von bis zu vier Minuten.

  • Wenn eine Datenmigration aktiv ist, können Sie die Quellinstanz während der Datenmigration nicht auf die neue Architektur aktualisieren.

  • Wenn sich in Ihrem Netzwerk innerhalb der letzten vier Tage oder weniger zwei oder mehr Instanzen in derselben Region befinden, können Sie ein Upgrade nur für Instanzen ausführen, für die Hochverfügbarkeit aktiviert ist.

    Hinweis: In diesem Szenario verwendet Cloud SQL vorübergehend einen zusätzlichen /24-Bereich, um Ihre aktualisierten Instanzen in der neuen Architektur zu hosten. Nachdem Cloud SQL alle Instanzen in der Netzwerk- und Regionskombination aktualisiert hat, gibt Cloud SQL den Bereich frei.

    Wenn Ihr Netzwerk beispielsweise zwei Instanzen enthält und sich eine in us-east1 und die andere in us-central1 befindet, können Sie beide Instanzen aktualisieren, unabhängig davon, ob Hochverfügbarkeit aktiviert ist oder nicht. Wenn Ihr Netzwerk jedoch drei Instanzen enthält und eine sich in us-east1 und die anderen beiden in us-central1 befinden, können Sie die Instanzen in us-central1 aktualisieren, für die Hochverfügbarkeit aktiviert ist. Da die Instanz in us-east1 die einzige Instanz in dieser Region ist, können Sie ein Upgrade ausführen, unabhängig davon, ob Hochverfügbarkeit aktiviert ist.

  • Nach dem Upgrade einer Hochverfügbarkeitsinstanz auf die neue Netzwerkarchitektur können Sie Hochverfügbarkeit für diese Instanz nicht deaktivieren.

  • Wenn Sie eine Verbindung zu einer Instanz von einer externen Quelle herstellen, überprüfen Sie, ob alle Peering-Verbindungen aktualisiert wurden, um den Export benutzerdefinierter Routen zu ermöglichen.

Upgrade aller Cloud SQL-Instanzen in einem Netzwerkprojekt planen

Ihre Cloud SQL-Instanzen können sich im selben Projekt wie das VPC-Netzwerk befinden oder in einem separaten Projekt gehostet werden. Das Projekt, in dem das VPC-Netzwerk gehostet wird, ist das Netzwerkprojekt.

Wenn mindestens eine Cloud SQL-Instanz innerhalb eines Netzwerkprojekts die alte Netzwerkarchitektur verwendet, verwendet das gesamte Projekt die alte Netzwerkarchitektur. In diesem Fall wird Ihr Projekt nicht vollständig auf die neue Netzwerkarchitektur aktualisiert.

Mit der gcloud CLI oder der Cloud SQL Admin API können Sie die Netzwerkarchitektur für alle Cloud SQL-Instanzen innerhalb eines Projekts abfragen.

Wenn Sie das private Netzwerk einer Instanz ändern oder eine private IP-Adresse für eine Instanz aktivieren, können Sie die Netzwerkarchitektur nicht in derselben Anfrage ändern. Wenn Sie sie doch ändern, wird die Anfrage abgelehnt. Um dies zu vermeiden, empfehlen wir Ihnen, alle Instanzen in einem Netzwerkprojekt zu aktualisieren, bevor Sie das Netzwerkprojekt ändern.

Upgrade Ihrer Cloud SQL-Netzwerkarchitektur ausführen

So aktualisieren Sie die Netzwerkarchitektur Ihrer Cloud SQL-Instanzen:

  1. Prüfen Sie die Netzwerkarchitektur entweder einer einzelnen Cloud SQL-Instanz oder mehrerer Cloud SQL-Instanzen.
  2. Netzwerkarchitektur einer Cloud SQL-Instanz aktualisieren

Netzwerkarchitektur einer einzelnen Cloud SQL-Instanz prüfen

Zum Prüfen der aktuellen Netzwerkarchitektur einer einzelnen Instanz verwenden Sie den Befehl gcloud sql instances describe oder die Methode instances.get.

gcloud

Informationen zur Installation und den ersten Schritten mit der gcloud CLI finden Sie unter gcloud CLI installieren. Informationen zum Starten von Cloud Shell finden Sie unter Cloud Shell verwenden.

Führen Sie den folgenden Befehl aus, um die Netzwerkarchitektur einer einzelnen Instanz zu prüfen: 

   gcloud sql instances describe INSTANCE_NAME

Wenn die Instanz die alte Netzwerkarchitektur verwendet, sieht die Antwort in etwa so aus:

   name: INSTANCE_NAME
   project: PROJECT_ID
   ...
   sql_network_architecture: OLD_NETWORK_ARCHITECTURE

Wenn die Instanz die neue Netzwerkarchitektur verwendet, sieht die Antwort in etwa so aus:

   name: INSTANCE_NAME
   project: PROJECT_ID
   ...
   sql_network_architecture: NEW_NETWORK_ARCHITECTURE

Der Parameter sql_network_architecture gibt an, ob Ihre Instanz die alte Netzwerkarchitektur (OLD_NETWORK_ARCHITECTURE) oder die neue Netzwerkarchitektur (NEW_NETWORK_ARCHITECTURE) verwendet.

REST Version 1

Verwenden Sie zum Prüfen der Netzwerkarchitektur einer Instanz die Methode instances.get der Cloud SQL Admin API.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • PROJECT_ID: die Projekt-ID
  • INSTANCE_NAME: ist der Name der Instanz.
  • NETWORK_ARCHITECTURE_TYPE: Der Netzwerkarchitekturtyp ist so definiert:
    • OLD_NETWORK_ARCHITECTURE: Die Instanz verwendet die alte Netzwerkarchitektur.
    • NEW_NETWORK_ARCHITECTURE: Die Instanz verwendet die neue Netzwerkarchitektur.

HTTP-Methode und URL:

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME

JSON-Text anfordern:

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten in etwa folgende JSON-Antwort erhalten:

{
  "kind": sql#instance
  "name": INSTANCE_NAME
  "project": PROJECT_ID
  "sqlNetworkArchitecture": enum (SqlNetworkArchitecture)
  ...
}

REST v1beta4

Verwenden Sie zum Prüfen der Netzwerkarchitektur einer Instanz die Methode instances.get der Cloud SQL Admin API.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • PROJECT_ID: die Projekt-ID
  • INSTANCE_NAME: ist der Name der Instanz.
  • NETWORK_ARCHITECTURE_TYPE: Der Netzwerkarchitekturtyp ist so definiert:
    • OLD_NETWORK_ARCHITECTURE: Die Instanz verwendet die alte Netzwerkarchitektur.
    • NEW_NETWORK_ARCHITECTURE: Die Instanz verwendet die neue Netzwerkarchitektur.

HTTP-Methode und URL:

GET https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

JSON-Text anfordern:

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten in etwa folgende JSON-Antwort erhalten:

{
  "kind": sql#instance
  "name": INSTANCE_NAME
  "project": PROJECT_ID
  "sqlNetworkArchitecture": enum (SqlNetworkArchitecture)
  ...
}

Netzwerkarchitektur mehrerer Cloud SQL-Instanzen prüfen

Verwenden Sie den Befehl gcloud sql instances list oder die Methode instance.list, um die Netzwerkarchitektur mehrerer Instanzen in einem Projekt zu prüfen.

gcloud

Führen Sie den folgenden Befehl aus, um die Netzwerkarchitektur mehrerer Instanzen in einem Projekt zu prüfen: 

gcloud sql instances list --show-sql-network-architecture

Die Ausgabe sieht ungefähr so aus:

NAME        DATABASE_VERSION LOCATION   ...     SQL_NETWORK_ARCHITECTURE
instance_1  POSTGRES_13      asia-northeast1-b  OLD_NETWORK_ARCHITECTURE
instance_2  MYSQL_5_7        europe-west1-d     NEW_NETWORK_ARCHITECTURE
...

REST Version 1

Mit der Methode instance.list können Sie die Netzwerkarchitektur mehrerer Instanzen in einem Projekt prüfen.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • PROJECT_ID: die Projekt-ID
  • NETWORK_ARCHITECTURE_TYPE: Den Netzwerkarchitekturtyp so:
    • OLD_NETWORK_ARCHITECTURE: Die Instanz verwendet die alte Netzwerkarchitektur.
    • NEW_NETWORK_ARCHITECTURE: Die Instanz verwendet die neue Netzwerkarchitektur.

HTTP-Methode und URL:

LIST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances

JSON-Text anfordern:

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten in etwa folgende JSON-Antwort erhalten:

{
  "kind": sql#instance
  "name": INSTANCE_NAME
  "project": PROJECT_ID
  "sqlNetworkArchitecture": enum (SqlNetworkArchitecture)
  ...
}

REST v1beta4

Mit der Methode instance.list können Sie die Netzwerkarchitektur mehrerer Instanzen in einem Projekt prüfen.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • PROJECT_ID: die Projekt-ID
  • NETWORK_ARCHITECTURE_TYPE: Der Netzwerkarchitekturtyp ist so definiert:
    • OLD_NETWORK_ARCHITECTURE: Die Instanz verwendet die alte Netzwerkarchitektur.
    • NEW_NETWORK_ARCHITECTURE: Die Instanz verwendet die neue Netzwerkarchitektur.

HTTP-Methode und URL:

LIST https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances

JSON-Text anfordern:

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten in etwa folgende JSON-Antwort erhalten:

{
  "kind": sql#instance
  "name": INSTANCE_NAME
  "project": PROJECT_ID
  "sqlNetworkArchitecture": enum (SqlNetworkArchitecture)
  ...
}

Upgrade der Netzwerkarchitektur einer einzelnen Cloud SQL-Instanz ausführen

Verwenden Sie zum Aktualisieren der Netzwerkarchitektur für eine einzelne Instanz den Befehl gcloud sql instances patch, die Methode instance.update oder die Methodeinstance.patch.

gcloud

Führen Sie den folgenden Befehl aus, um die Netzwerkarchitektur einer Instanz zu aktualisieren: 

gcloud sql instances patch INSTANCE_NAME --upgrade-sql-network-architecture

Der Upgradevorgang dauert einige Minuten.

Während des Upgrades wird ein Vorgang mit langer Ausführungszeit gestartet und ein Vorgangstoken wird zurückgegeben:

operation_id

REST Version 1

Verwenden Sie zum Upgrade der Netzwerkarchitektur einer Instanz den instance.update oder instance.patch der Cloud SQL Admin API.

Wenn Sie die Cloud SQL-Netzwerkarchitektur aktualisieren, sind keine zusätzlichen Updates der Instanz in der Anfrage zulässig. Der Anfragetext enthält eine Instanz des DatabaseInstance-Objekts, wobei sqlNetworkArchitecture auf NEW_NETWORK_ARCHITECTURE gesetzt ist.

Während des Upgrades wird ein Vorgang mit langer Ausführungszeit gestartet und ein Vorgangstoken wird zurückgegeben:

operation_id

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • PROJECT_ID: die Projekt-ID
  • INSTANCE_NAME: ist der Name der Instanz.
  • NETWORK_ARCHITECTURE_TYPE: Der Netzwerkarchitekturtyp ist so definiert:
    • OLD_NETWORK_ARCHITECTURE: Die Instanz verwendet die alte Netzwerkarchitektur.
    • NEW_NETWORK_ARCHITECTURE: Die Instanz verwendet die neue Netzwerkarchitektur.

HTTP-Methode und URL:

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME

JSON-Text anfordern:

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten in etwa folgende JSON-Antwort erhalten:

{
  "kind": sql#instance,
  "targetLink": string,
  "status": enum (SqlOperationStatus),
  "name": string,
  "insertTime": string,
  "startTime": string,
  "endTime": string
  ...
}

Wenn das Upgrade Ihrer Instanz fehlschlägt, wiederholen Sie den Upgradevorgang.

REST v1beta4

Verwenden Sie zum Upgrade der Netzwerkarchitektur einer Instanz den instance.update method oder instance.patch method der Cloud SQL Admin API.

Wenn Sie die Cloud SQL-Netzwerkarchitektur aktualisieren, sind keine zusätzlichen Updates der Instanz in der Anfrage zulässig. Der Anfragetext enthält eine Instanz des DatabaseInstance-Objekts, wobei sqlNetworkArchitecture auf NEW_NETWORK_ARCHITECTURE gesetzt ist.

Während des Upgrades wird ein Vorgang mit langer Ausführungszeit gestartet und das folgende Vorgangstoken wird zurückgegeben:

operation_id

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • PROJECT_ID: die Projekt-ID
  • INSTANCE_NAME: ist der Name der Instanz.
  • NETWORK_ARCHITECTURE_TYPE: Der Netzwerkarchitekturtyp ist so definiert:
    • OLD_NETWORK_ARCHITECTURE: Die Instanz verwendet die alte Netzwerkarchitektur.
    • NEW_NETWORK_ARCHITECTURE: Die Instanz verwendet die neue Netzwerkarchitektur.

HTTP-Methode und URL:

PATCH https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

JSON-Text anfordern:

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten in etwa folgende JSON-Antwort erhalten:

{
  "kind": sql#instance,
  "targetLink": string,
  "status": enum (SqlOperationStatus),
  "name": string,
  "insertTime": string,
  "startTime": string,
  "endTime": string
  ...
}

Wenn das Upgrade Ihrer Instanz aus irgendeinem Grund fehlschlägt, können Sie den Upgradevorgang wiederholen.

Häufig gestellte Fragen

In diesem Abschnitt finden Sie Antworten auf häufig gestellte Fragen zum Upgrade Ihrer Cloud SQL-Netzwerkarchitektur.

Wie wirkt sich das Upgrade auf meine Cloud SQL-Instanz aus?

Beim Upgrade Ihrer Netzwerkarchitektur hat die Cloud SQL-Instanz den Zustand MAINTENANCE. In diesem Zustand weist die Instanz im Durchschnitt bis zu vier Minuten Ausfallzeit auf. Weitere Änderungen an der Instanz sind erst zulässig, wenn das Upgrade abgeschlossen ist. Andere Instanzen in Ihrem Projekt oder Netzwerk sind vom Upgrade nicht betroffen.

Funktionieren alle Funktionen nach dem Upgrade genau so wie davor?

Alle Features Ihrer Cloud SQL-Instanz funktionieren in der neuen Architektur genauso wie in der alten Architektur. Wenn Sie nach dem Upgrade einer Instanz auf die neue Netzwerkarchitektur das Netzwerk dieser Instanz wechseln möchten, müssen Sie prüfen, ob alle Instanzen im Zielnetzwerk auch auf die neue Netzwerkarchitektur aktualisiert werden.

Welche Instanzen verwenden die alte Netzwerkarchitektur?

Alle neuen Projekte, die nach August 2021 erstellt wurden, verwenden automatisch die neue Netzwerkarchitektur. Bestehende Projekte können Cloud SQL-Instanzen enthalten, die älter als zwei Jahre sind und noch die alte Netzwerkarchitektur verwenden. Daher müssen alle Instanzen in einem vorhandenen Projekt aktualisiert werden, bevor neue Instanzen in diesem Projekt die neue Netzwerkarchitektur verwenden können.

Werden alle neuen Cloud SQL-Instanzen in der neuen Netzwerkarchitektur erstellt?

Standardmäßig verwenden neue Cloud SQL-Instanzen, die in Projekten erstellt wurden, die nach August 2021 erstellt wurden, die neue Netzwerkarchitektur. Wenn Sie eine Instanz in einem Projekt erstellen möchten, das vor August 2021 erstellt wurde, und die neue Netzwerkarchitektur verwenden möchten, müssen Sie Folgendes tun:

  1. Aktualisieren Sie alle vorhandenen Instanzen in diesem Projekt auf die neue Netzwerkarchitektur.

  2. Wenn Sie einen Google Cloud-Supportvertrag haben, erstellen Sie eine Supportanfrage, um die Standardnetzwerkarchitektur des Projekts in die neue Architektur zu ändern.

  3. Wenn Sie keinen Supportvertrag haben, erstellen Sie Ihre Instanz und führen Sie dann ein Upgrade auf die neue Netzwerkarchitektur aus.

Nachdem der Standardwert des Projekts geändert wurde, können Sie Instanzen mit der neuen Netzwerkarchitektur in diesem Projekt erstellen.

Wenn Sie die Standard-Netzwerkarchitektur Ihres Projekts nicht ändern, verwenden alle neuen Instanzen in diesem Projekt die alte Netzwerkarchitektur. Sie müssen dann jede dieser Instanzen einzeln auf die neue Netzwerkarchitektur aktualisieren.

Ist es möglich, alle Instanzen in einem Projekt mit einem einzigen Befehl zu aktualisieren?

Nein, das Upgrade auf die neue Netzwerkarchitektur basiert auf jeder Instanz.

Wird das Replikat automatisch aktualisiert, wenn ich das primäre upgraden?

Nein, das Upgrade auf die neue Netzwerkarchitektur basiert auf jeder einzelnen Instanz. Jedes Replikat wird als separate Instanz behandelt und muss separat aktualisiert werden. Dies bedeutet, dass das Replikat keine Änderung erlebt, wenn die primäre Instanz aktualisiert wird und das Replikat die alte Netzwerkarchitektur verwendet. Dies gilt auch umgekehrt. Wenn Sie ein Replikat upgraden, hat dies keine Auswirkungen auf die primäre.

Nächste Schritte