Wartungsfenster konfigurieren

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

Wartungsfenster werden für Cloud Data Fusion-Instanzen in Version 6.8.0 und höher unterstützt.

Informationen zu Wartungsfenstern

Ein Wartungsfenster in Cloud Data Fusion ist ein Zeitraum, in dem Wartungsvorgänge ausgeführt werden können. Dadurch wird das Risiko von Dienstunterbrechungen während der Hauptnutzungszeiten verringert. Wenn Sie Wartungsfenster außerhalb der Hauptnutzungszeiten oder zu Zeiten mit geringerer Aktivität planen, werden die 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 der Instanz erfolgen:

  • 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 erfolgen.

Informationen zu Wartungsvorgängen

Um die Systemsicherheit und Compliance zu gewährleisten, führt Cloud Data Fusion regelmäßig Wartungsvorgänge durch. Dazu gehören das Anwenden kritischer Updates und Sicherheitspatches, um Sicherheitslücken zu schließen und Nutzerdaten zu schützen. Geplante Wartungsfenster sorgen dafür, dass die Updates effizient angewendet werden, die Systemintegrität erhalten bleibt und Unterbrechungen von Instanzen und Pipelineausführungen minimiert werden.

  • 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 Wartungsfensterzeiten können bestimmte Vorgänge beeinträchtigt werden. Wir empfehlen, Wartungsfenster außerhalb der Hauptnutzungszeiten zu planen. Die Wartungsvorgänge können sich auf folgende Weise auf Cloud Data Fusion auswirken:

    • Die Cloud Data Fusion Studio-Oberfläche ist möglicherweise vorübergehend nicht verfügbar.
    • Die Pipelineausführung kann beeinträchtigt werden und zu Fehlern führen.
    • Cloud Data Fusion-Dienste sind möglicherweise vorübergehend nicht verfügbar, was zu Fehlern bei API-Aufrufen führt.
    • Instanzen sind während der Wartungsfensterzeiten möglicherweise bis zu einer Stunde lang nicht voll funktionsfähig. Wir empfehlen, Wartungsfenster einzurichten, wenn Ihre Pipelines entweder nicht ausgeführt werden oder nicht zur Ausführung geplant sind.

Wartungsfenster beim Erstellen einer Instanz angeben

Console

So legen Sie das Wartungsfenster beim Erstellen einer Instanz fest:

  1. Rufen Sie die Seite Instanzen von Cloud Data Fusion 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 Bereich Wartung und gehen Sie so vor:
    1. Klicken Sie auf das Kästchen Wartungsfenster aktivieren.
    2. Geben Sie im Feld Startzeit eine Zeit 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 Wochentage und die Dauer des Fensters aus. Weitere Informationen zu diesen Einstellungen finden Sie unter Informationen zu Wartungsvorgängen.
    5. Klicken Sie auf Erstellen.

Weitere Informationen finden Sie unter Zeiten und Wiederholung des Wartungsfensters konfigurieren (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: Startzeit des Zeitfensters, im RFC 3339-Format.
  • END_TIME: Endzeit des Zeitfensters im RFC 3339-Format.

  • 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. Dadurch wird die wöchentliche Wiederholung des Fensters an den ausgewählten Tagen festgelegt, beginnend mit startTime und für die angegebene Dauer.

Weitere Informationen finden Sie unter Zeiten und Wiederholung des Wartungsfensters konfigurieren (RRULE).

Im folgenden Beispiel wird eine Instanz mit einem sechsstündigen Wartungsfenster zwischen 10:00 und 16:00 Uhr (UTC) an jedem Samstag und Sonntag erstellt. Weitere Informationen finden Sie in der API-Dokumentation für Instanzen.

// 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"
          }
      },
  }
}

gcloud

Sie können das Wartungsfenster beim Erstellen einer Instanz mit dem gcloud beta data-fusion instances create Befehl angeben.

Für ein Wartungsfenster müssen die folgenden Parameter definiert werden:

  • --maintenance-window-start legt die Startzeit des Fensters fest.
  • --maintenance-window-end legt die Endzeit des Fensters fest.
  • --maintenance-window-recurrence legt eine RRULE für die Wiederholung des Wartungsfensters fest.
gcloud beta data-fusion instances create INSTANCE_NAME \
    --project=PROJECT_NAME \
    --location=LOCATION \
    --maintenance-window-start=START_TIME \
    --maintenance-window-end=END_TIME \
    --maintenance-window-recurrence=MAINTENANCE_RECURRENCE

Ersetzen Sie Folgendes:

  • INSTANCE_NAME: der Name der Instanz.
  • PROJECT_NAME: der Name des Projekts.
  • LOCATION: der Name der Region der Instanz.
  • START_TIME: die Startzeit des Fensters im Eingabeformat für Datum/Uhrzeit. Es wird nur die angegebene Uhrzeit verwendet. Das angegebene Datum wird ignoriert.
  • END_TIME: die Endzeit des Fensters im Eingabeformat für Datum/Uhrzeit. Es wird nur die angegebene Uhrzeit verwendet. Das angegebene Datum wird ignoriert. Das angegebene Datum und die angegebene Uhrzeit müssen nach der Startzeit liegen.

  • 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. Dadurch wird die wöchentliche Wiederholung des Fensters an den ausgewählten Tagen festgelegt, beginnend mit der Zeit --maintenance-window-start und für die angegebene Dauer.

Weitere Informationen finden Sie unter Zeiten und Wiederholung des Wartungsfensters konfigurieren (RRULE).

Mit dem folgenden Befehl wird eine Instanz mit einem sechsstündigen Wartungsfenster zwischen 12:00 und 18:00 Uhr (UTC) an jedem Samstag und Sonntag erstellt.

gcloud beta data-fusion instances create example-instance \
    --project='example-project' \
    --location='us-east1' \
    --maintenance-window-start='2024-01-01T12:00:00Z' \
    --maintenance-window-end='2024-01-01T18:00:00Z' \
    --maintenance-window-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 Instanzen von Cloud Data Fusion auf.

    Zur Seite „VM-Instanzen“

  2. Klicken Sie auf den Instanznamen, um die Instanzdetails aufzurufen.

  3. Gehen Sie auf der Seite Instanzdetails zum Feld Wartungsfenster und klicken Sie auf Bearbeiten.

  4. Die Felder für das Wartungsfenster werden im Bearbeitungsmodus geöffnet. Aktualisieren Sie die Werte nach Bedarf:

    1. Klicken Sie auf das Kästchen Wartungsfenster aktivieren.
    2. Geben Sie im Feld Startzeit eine Zeit 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 Wochentage und die Dauer des Fensters aus. Weitere Informationen zu diesen Einstellungen finden Sie unter Informationen zu Wartungsvorgängen.

  5. Klicken Sie auf Speichern.

Weitere Informationen finden Sie unter Zeiten und Wiederholung des Wartungsfensters konfigurieren (RRULE).

REST API

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

Erstellen Sie eine API-Anfrage so:

  1. Geben Sie im Parameter updateMask die Maske maintenance_policy 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 Zeiten und Wiederholung des Wartungsfensters konfigurieren (RRULE).

Im folgenden Beispiel wird die Konfiguration der Wartungsrichtlinie der Instanz mit einem vierstündigen Wartungsfenster zwischen 11:00 und 15:00 Uhr (UTC) an jedem Freitag, Samstag und Sonntag aktualisiert.

// 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"
    }
  },
}
}

gcloud

Sie können das Wartungsfenster einer Instanz mit dem gcloud beta data-fusion instances update Befehl aktualisieren.

Für ein Wartungsfenster müssen die folgenden Parameter definiert werden:

  • --maintenance-window-start legt die Startzeit des Fensters fest.
  • --maintenance-window-end legt die Endzeit des Fensters fest.
  • --maintenance-window-recurrence legt eine RRULE für die Wiederholung des Wartungsfensters fest.
gcloud beta data-fusion instances update INSTANCE_NAME \
    --project=PROJECT_NAME \
    --location=LOCATION \
    --maintenance-window-start=START_TIME \
    --maintenance-window-end=END_TIME \
    --maintenance-window-recurrence=MAINTENANCE_RECURRENCE

Ersetzen Sie Folgendes:

  • INSTANCE_NAME: der Name der Instanz.
  • PROJECT_NAME: der Name des Projekts.
  • LOCATION: der Name der Region der Instanz.
  • START_TIME: die Startzeit des Fensters im Eingabeformat für Datum/Uhrzeit. Es wird nur die angegebene Uhrzeit verwendet. Das angegebene Datum wird ignoriert.
  • END_TIME: die Endzeit des Fensters im Eingabeformat für Datum/Uhrzeit. Es wird nur die angegebene Uhrzeit verwendet. Das angegebene Datum wird ignoriert. Das angegebene Datum und die angegebene Uhrzeit müssen nach der Startzeit liegen.

  • 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. Dadurch wird die wöchentliche Wiederholung des Fensters an den ausgewählten Tagen festgelegt, beginnend mit der Zeit --maintenance-window-start und für die angegebene Dauer.

Mit dem folgenden Befehl wird die Instanz example-instance mit einem sechsstündigen Wartungsfenster zwischen 12:00 und 18:00 Uhr (UTC) an jedem Samstag und Sonntag aktualisiert.

gcloud beta data-fusion instances update example-instance \
    --project='example-project' \
    --location='us-east1' \
    --maintenance-window-start='2024-01-01T12:00:00Z' \
    --maintenance-window-end='2024-01-01T18:00:00Z' \
    --maintenance-window-recurrence='FREQ=WEEKLY;BYDAY=SA,SU'

Zeiten und Wiederholung des Wartungsfensters konfigurieren (RRULE)

Wenn Sie Start- und Endzeiten für das Wartungsfenster konfigurieren, werden die Datumskomponenten der angegebenen Zeitstempel ignoriert. Es werden nur die Uhrzeit und die Dauer zwischen Start- und Endzeit berücksichtigt. Die Zeiten werden in UTC gespeichert. Sie können jedoch UTC oder Ihren Zeitzonen-Offset verwenden, wenn Sie Wartungsfenster mit der REST API oder der gcloud CLI planen.

Wenn Sie die Wiederholung konfigurieren, beachten Sie, dass RRULE UTC-Tage verwendet. Passen Sie die Einstellungen entsprechend an, wenn sich Ihre Zeitzone unterscheidet. Wenn Ihre Zeitzone beispielsweise PDT (UTC-7) ist und Sie möchten, dass ein Wartungsfenster am Mittwoch um 21:00 Uhr beginnt (was Donnerstag um 4:00 Uhr UTC entspricht), geben Sie in der Option BYDAY der RRULE TH anstelle von WE an.

Wartungsfenster für eine Instanz entfernen

Console

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

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

    Zur Seite „VM-Instanzen“

  2. Klicken Sie auf den Instanznamen, um die Instanzdetails aufzurufen.

  3. Gehen Sie auf der Seite Instanzdetails zum Feld Wartungsfenster und klicken Sie auf Bearbeiten.

  4. Entfernen Sie das Häkchen aus dem Kästchen Wartungsfenster aktivieren, um das Wartungsfenster aus der Instanz zu entfernen.

  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": {}
}

gcloud

Verwenden Sie gcloud beta data-fusion instances update Befehl mit dem --clear-maintenance-window Flag, um das Wartungsfenster aus einer Instanz zu entfernen.

gcloud beta data-fusion instances update INSTANCE_NAME \
    --project=PROJECT_NAME \
    --location=LOCATION \
    --clear-maintenance-window

Ersetzen Sie Folgendes:

  • INSTANCE_NAME: der Name der Instanz.
  • PROJECT_NAME: der Name des Projekts.
  • LOCATION: der Name der Region der Instanz.

Nächste Schritte