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 Ihre Instanz auf MySQL 8.0.31 oder höher aktualisieren. 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 (PITR) aktiviert. Wenn die zu aktualisierende Cloud SQL Enterprise-Instanz die binären Logs speichert, die für PITR auf dem Laufwerk verwendet werden, wechselt der Upgradeprozess auf die Cloud SQL Enterprise Plus-Version den Speicherort der binären Logs von Laufwerk zu Cloud Storage.

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

Weitere Informationen zum Ändern des Speicherorts für das Transaktionsprotokoll beim Upgrade finden Sie unter Speicherort von Transaktionslogs, die für die Wiederherstellung zu einem bestimmten Zeitpunkt verwendet werden.

Upgrade einer Instanz auf Cloud SQL Enterprise Plus ausführen

Folgen Sie der Anleitung in diesem Abschnitt, um ein Upgrade einer Cloud SQL Enterprise-Edition-Instanz auf eine Cloud SQL Enterprise Plus-Version durchzuführen.

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

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

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 bei der gcloud-Befehlszeile angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud-Befehlszeile 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 bei 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-Instanz Transaktionslogs für PITR auf dem Laufwerk speichert, wird beim Starten des Upgrades auf Cloud SQL Enterprise Plus der Speicherort dieser Logs auf Cloud Storage umgestellt.

Für den Ortswechsel gelten die folgenden Bedingungen:

Der Vorgang dauert ungefähr die Dauer der PITR-Konfigurationseinstellung transactionLogRetentionDays, um die Umstellung auf Cloud Storage abzuschließen.
Wenn Sie Werte für expire_logs_days oder das Flag binlog_expire_logs_seconds für Ihre Instanz, dann diese bleiben erhalten.
Während der Umstellung auf 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 sollten Sie die PITR-Konfigurationseinstellung transactionLogRetentionDays nicht ä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.
Wenn der Schalter werden in Cloud SQL nur Logs auf dem Laufwerk für den Mindestwert eines der folgenden Werte gespeichert:
- 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 basierend auf dem Mindestwert der Konfigurationseinstellung transactionLogRetentionDays oder dem Wert der Flags.

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

Nachdem der Wechsel zu Cloud Storage für eine Instanz abgeschlossen ist, speichert Cloud SQL weiterhin Kopien binärer Logs zu Replikationszwecken auf dem Laufwerk. Das Speichern binärer 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 auf Ihrer Instanz konfiguriert haben, bleiben die konfigurierten Werte erhalten.

Da die binären Logs, die zum Ausführen von PITR verwendet werden, nach der Umstellung jetzt in Cloud Storage gespeichert werden, müssen die Werte der Flags die Aufbewahrung von Transaktionslogs auf dem erwarteten Laufwerk widerspiegeln. Cloud SQL speichert Logs auf dem Laufwerk nur für einen der folgenden Mindestwert:

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 Speichern von Transaktionslogs und 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. Für diese Erhöhung und jede andere Erhöhung, die Sie für die Aufbewahrungsdauer des Transaktionslogs konfigurieren, muss der neue und erhöhte Wert erreicht werden, um das vollständige Aufbewahrungsdauer von PITR zu erreichen. 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.

Darüber hinaus 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 für einen 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 einen bestimmten Zeitpunkt nach dem Start des Upgrades der Hauptversion wiederherstellen.

Zur Cloud SQL Enterprise-Version 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-Edition wechseln. Klicken Sie dazu auf der Seite Übersicht der Instanz 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

Ersetzen Sie Folgendes:

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 Sicherungs- und Logspeicher von Cloud SQL Enterprise Edition

Beim Wechsel zur Cloud SQL Enterprise-Version wird der Speicherort der Transaktionslogs nicht geändert, die für PITR verwendet wurden. Wenn Ihre Cloud SQL Enterprise Plus-Instanz ihre Transaktionslogs für PITR in Cloud Storage speichert, verbleiben 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