Wartungsfenster konfigurieren

Auf dieser Seite wird erläutert, wie Wartungsfenster für Cloud Data Fusion-Instanzen definiert werden.

Wartungsfenster werden für Cloud Data Fusion-Instanzen ab Version 6.8.0 unterstützt.

Wartungsfenster

Ein Wartungsfenster in Cloud Data Fusion ist ein Zeitraum, in dem Sie die Ausführung von Wartungsvorgängen zulassen, um das Risiko von Dienstunterbrechungen während Spitzennutzungszeiten zu verringern. Wenn Sie Wartungsfenster außerhalb der Spitzenzeiten oder Zeiten mit geringerer Aktivität planen, werden deren Auswirkungen auf Ihre Cloud Data Fusion-Instanzen und Ihre Pipelineausführungen minimiert.

Durch das Konfigurieren von Wartungsfenstern können Sie steuern, wann Wartungsvorgänge in Ihrer Instanz stattfinden:

  • Wenn das Wartungsfenster definiert ist, werden Wartungsvorgänge von Cloud Data Fusion innerhalb der definierten Zeiträume ausgeführt.
  • Wenn das Wartungsfenster nicht definiert ist, kann die Wartung jederzeit durchgeführt werden.

Wartungsvorgänge

Zur Sicherstellung der Systemsicherheit und Compliance führt Cloud Data Fusion regelmäßige Wartungsvorgänge durch. Zu diesen Vorgängen gehören das Anwenden kritischer Updates und Sicherheitspatches, um Sicherheitslücken zu verringern und Nutzerdaten zu schützen. Geplante Wartungsfenster sorgen für eine effiziente Anwendung der Updates. Die Systemintegrität wird gewahrt und Unterbrechungen von Instanzen und Pipelineausführungen werden minimiert.

  • Wenn Sie die Wartungsfenster konfigurieren, müssen Sie mindestens 12 Stunden pro Woche für Wartungsvorgänge einplanen. Jedes Fenster muss zwischen 4 und 12 Stunden lang sein.

  • Während der Wartungsfenster können bestimmte Vorgänge beeinträchtigt sein. Wir empfehlen, Wartungsfenster außerhalb der Spitzennutzungszeiten einzurichten. Der Wartungsvorgang kann sich folgendermaßen auf Cloud Data Fusion auswirken:

    • Die Benutzeroberfläche von Cloud Data Fusion Studio ist möglicherweise vorübergehend nicht verfügbar.
    • Die Pipelineausführung kann beeinträchtigt sein und einen Fehler verursachen.
    • Cloud Data Fusion-Dienste sind möglicherweise vorübergehend nicht verfügbar, wodurch API-Aufrufe fehlschlagen.
    • Instanzen sind während der Wartungsfenster möglicherweise bis zu einer Stunde lang nicht voll funktionsfähig. Wir empfehlen Ihnen, Wartungsfenster einzurichten, wenn Ihre Pipelines entweder nicht ausgeführt werden oder nicht ausgeführt werden sollen.

Wartungsfenster beim Erstellen einer Instanz angeben

Console

So legen Sie das Wartungsfenster beim Erstellen einer Instanz fest:

  1. Rufen Sie in Cloud Data Fusion die Seite Instanzen auf und klicken Sie auf Instanz erstellen.

    Instanz erstellen

  2. Geben Sie einen Instanznamen und eine Edition ein. Weitere Informationen zu den einzelnen Feldern finden Sie unter Instanz erstellen.
  3. Maximieren Sie den Bereich Erweiterte Optionen.
  4. Maximieren Sie den Abschnitt Wartung und führen Sie die folgenden Schritte aus:
    1. Klicken Sie das Kästchen Wartungsfenster aktivieren an.
    2. Geben Sie im Feld Beginn eine Uhrzeit in einem unterstützten Format ein.
    3. Wählen Sie in der Liste TimeZone eine Zeitzone aus.
    4. Wählen Sie in den Listen Days (Tage) und Length (Länge) die Wochentage und die Dauer des Zeitfensters aus. Weitere Informationen zu diesen Einstellungen finden Sie unter Informationen zu Wartungsvorgängen.
    5. Klicken Sie auf Erstellen.

Weitere Informationen finden Sie unter Konfigurieren von Wartungsfenster-Zeiten und Wiederholungen (RRULE).

REST API

  1. Legen Sie die Instance-Konfiguration mit der instance.create API fest:
{
  "name": string,
  "description": string,
  …
  …
  "maintenancePolicy": {
    "maintenanceWindow": {
      "recurringTimeWindow": {
        "window": {
            "startTime": "START_TIME",
            "endTime": "END_TIME"
        },
        "recurrence": "MAINTENANCE_RECURRENCE"
      }
    },
  }
}

Ersetzen Sie Folgendes:

  • START_TIME: Beginn des Zeitfensters im Format RFC 3339.
  • END_TIME: Ende des Zeitfensters im Format RFC 3339.

  • MAINTENANCE_RECURRENCE: Eine RRULE für die Wiederholung des Wartungsfensters. Cloud Data Fusion unterstützt nur die folgenden Formate:

    • FREQ=WEEKLY;BYDAY=SU,MO,TU,WE,TH,FR,SA oder BYDAY=SU,MO,TU,WE,TH,FR,SA,MO;FREQ=WEEKLY. Gibt die wöchentliche Wiederholung des Zeitfensters an den ausgewählten Tagen ab startTime für die angegebene Dauer an.

Weitere Informationen finden Sie unter Konfigurieren von Wartungsfenster-Zeiten und Wiederholungen (RRULE).

Im folgenden Beispiel wird eine Instanz mit einem sechsstündigen Wartungsfenster zwischen 10:00 und 16:00 Uhr (UTC) samstags und sonntags jede Woche erstellt. Weitere Informationen finden Sie in der Dokumentation zur Instanzen API.

// POST https://datafusion.googleapis.com/v1/projects/example-project/locations/us-central1/instances?instanceID=example-instance

{
  "maintenancePolicy": {
      "maintenanceWindow": {
          "recurringTimeWindow": {
              "window": {
                  "startTime": "2024-01-01T10:00:00Z",
                  "endTime": "2024-01-01T16:00:00Z",
              },
              "recurrence": "FREQ=WEEKLY;BYDAY=SA,SU"
          }
      },
  }
}

Wartungsfenster für eine Instanz aktualisieren

Console

So aktualisieren Sie das Wartungsfenster in einer vorhandenen Instanz in der Google Cloud Console:

  1. Rufen Sie die Seite Cloud Data Fusion-Seite Instanzen auf.

    Zu den Instanzen

  2. Klicken Sie auf den Instanznamen, um die Instanzdetails aufzurufen.
  3. Wechseln Sie auf der Seite Instanzdetails zum Feld Wartungsfenster und klicken Sie auf Bearbeiten.
  4. Felder des Wartungsfensters werden im Bearbeitungsmodus geöffnet. Aktualisieren Sie die Werte nach Bedarf:
    1. Klicken Sie das Kästchen Wartungsfenster aktivieren an.
    2. Geben Sie im Feld Beginn eine Uhrzeit in einem unterstützten Format ein.
    3. Wählen Sie in der Liste TimeZone eine Zeitzone aus.
    4. Wählen Sie in den Listen Tage und Länge die Wochentage und die Dauer des Zeitfensters aus. Weitere Informationen zu diesen Einstellungen finden Sie unter Informationen zu Wartungsvorgängen.
  5. Klicken Sie auf Speichern.

Weitere Informationen finden Sie unter Konfigurieren von Wartungsfenster-Zeiten und Wiederholungen (RRULE).

REST API

Aktualisieren Sie die Wartungsfenster für vorhandene Instanzen mit der API-Anfrage instances.patch. Dadurch wird die vorhandene Konfiguration des Wartungsfensters überschrieben, falls vorhanden. Andernfalls wird, wie im Anfragetext angegeben, eine neue Konfiguration festgelegt.

Erstellen Sie wie folgt eine API-Anfrage:

  1. Geben Sie im updateMask-Parameter die maintenance_policy-Maske an.
  2. Geben Sie im Anfragetext das Wartungsfenster in der Konfiguration der Wartungsrichtlinie an:
{
  "maintenancePolicy": {
    "maintenanceWindow": {
        "recurringTimeWindow": {
          "window": {
              "startTime": "START_TIME",
              "endTime": "END_TIME"
          },
          "recurrence": "MAINTENANCE_RECURRENCE"
        }
    },
  }
}

Weitere Informationen finden Sie unter Konfigurieren von Wartungsfenster-Zeiten und Wiederholungen (RRULE).

Im folgenden Beispiel wird die Konfiguration der Wartungsrichtlinie der Instanz mit einem vierstündigen Wartungsfenster zwischen 11:00 Uhr und 15:00 Uhr (UTC) aktualisiert. Jede Woche wird freitags, samstags und sonntags ein Wartungsfenster von vier Stunden festgelegt.

// PATCH https://datafusion.googleapis.com/v1/projects/example-project/locations/us-central1/instances/example-instance?updateMask=maintenance_policy

{
"maintenancePolicy": {
  "maintenanceWindow": {
    "recurringTimeWindow": {
      "window": {
          "startTime": "2024-01-01T11:00:00Z",
          "endTime": "2024-01-01T15:00:00Z",
        },
      "recurrence": "FREQ=WEEKLY;BYDAY=FR,SA,SU"
    }
  },
}
}

Zeiten und Wiederholung von Wartungsfenstern konfigurieren (RRULE)

Wenn Sie die Start- und Endzeiten für das Wartungsfenster konfigurieren, werden die Datumskomponenten der angegebenen Zeitstempel ignoriert. Es werden nur die Tageszeit und die Dauer zwischen Start- und Endzeit berücksichtigt. Zeiten werden in UTC gespeichert. Sie können jedoch beim Planen von Wartungsfenstern über die API UTC oder Ihren Zeitzonenversatz verwenden.

Beachten Sie beim Konfigurieren der Wiederholung, dass RRULE UTC-Tagen folgt. Passen Sie dies also entsprechend an, wenn sich Ihre Zeitzone unterscheidet. Wenn Ihre Zeitzone beispielsweise PDT (UTC-7) ist und Sie möchten, dass ein Wartungsfenster mittwochs um 21:00 Uhr in Ihrer Zeitzone beginnt (was donnerstags 4:00 Uhr UTC entspricht), geben Sie in der Option BYDAY der RRULE TH anstelle von WE an.

Wartungsfenster für eine Instanz löschen

Console

So löschen Sie das Wartungsfenster in einer vorhandenen Instanz in der Google Cloud Console:

  1. Rufen Sie die Seite Cloud Data Fusion-Seite Instanzen auf.

    Zu den Instanzen

  2. Klicken Sie auf den Instanznamen, um die Instanzdetails aufzurufen.
  3. Wechseln Sie auf der Seite Instanzdetails zum Feld Wartungsfenster und klicken Sie auf Bearbeiten.
  4. Wenn Sie das Wartungsfenster aus der Instanz entfernen möchten, entfernen Sie das Häkchen aus dem Kästchen Wartungsfenster aktivieren.
  5. Klicken Sie auf Speichern.

REST API

Wenn Sie das Wartungsfenster aus einer Instanz entfernen möchten, übergeben Sie im Anfragetext ein leeres Wartungsrichtlinienobjekt.

// PATCH https://datafusion.googleapis.com/v1/projects/example-project/locations/us-central1/instances/example-instance?updateMask=maintenance_policy

{
    "maintenancePolicy": {}
}

Nächste Schritte