Upgrade der Datenbank-Nebenversion ausführen

MySQL   |  PostgreSQL   |  SQL Server

Auf dieser Seite wird beschrieben, wie Sie die Datenbank-Nebenversion einer Instanz festlegen. Unterstützte Versionen finden Sie unter Datenbankversionen und Versionsrichtlinien.

Hinweis: Informationen zum Upgrade der Hauptdatenbankversion finden Sie unter MySQL-Hauptversion für eine Instanz aktualisieren.

Mit jeder neuen Nebenversion veröffentlichen Datenbankanbieter neue Features, Sicherheitspatches, Fehlerkorrekturen und Leistungsverbesserungen. Darüber hinaus aktualisiert Cloud SQL während der Wartung regelmäßig Ihre Nebenversion.

MySQL 8.0 unterstützt jedoch kein Downgrade. Deshalb werden Upgrades von Nebenversionen nicht automatisch in die routinemäßige Wartung einbezogen. Sie können die Nebenversion für Cloud SQL for MySQL 8.0 beim Erstellen einer Instanz oder später durch einen Upgradeprozess angeben. Beide Vorgänge werden auf dieser Seite beschrieben.

Machen Sie sich mit den Änderungen vertraut, bevor Sie auf eine neue MySQL 8.0-Nebenversion aktualisieren. Siehe Versionshinweise für MySQL 8.0. Wenn Sie Cloud SQL for MySQL 5.6 oder 5.7 verwenden, verwaltet Cloud SQL automatisch die Nebenversion Ihrer Instanz. Wenn Sie eine neue Instanz bereitstellen, konfiguriert Cloud SQL Ihre Instanz automatisch mit der neuesten verfügbaren Datenbankversion. Während der routinemäßigen Wartung aktualisiert Cloud SQL Ihre Instanz automatisch auf die neueste unterstützte Version.

Zum Aktualisieren der Datenbank-Nebenversion Ihrer MySQL 8.0-Instanz müssen Sie Ihre Instanz mit Ihrer bevorzugten Nebenversion aktualisieren. Diese muss größer sein als die derzeit installierte Nebenversion. Sie können eine nicht angegebene Nebenversion nicht wiederherstellen, nachdem eine Instanz bereitgestellt wurde.

Vor dem Aktualisieren

In MySQL 8.0 sind keine Downgrades zulässig. Führen Sie vor dem Upgrade Ihrer primären Instanz die folgenden Schritte aus, damit Ihre Daten sicher sind.

1. Testen Sie das Upgrade in einer Staging-Umgebung.

   1. Erstellen Sie einen Klon der Produktionsinstanz, der als Staging-Instanz dient. Dadurch wird eine neue Datenbankinstanz mit denselben Haupt- und Nebenversionen erstellt.

   2. Führen Sie ein Upgrade einer Nebenversion auf der Staging-Instanz durch.

   3. Führen Sie Arbeitslasttests durch, um zu prüfen, ob das Upgrade erfolgreich war und Ihre Anwendung wie erwartet funktioniert. Wenn die Tests erfolgreich sind, fahren Sie mit dem Upgrade der Lesereplikatinstanzen fort.

2. Aktualisieren Sie Ihre Lesereplikate.

   1. Aktualisieren Sie alle Lesereplikate in der Datenbank auf die Zielnebenversion.

   2. Prüfen Sie, ob Ihre Anwendung wie erwartet funktioniert.

3. Sichern Sie Ihre primäre Instanz.

   Wie bei jedem wichtigen Datenbankupdate sollten Sie eine Sicherung Ihrer primären Instanz erstellen.

Nebenversion aktualisieren

Sie können die Datenbank-Nebenversion einer vorhandenen Instanz mit gcloud oder der REST API angeben. Führen Sie Upgrades von Nebenversionen durch, wenn die Datenbank nicht verwendet wird. Die Instanz wird während des Vorgangs neu gestartet, was zu Ausfallzeiten führt. Wenn die aktuell installierte Version höher als die angeforderte Version ist, wird die Anfrage abgelehnt.

Hinweis: Gleichzeitige Aktualisierungen wie die Aktualisierung der Laufwerkgröße oder des Arbeitsspeichers einer Instanz sind beim Upgrade der Datenbank-Nebenversion nicht zulässig.

gcloud

Führen Sie den Befehl gcloud sql instances patch mit dem Flag --database-version aus.

Ersetzen Sie vor dem Ausführen des Befehls die folgenden Variablen:

• INSTANCE_NAME: Name der Instanz
• DATABASE_VERSION: Die Datenbankversion der Instanz. Wenn Sie dieses Flag nicht angeben, wird die Standardhauptversion verwendet.

gcloud sql instances patch INSTANCE_NAME \
--database-version=DATABASE_VERSION

REST Version 1

Verwenden Sie eine PATCH-Anfrage mit der Methode instances:patch und dem Flag databaseVersion.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

• PROJECT-ID: die Projekt-ID
• INSTANCE-ID: die Instanz-ID
• DATABASE_VERSION: Die Datenbankversion, auf die aktualisiert werden soll.

HTTP-Methode und URL:

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT-ID/instances/INSTANCE-ID

JSON-Text anfordern:

{
  "databaseVersion": "DATABASE_VERSION"
}

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://content-sqladmin.googleapis.com/v1/projects/PROJECT-ID/instances/INSTANCE-ID",
  "status": "PENDING",
  "user": "[e-mail]",
  "insertTime": "2022-07-17T20:23:15.540Z",
  "operationType": "UPDATE",
  "name": "fa3f7304-ccf6-4d2f-a6f5-24df00000032",
  "targetId": "INSTANCE-ID",
  "selfLink": "https://content-sqladmin.googleapis.com/v1/projects/PROJECT-ID/operations/fa3f7304-ccf6-4d2f-a6f5-24df00000032",
  "targetProject": "PROJECT-ID"
}

REST v1beta4

Verwenden Sie eine PATCH-Anfrage mit der Methode instances:patch und dem Flag databaseVersion.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

• PROJECT-ID: die Projekt-ID
• INSTANCE-ID: die Instanz-ID
• DATABASE_VERSION: Die Datenbankversion, auf die aktualisiert werden soll.

HTTP-Methode und URL:

 https://sqladmin.googleapis.com/v1beta4/projects/PROJECT-ID/instances/INSTANCE-ID

JSON-Text anfordern:

{
  "databaseVersion": "DATABASE_VERSION"
}

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  \
     -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)

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  `
    -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 eine JSON-Antwort ähnlich wie diese erhalten:

{
  "kind": "sql#operation",
  "targetLink": "https://content-sqladmin.googleapis.com/v1beta4/projects/PROJECT-ID/instances/INSTANCE-ID",
  "status": "PENDING",
  "user": "[e-mail]",
  "insertTime": "2022-07-17T20:23:15.540Z",
  "operationType": "UPDATE",
  "name": "fa3f7304-ccf6-4d2f-a6f5-24df00000032",
  "targetId": "INSTANCE-ID",
  "selfLink": "https://content-sqladmin.googleapis.com/v1beta4/projects/PROJECT-ID/operations/fa3f7304-ccf6-4d2f-a6f5-24df00000032",
  "targetProject": "PROJECT-ID"
}

Installierte Datenbank-Nebenversion prüfen

Wenn Sie sich die zusammenfassenden Informationen zur Instanz ansehen, ist im Abschnitt "Konfiguration" die installierte Datenbank-Nebenversion sichtbar.

Rollback eines Upgrade durchführen

Wenn Sie beim Testen eines Upgrades ein Problem feststellen, möchten Sie möglicherweise ein Rollback Ihrer Datenbank durchführen, um die Datenbankinstanz wiederherzustellen, auf der die vorherige Nebenversion ausgeführt wird.

Führen Sie die folgenden Schritte aus, um eine Sicherung von vor dem Upgrade wiederherzustellen:

1. Stellen Sie eine Wiederherstellungsdatenbankinstanz auf der vorherigen Nebenversion bereit.
2. Konfigurieren Sie die Einstellungen für die Wiederherstellungsdatenbankinstanz vor dem Upgrade.
3. Stellen Sie die Sicherung von vor dem Upgrade auf der Wiederherstellungsinstanz wieder her.

Hinweis: Beim Wiederherstellen einer Instanz aus einer Sicherung auf einer Zielinstanz wird die installierte Version der Sicherung mit der installierten Version der Zieldatenbankinstanz verglichen. Da MySQL 8.0 keine Downgrades zulässt, wird die Wiederherstellungsanfrage abgelehnt, wenn die Sicherung eine höhere installierte Version als das Ziel hat.

Als Alternative zur Wiederherstellung einer Sicherung können Sie eine Wiederherstellung zu einem bestimmten Zeitpunkt durchführen und eine neue Instanz erstellen.