Upgrade einer Instanz auf Cloud SQL Enterprise Plus mithilfe eines direkten Upgrades ausführen

MySQL | PostgreSQL | SQL Server

Auf dieser Seite wird gezeigt, wie Sie die direkte Upgrademethode verwenden, um eine Instanz der Cloud SQL Enterprise-Edition auf die Cloud SQL Enterprise Plus-Edition zu aktualisieren. Außerdem wird das Verfahren zum Downgrade einer Cloud SQL Enterprise Plus-Edition-Instanz auf die Cloud SQL Enterprise-Edition beschrieben.

Das Upgrade auf Cloud SQL Enterprise Plus bietet mehrere Vorteile und Leistungsverbesserungen. Weitere Informationen finden Sie unter Einführung in Cloud SQL for MySQL-Editionen.

Wenn Sie diese Verbesserungen für Ihre vorhandenen Instanzen der Cloud SQL Enterprise-Edition aktivieren möchten, müssen Sie ein Upgrade auf die Cloud SQL Enterprise Plus-Edition ausführen. Der Upgradeprozess dauert einige Minuten, einschließlich einer erwarteten Ausfallzeit von weniger als 60 Sekunden. Darüber hinaus müssen sich bei diesem Prozess die Endpunkte der Anwendungen nicht ändern, mit denen sie verbunden sind.

Hinweise

Prüfen Sie, ob Sie eine Cloud SQL Enterprise Edition-Instanz auf MySQL Version 8.0.31 oder höher ausführen.

Wenn Ihre Instanz eine ältere Version von MySQL verwendet, müssen Sie ein Upgrade auf MySQL 8.0.31 oder höher ausführen. Weitere Informationen finden Sie unter Direkte Datenbankaktualisierung durchführen und Nebenversion der Datenbank aktualisieren.

Achten Sie darauf, dass Ihre Instanz ein Solid State Drive (SSD) verwendet.

Speicherort der für PITR verwendeten Transaktionslogs prüfen

Alle Cloud SQL Enterprise Plus-Instanzen werden automatisch mit der Wiederherstellung zu einem bestimmten Zeitpunkt (Point-In-Time Recovery, PITR) aktiviert. Wenn die Cloud SQL Enterprise Edition-Instanz, die Sie aktualisieren möchten, die binären Logs, die für PITR verwendet werden, auf dem Laufwerk speichert, wird beim Upgrade auf die Cloud SQL Enterprise Plus-Version der Speicherort der binären Logs von Laufwerk zu Cloud Storage.

Prüfen Sie vor dem Upgrade auf Cloud SQL Enterprise Plus, ob Ihre Cloud SQL Enterprise-Instanz der Änderung des Speicherorts für die binären Logs unterzogen wird, die für PITR verwendet werden. Weitere Informationen und Anleitungen zum Prüfen Ihrer Instanz finden Sie unter Speicherort der für PITR verwendeten Transaktionslogs prüfen.

Weitere Informationen zum Ändern des Speicherorts des Transaktionslogs im Upgradeprozess finden Sie unter Speicherort der für PITR verwendeten Transaktionslogs.

Upgrade einer Instanz auf Cloud SQL Enterprise Plus ausführen

Folgen Sie der Anleitung in diesem Abschnitt, um eine Cloud SQL Enterprise-Edition-Instanz auf die Cloud SQL Enterprise Plus-Version zu aktualisieren.

Console

Wechseln Sie in der Google Cloud Console zur Seite Cloud SQL-Instanzen.

Cloud SQL-Instanzen aufrufen
Klicken Sie auf den Instanznamen, um die Übersichtsseite einer Instanz zu öffnen.
Klicken Sie auf Bearbeiten.
Klicken Sie im Abschnitt Cloud SQL-Version auswählen auf Upgrade.
Geben Sie im Bereich Upgrade auf Enterprise Plus Ihre Instanz-ID ein und klicken Sie dann auf Version aktualisieren.

Alternativ können Sie auf der Seite Übersicht im Abschnitt Konfiguration auf Upgrade klicken, um eine Instanz zu aktualisieren.

gcloud

Im folgenden Codebeispiel wird gezeigt, wie Sie ein Upgrade Ihrer Instanz auf Cloud SQL Enterprise Plus ausführen:


gcloud sql instances patch INSTANCE_ID \
  --edition=enterprise-plus \
  --tier=MACHINE_TYPE \
  --project=PROJECT_ID

Hinweis: Cloud SQL aktiviert den Daten-Cache für Ihre Instanz während des Upgrades standardmäßig. Sie können sie deaktivieren, indem Sie das Flag --no-enable-data-cache hinzufügen.

Ersetzen Sie Folgendes:

PROJECT_ID: Die Projekt-ID der Instanz, die Sie aktualisieren möchten.
INSTANCE_ID: Der Name der Instanz, die Sie aktualisieren möchten.
MACHINE_TYPE: Der Maschinentyp der Instanz, auf die Sie ein Upgrade ausführen möchten. Weitere Informationen zu Maschinentypen für Cloud SQL Enterprise Plus finden Sie unter Maschinentypen für Cloud SQL Enterprise Plus-Instanzen.

REST

Mit dem folgenden Befehl wird Ihre Instanz auf die Cloud SQL Enterprise-Edition aktualisiert und ein Neustartvorgang ausgelöst.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

PROJECT_ID: Die Projekt-ID der Instanz, die Sie aktualisieren möchten.
INSTANCE_ID: Die Instanz-ID der Instanz, die Sie aktualisieren möchten.
MACHINE_TYPE: Der Maschinentyp der Instanz, auf die Sie ein Upgrade ausführen möchten. Weitere Informationen zu Maschinentypen für Cloud SQL Enterprise Plus finden Sie unter Maschinentypen für Cloud SQL Enterprise Plus-Instanzen.

Hinweis: Cloud SQL aktiviert den Daten-Cache für Ihre Instanz während des Upgrades standardmäßig. Sie können sie deaktivieren, indem Sie den Parameter dataCacheEnabled als false festlegen.

HTTP-Methode und URL:

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

JSON-Text anfordern:

{
  "settings": {
      "tier": "MACHINE_TYPE",
      "edition": "ENTERPRISE_PLUS",
      "dataCacheConfig": {
        "dataCacheEnabled": true
      },
  }
}

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

curl (Linux, macOS oder Cloud Shell)

Hinweis: 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 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_ID"

PowerShell (Windows)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. 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 PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

Sie sollten in etwa folgende JSON-Antwort erhalten:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

Mit dem folgenden Befehl wird Ihre Instanz auf die Cloud SQL Enterprise-Edition aktualisiert und ein Neustartvorgang ausgelöst.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

PROJECT_ID: Die Projekt-ID der Instanz, die Sie aktualisieren möchten.
INSTANCE_ID: Die Instanz-ID der Instanz, die Sie aktualisieren möchten.
MACHINE_TYPE: Der Maschinentyp der Instanz, auf die Sie ein Upgrade ausführen möchten. Weitere Informationen zu Maschinentypen für Cloud SQL Enterprise Plus finden Sie unter Maschinentypen für Cloud SQL Enterprise Plus-Instanzen.

HTTP-Methode und URL:

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

JSON-Text anfordern:

{
  "settings": {
      "tier": "MACHINE_TYPE",
      "edition": "ENTERPRISE_PLUS",
      "dataCacheConfig": {
        "dataCacheEnabled": true
      },
  }
}

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

curl (Linux, macOS oder Cloud Shell)

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

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_ID"

PowerShell (Windows)

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 PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

Sie sollten in etwa folgende JSON-Antwort erhalten:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Speicherort der für PITR verwendeten Transaktionslogs

Wenn Ihre Cloud SQL Enterprise Edition-Instanz Transaktionslogs für PITR auf dem Laufwerk speichert, wird beim Starten des Upgrade-Prozesses auf Cloud SQL Enterprise Plus der Speicherort dieser Logs auf Cloud Storage geändert.

Für den Ortswechsel gelten die folgenden Bedingungen:

Der Vorgang dauert ungefähr die Dauer der PITR-Konfigurationseinstellung transactionLogRetentionDays, um den Wechsel zu Cloud Storage abzuschließen.
Wenn Sie für Ihre Instanz Werte für das Flag expire_logs_days oder binlog_expire_logs_seconds festgelegt haben, werden diese Werte beibehalten.
Beim Wechsel zu Cloud Storage können Sie die Werte für die Flags expire_logs_days oder binlog_expire_logs_seconds auf Ihrer Instanz nicht ändern.
Während der Umstellung auf Cloud Storage empfehlen wir, die PITR-Konfigurationseinstellung transactionLogRetentionDays nicht zu ändern. Selbst wenn Sie transactionLogRetentionDays erhöhen, werden binäre Logs nicht länger als den Standardwert von 7 Tagen auf einer Cloud SQL Enterprise-Instanz aufbewahrt.
Während des Wechsels speichert Cloud SQL Logs auf dem Laufwerk nur für den Mindestwert eines der folgenden Werte:
- die PITR-Konfigurationseinstellung transactionLogRetentionDays von vor der Umstellung, standardmäßig 7 Tage
- die Flags expire_logs_days oder binlog_expire_logs_seconds, die für Ihre Instanz manuell festgelegt wurden
Nach der Umstellung behält Cloud SQL die gleiche Anzahl an binären Logs auf dem Laufwerk bei, die Sie vor dem Wechsel hatten. Es sei denn, Sie haben die expire_logs_days- oder binlog_expire_logs_seconds-Flags in Ihrer Instanz festgelegt. Wenn Sie diese Flags festgelegt haben, speichert Cloud SQL binäre Logs auf dem Laufwerk anhand des Mindestwerts der Konfigurationseinstellung transactionLogRetentionDays oder des Werts der Flags.

Standardeinstellungen für Sicherungen und Logspeicher von Cloud SQL Enterprise Plus

Nach dem Wechsel zu Cloud Storage für eine Instanz speichert Cloud SQL weiterhin Kopien binärer Logs auf dem Laufwerk zu Replikationszwecken. Das Speichern von binären Logs auf einem Laufwerk kann nützlich sein, wenn Sie binäre Logs mit dem Dienstprogramm mysqlbinlog durchsuchen möchten.

Wenn Sie die Flags expire_logs_days und binlog_expire_logs_seconds vor dem Upgrade für Ihre Instanz konfiguriert haben, bleiben die konfigurierten Werte intakt.

Da die binären Logs, die zur Ausführung von PITR verwendet werden, nach der Umstellung jetzt in Cloud Storage gespeichert werden, prüfen Sie, ob die Werte der Flags die Aufbewahrung der Transaktionslogs auf dem erwarteten Laufwerk widerspiegeln. Cloud SQL speichert Logs auf dem Laufwerk nur für den Mindestwert einer der folgenden Optionen:

die PITR-Konfigurationseinstellung transactionLogRetentionDays vor der Umstellung, standardmäßig 7 Tage
die Flags expire_logs_days oder binlog_expire_logs_seconds, die für Ihre Instanz manuell festgelegt wurden

Wenn Sie Speicherplatz sparen möchten, konfigurieren Sie nach Abschluss des Upgrades den Wert des Flags expire_logs_days oder binlog_expire_logs_seconds auf den Wert von 1 Tag, damit Sie die zugewiesene Laufwerkgröße und Laufwerksspeicherkosten reduzieren können. Weitere Informationen zum Speicher des Transaktionslogs und zu PITR finden Sie unter Logspeicher für PITR.

Nach Abschluss des Upgrades auf Cloud SQL Enterprise Plus wird die standardmäßige Aufbewahrungsdauer für Transaktionslogs für alle aktualisierten Instanzen auf 14 Tage erhöht. Bei dieser Erhöhung und jeder anderen Erhöhung, die Sie für die Aufbewahrungsdauer des Transaktionslogs konfigurieren, dauert es bis zum neuen und erhöhten Wert, bis das volle Aufbewahrungsfenster von PITR erreicht wird. Beispiel: Wenn der alte Wert für die Aufbewahrung von Transaktionslogs 7 Tage beträgt und der neue Wert auf 14 erhöht wird, beträgt das Zeitfenster für PITR in den ersten 7 Tagen nach dem Upgrade nur 7 Tage. Am 8. Tag beträgt das Zeitfenster für PITR 8 Tage, am 9. Tag werden es dann 9 Tage, bis das Aufbewahrungsfenster schließlich auf 14 Tage am 14. Tag erhöht wird.

Außerdem wird die Standardanzahl automatischer Sicherungen von 8 auf 15 erhöht.

Wenn Sie nach einem Upgrade der Hauptversion ein Upgrade auf Cloud SQL Enterprise Plus ausführen, können Sie PITR nicht zu einem Zeitpunkt ausführen, der vor dem Upgrade der Hauptversion liegt. Diese Beschränkung gilt auch dann, wenn die Aufbewahrungsdauer diesen Zeitraum abdeckt. Sie können Ihre Instanz auf den Stand eines bestimmten Zeitpunkts wiederherstellen, nachdem Sie das Upgrade der Hauptversion gestartet haben.

Zur Cloud SQL Enterprise-Edition wechseln

Console

Wechseln Sie in der Google Cloud Console zur Seite Cloud SQL-Instanzen.

Cloud SQL-Instanzen aufrufen
Klicken Sie auf den Instanznamen, um die Übersichtsseite einer Instanz zu öffnen.
Klicken Sie auf Bearbeiten.
Klicken Sie im Abschnitt Cloud SQL-Version auswählen auf Zu Enterprise wechseln.
Geben Sie im Bereich Zu Enterprise wechseln Ihre Instanz-ID ein und klicken Sie dann auf Version wechseln.

Alternativ können Sie zur Cloud SQL Enterprise-Version wechseln. Klicken Sie dazu auf der Seite Übersicht im Abschnitt Konfiguration auf Zu Enterprise wechseln.

gcloud

Im folgenden Codebeispiel wird gezeigt, wie Sie Ihre Instanz auf die Cloud SQL Enterprise-Edition umstellen:

gcloud sql instances patch INSTANCE_ID \
  --edition=enterprise \
  --tier=MACHINE_TYPE \
  --project=PROJECT_ID

Dabei gilt:

PROJECT_ID: Die Projekt-ID der Instanz.
INSTANCE_ID: Der Name der Instanz.
MACHINE_TYPE: Der Maschinentyp der Instanz, zu der Sie wechseln möchten. Weitere Informationen zu Maschinentypen für Cloud SQL Enterprise Edition finden Sie unter Maschinentypen für Cloud SQL Enterprise Edition-Instanzen.

REST

Mit dem folgenden Befehl wechseln Sie zur Cloud SQL Enterprise-Edition und lösen einen Neustartvorgang aus.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

PROJECT_ID: Die Projekt-ID der Instanz.
INSTANCE_ID: Die Instanz-ID der Instanz.
MACHINE_TYPE: Der Maschinentyp der Instanz, zu der Sie wechseln möchten. Weitere Informationen zu Maschinentypen für Cloud SQL Enterprise Edition finden Sie unter Maschinentypen für Cloud SQL Enterprise Edition-Instanzen.

HTTP-Methode und URL:

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

JSON-Text anfordern:

{
  "settings": {
      "tier": "MACHINE_TYPE",
      "edition": "ENTERPRISE"
  }
}

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

curl (Linux, macOS oder Cloud Shell)

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

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_ID"

PowerShell (Windows)

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 PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

Sie sollten in etwa folgende JSON-Antwort erhalten:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

Mit dem folgenden Befehl wechseln Sie zur Cloud SQL Enterprise-Edition und lösen einen Neustartvorgang aus.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

PROJECT_ID: Die Projekt-ID der Instanz.
INSTANCE_ID: Die Instanz-ID der Instanz.
MACHINE_TYPE: Der Maschinentyp der Instanz, zu der Sie wechseln möchten. Weitere Informationen zu Maschinentypen für Cloud SQL Enterprise Edition finden Sie unter Maschinentypen für Cloud SQL Enterprise Edition-Instanzen.

HTTP-Methode und URL:

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

JSON-Text anfordern:

{
  "settings": {
      "tier": "MACHINE_TYPE",
      "edition": "ENTERPRISE"
  }
}

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

curl (Linux, macOS oder Cloud Shell)

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

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_ID"

PowerShell (Windows)

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 PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

Sie sollten in etwa folgende JSON-Antwort erhalten:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Standardeinstellungen für Sicherungen und Logspeicher der Cloud SQL Enterprise Edition

Durch die Änderung zur Cloud SQL Enterprise-Version wird der Speicherort der für PITR verwendeten Transaktionslogs nicht geändert. Wenn Ihre Cloud SQL Enterprise Plus-Instanz ihre Transaktionslogs für PITR in Cloud Storage speichert, bleiben die Logs in Cloud Storage. Anstatt jedoch standardmäßig Transaktionslogs für 14 Tage für PITR zu speichern, ändert sich der Standardwert auf 7 Tage.0 Die Sicherungskonfiguration wird nicht geändert.

Nächste Schritte

Weitere Informationen zur Cloud SQL Enterprise Plus-Edition