Wartungsfenster suchen und einrichten

Auf dieser Seite werden Vorgehensweisen beschrieben, mit denen Sie Wartungsfenster für Cloud SQL-Instanzen ermitteln und einrichten. Weitere Informationen darüber, wie und warum Cloud SQL Wartungsarbeiten durchführt, finden Sie unter Cloud SQL-Instanzen warten – Übersicht.

Hinweis

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.

  4. Install the Google Cloud CLI.

  5. To initialize the gcloud CLI, run the following command: 

    gcloud init

  6. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  7. Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.

  8. Install the Google Cloud CLI.

  9. To initialize the gcloud CLI, run the following command: 

    gcloud init

Bevorzugtes Wartungsfenster für eine Instanz festlegen

Console

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

    Cloud SQL-Instanzen aufrufen

  2. Klicken Sie auf den Instanznamen, um die Seite Übersicht einer Instanz zu öffnen.
  3. Klicken Sie im Abschnitt Wartung auf Wartungseinstellungen bearbeiten.
  4. Wählen Sie im Abschnitt Konfigurationsoptionen die Option Wartung aus.
  5. Konfigurieren Sie die folgenden Optionen:
    • Bevorzugtes Fenster: Legen Sie den Tag- und Stundenbereich fest, in dem Aktualisierungen für diese Instanz vorgenommen werden können.
    • Aktualisierungsreihenfolge: Legen Sie die Aktualisierungsreihenfolge für diese Instanz in Bezug auf Aktualisierungen anderer Instanzen fest. Geben Sie als Zeitpunkt Beliebig, Früher oder Später an. Instanzen, die die Einstellung Früher verwenden, erhalten Aktualisierungen bis zu eine Woche früher als Instanzen mit der Einstellung Später, wenn Instanzen am gleichen Speicherort verglichen werden.

gcloud

Bevor Sie den unten aufgeführten gcloud-Befehl verwenden, ersetzen Sie die folgenden Werte:

  • instance-id: Neu zu planende Instanz.
  • day: Tag, an dem die Wartung durchgeführt werden soll. Legen Sie einen der folgenden Werte fest: SUN, MON, TUE, WED, THU, FRI, SAT.
  • hour: Tageszeit des Wartungsfensters, in UTC-Zeitzone (1-24).
gcloud sql instances patch instance-id \
--maintenance-window-day=day \
--maintenance-window-hour=hour
Weitere Informationen finden Sie unter gcloud sql instances patch.

Wenn Sie Änderungen an der Einstellung des Wartungsfensters vornehmen, während die Instanz bereits gewartet wird oder gewartet wird, werden die Änderungen nicht sofort wirksam. Diese Änderungen werden in zukünftigen Wartungsereignissen berücksichtigt.

Wenn Sie Wartungsbenachrichtigungen aktiviert haben, sendet Cloud SQL Ihnen Benachrichtigungen mit dem genauen Datum und der Uhrzeit, wenn eine Wartung geplant ist. Cloud SQL sendet diese Benachrichtigungen auf der Grundlage der Wartungsfenster, die in der Instanz festgelegt sind:

  • Wenn die Reihenfolge der Aktualisierungseinstellung auf Earlier festgelegt ist, sendet Cloud SQL mindestens eine Woche im Voraus Wartungsbenachrichtigungen.
  • Wenn die Reihenfolge der Aktualisierungseinstellung auf Later gesetzt ist, sendet Cloud SQL Wartungsbenachrichtigungen mindestens zwei Wochen im Voraus.

Wartungsbenachrichtigungen aktivieren

Bevor Sie Wartungsbenachrichtigungen aktivieren, müssen Sie ein bevorzugtes Wartungsfenster für eine Instanz festlegen.

  1. Öffnen Sie die Seite Kommunikation. Zu Kommunikation gehen
  2. Wählen Sie in der Zeile für Cloud SQL, Wartungsfenster das Optionsfeld unter E-Mail aus, um diese Option zu aktivieren.

Jeder Nutzer, der Benachrichtigungen erhalten muss, muss separat aktiviert werden.

Wartungsbenachrichtigungen in der Google Cloud Console suchen

Sie können sich in der Cloud Console an einigen Stellen Wartungsbenachrichtigungen anzeigen lassen:

  • Suchen Sie im Dashboard AKTIVITÄT nach Instanzen, die mit SQL-Wartung gekennzeichnet sind.
    Zu "Aktivität"

  • Wenn eine Instanz für die Wartung geplant ist, wird das Datum für die Wartung auf der Seite Instanzen in der Spalte Wartung aufgeführt. Die Spalte Wartung ist normalerweise ausgeblendet. Sie wird jedoch automatisch angezeigt, wenn Wartungsarbeiten geplant sind. Sie können in den Spaltenanzeigeoptionen (Das Symbol für die Spaltenanzeigeoptionen besteht aus drei Linien) auch Wartung auswählen, wenn die Spalte Wartung immer angezeigt werden soll.

  • Alternativ können Sie eine Instanz auswählen, um zur Seite Instanzendetails zu gelangen. Wenn für die Instanz Wartungsarbeiten geplant sind, wird im Bereich Wartung eine Nachricht angezeigt.
    Zu "Cloud SQL-Instanzen"

Geplante Wartungsfenster mit der API suchen

gcloud

Bevor Sie den unten aufgeführten gcloud-Befehl verwenden, ersetzen Sie die folgenden Werte:

  • instance-id: Neu zu planende Instanz.
gcloud sql instances describe instance-id

Suchen Sie in der Antwort nach dem Feld scheduledMaintenance.

REST Version 1

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • PROJECT_ID: die ID oder Projektnummer des Google Cloud-Projekts, das die Instanz enthält
  • INSTANCE_NAME: der Name der Instanz, die Sie für Hochverfügbarkeit konfigurieren

HTTP-Methode und URL:

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

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

Sie sollten in etwa folgende JSON-Antwort erhalten:

{
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "POSTGRES_13"
}

Suchen Sie in der Antwort nach dem Feld scheduledMaintenance.

REST v1beta4

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • PROJECT_ID: die ID oder Projektnummer des Google Cloud-Projekts, das die Instanz enthält
  • INSTANCE_NAME: der Name der Instanz, die Sie für Hochverfügbarkeit konfigurieren

HTTP-Methode und URL:

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

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

Sie sollten in etwa folgende JSON-Antwort erhalten:

{
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "POSTGRES_13"
}

Suchen Sie in der Antwort nach dem Feld scheduledMaintenance.

Geplante Wartung verschieben

Sie können die Wartung mit der Google Cloud Console, gcloud oder der Cloud SQL Admin API verschieben.

Console

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

    Cloud SQL-Instanzen aufrufen

  2. Filtern Sie nach dem Begriff Wartung, um alle Instanzen aufzulisten, die gewartet werden sollen.
  3. Klicken Sie in der Spalte Wartung auf Termin verschieben.
  4. Wählen Sie im Dialogfeld Termin verschieben, ob die Wartung sofort durchgeführt werden soll, ob sie zu einem bestimmten Zeitpunkt innerhalb des 28-tägigen Aufschubzeitraums erfolgen soll oder ob sie auf das nächste verfügbare Wartungsfenster verschoben werden soll.

gcloud

Bevor Sie den unten aufgeführten gcloud-Befehl verwenden, ersetzen Sie die folgenden Werte:

  • instance-id: Neu zu planende Instanz.
  • reschedule-type: Verwenden Sie eine der folgenden Optionen: IMMEDIATE, NEXT_AVAILABLE_WINDOW oder SPECIFIC_TIME.

    Wenn Sie NEXT_AVAILABLE_WINDOW auswählen, wird die Wartung auf das nächste verfügbare Wartungsfenster nach dem aktuellen geplanten Zeitpunkt verschoben.

  • reschedule-time: Wenn Sie für reschedule-type die Option SPECIFIC_TIME auswählen, müssen Sie dieses Flag setzen, um den neuen Tag und die neue Uhrzeit für die Wartung festzulegen. Verwendet das ISO 8601-Format. Beispiel: 2020-01-16T16:56:00.000Z.
gcloud sql reschedule-maintenance instance-id \
--reschedule-type=reschedule-type \
[--schedule-time=reschedule-time]
Weitere Informationen finden Sie unter gcloud sql reschedule-maintenance.

Wenn Sie die Wartung bis zu 28 Tage verschieben möchten, prüfen Sie die Versionsnummer von gcloud. Wenn die Versionsnummer kleiner als 390.0.0_RC00 ist, installieren Sie gcloud neu.

REST Version 1

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • project-id: die Projekt-ID
  • instance-id: die Instanz-ID
  • reschedule-type: Verwenden Sie eine der folgenden Optionen: IMMEDIATE, NEXT_AVAILABLE_WINDOW oder SPECIFIC_TIME.

    Wenn Sie NEXT_AVAILABLE_WINDOW auswählen, wird die Wartung auf das nächste verfügbare Wartungsfenster verschoben.

HTTP-Methode und URL:

POST https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/rescheduleMaintenance

JSON-Text anfordern:

{
  "reschedule": {
    "reschedule_type": "reschedule-type"
  }
}

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",
  "startTime": "08:00",
  "endTime": "08:01",
  "operationType": RESCHEDULE_MAINTENANCE,
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

REST v1beta4

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • project-id: die Projekt-ID
  • instance-id: die Instanz-ID
  • reschedule-type: Verwenden Sie eine der folgenden Optionen: IMMEDIATE, NEXT_AVAILABLE_WINDOW oder SPECIFIC_TIME.

    Wenn Sie NEXT_AVAILABLE_WINDOW auswählen, wird die Wartung auf das nächste verfügbare Wartungsfenster verschoben.

HTTP-Methode und URL:

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/rescheduleMaintenance

JSON-Text anfordern:

{
  "reschedule": {
    "reschedule_type": "reschedule-type"
  }
}

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/sql/v1beta4/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "startTime": "08:00",
  "endTime": "08:01",
  "operationType": RESCHEDULE_MAINTENANCE,
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

Informationen zum Aufbau der zugrunde liegenden REST API-Anfrage für diese Aufgabe finden Sie im APIs Explorer auf der Seite zu instances:post.

Zeitraum für den Wartungsausschluss konfigurieren

Sie können für jede Cloud SQL-Instanz immer genau einen Zeitraum für den Wartungsausschluss konfigurieren. Der Zeitraum für den Wartungsausschluss hat Vorrang vor einem planmäßigen Wartungsfenster. Wenn ein Konflikt zwischen dem Zeitpunkt eines Wartungsfensters und dem Wartungsausschluss besteht, überschreibt der Wartungsausschluss das Wartungsfenster.

Sie können solch einen Zeitraum manuell entfernen, unabhängig davon, ob er bereits vorbei ist oder nicht.

Um einen Zeitraum für den Wartungsausschluss zu konfigurieren, legen Sie hierfür das Startdatum, das Enddatum und die jeweilige Tageszeit fest. Dieser Zeitraum kann 1 bis zu 90 Tage lang sein.

Für das Start- und Enddatum stehen zwei Formate zur Verfügung:

  • yyyy-mm-dd: gibt ein bestimmtes Datum an
  • mm-dd: gibt ein jährlich wiederkehrendes Datum an

Start- und Enddatum werden im UTC-Format angegeben. Verwenden Sie zum Festlegen der Zeitzone das Zeitfeld und passen Sie hier die Startzeit an. Beispiel: Das Startdatum = 2020-10-10 und die Uhrzeit = 07:00:00 gibt an, dass der Startzeitpunkt 07:00 Uhr (UTC) am 10. 10. 2020 ist. PST)

Das Format für die Uhrzeit ist HH:mm:SS.

  • Der Wert für Stunden muss im Bereich von 0 bis 23 liegen.
  • Die Werte für Minuten und Sekunden liegen im Bereich von 0 bis 59.

Console

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

    Cloud SQL-Instanzen aufrufen

  2. Klicken Sie auf den Instanznamen, um die Seite Übersicht einer Instanz zu öffnen.
  3. Klicken Sie im Abschnitt Wartung auf Wartungseinstellungen bearbeiten.
  4. Legen Sie im Abschnitt Wartungsausschluss – Dauer das Start- und Enddatum fest.
  5. Wählen Sie im Abschnitt Erweiterte Optionen optional Jedes Jahr wiederholen aus.
  6. Klicken Sie auf Speichern.

gcloud

Bevor Sie den unten aufgeführten gcloud-Befehl verwenden, ersetzen Sie die folgenden Werte:

  • instance-id: Cloud SQL-Instanz-ID
  • start-date: Datum, an dem der Zeitraum beginnt. Beispiel: 2021-11-29
  • end-date: Datum, an dem der Zeitraum endet. Beispiel: 2021-12-02
  • time: Tageszeit für Start und Ende des Zeitraums. Beispiel: 00:00:00
gcloud sql instances patch instance-id\
 --deny-maintenance-period-start-date=start-date \
 --deny-maintenance-period-end-date=end-date \
 --deny-maintenance-period-time=time

REST Version 1

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • project-id: die Projekt-ID
  • instance-id: die Instanz-ID
  • start-date: das Startdatum (JJJJ-MM-TT) oder (MM-TT) bei jährlicher Wiederholung
  • end-date: das Enddatum (JJJJ-MM-TT) oder (MM-TT) bei jährlicher Wiederholung
  • time: die Start- und Endzeit (HH:MM:SS)

HTTP-Methode und URL:

POST https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id

JSON-Text anfordern:

{
  "settings":
  {
    "denyMaintenancePeriods": [{
      "start_date": "start-date",
      "end_date": "end-date"
      "time": "time"
    }]
  }
}

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",
  "startTime": "08:00",
  "endTime": "08:01",
  "operationType": MAINTENANCE_DENY_PERIOD,
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

REST v1beta4

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • project-id: die Projekt-ID
  • instance-id: die Instanz-ID
  • start-date: das Startdatum (JJJJ-MM-TT) oder (MM-TT) bei jährlicher Wiederholung
  • end-date: das Enddatum (JJJJ-MM-TT) oder (MM-TT) bei jährlicher Wiederholung
  • time: die Start- und Endzeit (HH:MM:SS)

HTTP-Methode und URL:

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

JSON-Text anfordern:

{
  "settings":
  {
    "denyMaintenancePeriods": [{
      "start_date": "start-date",
      "end_date": "end-date"
      "time": "time"
    }]
  }
}

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/sql/v1beta4/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "startTime": "08:00",
  "endTime": "08:01",
  "operationType": MAINTENANCE_DENY_PERIOD,
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

Zeitraum für den Wartungsausschluss entfernen

Console

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

    Cloud SQL-Instanzen aufrufen

  2. Klicken Sie auf den Instanznamen, um die Seite Übersicht einer Instanz zu öffnen.
  3. Klicken Sie im Abschnitt Wartung auf Wartungseinstellungen bearbeiten.
  4. Klicken Sie im Abschnitt Zeitraum für Wartungsausschluss auf Löschen.
  5. Klicken Sie auf Speichern.

gcloud

Bevor Sie den unten aufgeführten gcloud-Befehl verwenden, ersetzen Sie die folgenden Werte:

  • instance-id: Cloud SQL-Instanz-ID
gcloud sql instances patch instance-id \
--remove-deny-maintenance-period

REST Version 1

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • project-id: die Projekt-ID
  • instance-id: die Instanz-ID

HTTP-Methode und URL:

POST https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id

JSON-Text anfordern:

{
  "settings":
  {
    "denyMaintenancePeriods": []
  }
}

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",
  "startTime": "08:00",
  "endTime": "08:01",
  "operationType": MAINTENANCE_DENY_PERIOD,
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

REST v1beta4

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • project-id: die Projekt-ID
  • instance-id: die Instanz-ID

HTTP-Methode und URL:

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

JSON-Text anfordern:

{
  "settings":
  {
    "denyMaintenancePeriods": []
  }
}

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/sql/v1beta4/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "startTime": "08:00",
  "endTime": "08:01",
  "operationType": MAINTENANCE_DENY_PERIOD,
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

Benachrichtigungen zum Zeitraum für den Wartungsausschluss

Benachrichtigungen zum Wartungsfenster werden nicht gesendet, wenn der geplante Wartungszeitpunkt in den Zeitraum eines Wartungsausschlusses fällt und sie daher aufgrund der entsprechenden Einstellungen nicht zulässig sind.

Wenn Sie die Einstellungen für den Zeitraum des Wartungsausschlusses so ändern, dass Wartungen zu einem zuvor geplanten Zeitpunkt verhindert werden, überspringt die Cloud SQL-Instanz die Wartung und sendet eine Benachrichtigung über das Abbrechen der Wartung. Cloud SQL sendet diesen Stornierungshinweis, wenn die Instanz für ein Update geplant ist.

Benachrichtigungen über geplante Wartungen werden während des Zeitraums des Wartungsausschlusses gesendet, wenn die Wartung außerhalb dieses Zeitraums geplant ist.

Nächste Schritte