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 Umstellen 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 PostgreSQL-Versionen.
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 Upgrade-Prozess dauert einige Minuten und ist nahezu ohne Ausfallzeit. Der Wechsel zur Cloud SQL Enterprise-Version kann bis zu 60 Sekunden dauern.
Darüber hinaus müssen Sie bei diesem Upgrade die Endpunkte der Anwendungen nicht ändern, mit denen sie verbunden sind.
Hinweise
Prüfen Sie, ob Sie eine Cloud SQL Enterprise Edition-Instanz auf PostgreSQL 12 oder höher ausführen.
Wenn Ihre Instanz eine ältere Version von PostgreSQL verwendet, müssen Sie Ihre Instanz auf PostgreSQL 12 oder höher aktualisieren. Weitere Informationen finden Sie unter Direkte Datenbankaktualisierung durchführen.
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 Write-Ahead-Logs speichert, die für PITR auf dem Laufwerk verwendet werden, wechselt der Upgradeprozess auf die Cloud SQL Enterprise Plus-Version den Speicherort der Write-Ahead-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 Write-Ahead-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.
- 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
Optional können Sie auch den Daten-Cache für Ihre Instanz aktivieren, indem Sie das Flag --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.
Optional: Sie können den Daten-Cache aktivieren, indem Sie den Parameter dataCacheEnabled
auf true
setzen.
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:
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.
Optional: Sie können den Daten-Cache aktivieren, indem Sie den Parameter dataCacheEnabled
auf true
setzen.
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:
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. - Während der Umstellung auf Cloud Storage sollten Sie die PITR-Konfigurationseinstellung
transactionLogRetentionDays
nicht ändern. Selbst wenn SietransactionLogRetentionDays
erhöhen, werden Write-Ahead-Logs nicht länger als den Standardwert von 7 Tagen auf einer Cloud SQL Enterprise-Instanz aufbewahrt.
Standardeinstellungen für Sicherung und Logspeicher von Cloud SQL Enterprise Plus
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.
- 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
- 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:
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:
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.