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:

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 sql instances describe INSTANCE_NAME
   

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

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

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

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

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

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

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

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

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

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

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

{
  "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 sql instances list --show-sql-network-architecture

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

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

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

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

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method LIST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances" | Select-Object -Expand Content

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

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

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

curl -X LIST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method LIST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances" | Select-Object -Expand Content

{
  "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 sql instances patch INSTANCE_NAME --upgrade-sql-network-architecture

operation_id

operation_id

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

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

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

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

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

operation_id

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

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

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

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

• Mehr über Private Service Connect
• Weitere Informationen zu Assured Workloads
• Weitere Informationen zu Privaten Dienstzugriff für Cloud SQL konfigurieren.
• Weitere Informationen zum Dienst zur Datenbankmigration zu AlloyDB for PostgreSQL