Diese Seite wurde von der Cloud Translation API übersetzt.

Wartungsfenster konfigurieren

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

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

Wartungsfenster

Ein Wartungsfenster in Cloud Data Fusion ist ein Zeitraum, in dem Wartungsvorgänge ausgeführt werden dürfen. So wird das Risiko von Dienstunterbrechungen während der Spitzenzeiten der Nutzung verringert. Wenn Sie Wartungsfenster außerhalb der Spitzenzeiten oder zu Zeiten mit geringerer Aktivität planen, werden die Auswirkungen auf Ihre Cloud Data Fusion-Instanzen und 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 durchgeführt werden.

Wartungsvorgänge

Um die Systemsicherheit und Compliance zu gewährleisten, führt Cloud Data Fusion regelmäßige Wartungsarbeiten durch. Dazu gehören das Anwenden wichtiger 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 Wartungsfenster können bestimmte Vorgänge beeinträchtigt sein. Wir empfehlen, Wartungsfenster für Zeiten mit geringer Auslastung festzulegen. Der Wartungsvorgang kann 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, was zu einem Fehler führt.
- Cloud Data Fusion-Dienste sind möglicherweise vorübergehend nicht verfügbar, sodass API-Aufrufe fehlschlagen.
- Instanzen sind während des Wartungszeitfensters möglicherweise bis zu einer Stunde lang nicht voll funktionsfähig. Wir empfehlen, Wartungszeiträume einzurichten, wenn Ihre Pipelines entweder nicht ausgeführt werden oder nicht für die Ausführung geplant sind.

Wartungsfenster beim Erstellen einer Instanz angeben

Console

So legen Sie das Wartungsfenster beim Erstellen einer Instanz fest:

Rufen Sie die Seite Cloud Data Fusion-Instanzen auf und klicken Sie auf Instanz erstellen.
Instanz erstellen
Geben Sie einen Instanznamen und eine Version ein. Weitere Informationen zu den einzelnen Feldern finden Sie unter Instanz erstellen.
Maximieren Sie den Bereich Erweiterte Optionen.
Maximieren Sie den Bereich Wartung und führen Sie die folgenden Schritte aus:
1. Klicken Sie das Kästchen Wartungsfenster aktivieren an.
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 die Wochentage und die Dauer des Zeitfensters aus. Weitere Informationen zu diesen Einstellungen finden Sie unter Wartungsvorgänge.
5. Klicken Sie auf Erstellen.

Weitere Informationen finden Sie unter Wartungsfenster konfigurieren.

REST API

Konfigurieren Sie Instance mit der instance.create API:

{
  "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. Damit wird die wöchentliche Wiederholung des Zeitstempelfensters an den ausgewählten Tagen ab dem startTime und für die angegebene Dauer festgelegt.

Weitere Informationen finden Sie unter Wartungsfenster konfigurieren.

Im folgenden Beispiel wird eine Instanz mit einem sechsstündigen Wartungsfenster zwischen 10:00 und 16:00 Uhr (UTC) an Samstagen und Sonntagen jeder Woche erstellt. Weitere Informationen finden Sie in der API-Dokumentation zu 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 Befehl gcloud beta data-fusion instances create angeben.

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

--maintenance-window-start legt den Beginn des Zeitfensters fest.
--maintenance-window-end legt die Endzeit des Fensters fest.
Mit --maintenance-window-recurrence wird eine RRULE für die Wiederholung des Wartungsfensters festgelegt.

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 Zeitraums im Eingabeformat Datum/Uhrzeit. Es wird nur die angegebene Uhrzeit verwendet. Das angegebene Datum wird ignoriert.
END_TIME: Die Endzeit des Zeitraums im Eingabeformat Datum/Uhrzeit. Es wird nur die angegebene Uhrzeit verwendet. Das angegebene Datum wird ignoriert. Das angegebene Datum und die angegebene Uhrzeit müssen nach dem Startdatum 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. Damit wird die wöchentliche Wiederholung des Zeitstempelfensters an den ausgewählten Tagen ab der Uhrzeit --maintenance-window-start für die angegebene Dauer festgelegt.

Weitere Informationen finden Sie unter Wartungsfenster konfigurieren.

Mit dem folgenden Befehl wird eine Instanz mit einem sechsstündigen Wartungsfenster zwischen 12:00 und 18:00 Uhr (UTC) an Samstagen und Sonntagen jeder Woche 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 derGoogle Cloud Console:

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

Zur Seite „VM-Instanzen“
Klicken Sie auf den Instanznamen, um die Instanzdetails aufzurufen.
Rufen Sie auf der Seite Instanzdetails das Feld Wartungszeitraum auf und klicken Sie auf Bearbeiten.
Felder für Wartungszeiträume 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 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 die Wochentage und die Dauer des Zeitraums aus. Weitere Informationen zu diesen Einstellungen finden Sie unter Wartungsvorgänge.
Klicken Sie auf Speichern.

Weitere Informationen finden Sie unter Wartungsfenster konfigurieren.

REST API

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

Erstellen Sie eine API-Anfrage wie folgt:

Geben Sie im updateMask-Parameter die maintenance_policy-Maske an.
Geben Sie im Anfragetext das Wartungsfenster in der Wartungsrichtlinienkonfiguration an:

{
  "maintenancePolicy": {
    "maintenanceWindow": {
        "recurringTimeWindow": {
          "window": {
              "startTime": "START_TIME",
              "endTime": "END_TIME"
          },
          "recurrence": "MAINTENANCE_RECURRENCE"
        }
    },
  }
}

Weitere Informationen finden Sie unter Wartungsfenster konfigurieren.

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 Befehl gcloud beta data-fusion instances update aktualisieren.

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

--maintenance-window-start legt den Beginn des Zeitfensters fest.
--maintenance-window-end legt die Endzeit des Fensters fest.
Mit --maintenance-window-recurrence wird eine RRULE für die Wiederholung des Wartungsfensters festgelegt.

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 Zeitraums im Eingabeformat Datum/Uhrzeit. Es wird nur die angegebene Uhrzeit verwendet. Das angegebene Datum wird ignoriert.
END_TIME: Die Endzeit des Zeitraums im Eingabeformat Datum/Uhrzeit. Es wird nur die angegebene Uhrzeit verwendet. Das angegebene Datum wird ignoriert. Das angegebene Datum und die angegebene Uhrzeit müssen nach dem Startdatum 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. Damit wird die wöchentliche Wiederholung des Zeitstempelfensters an den ausgewählten Tagen ab der Uhrzeit --maintenance-window-start für die angegebene Dauer festgelegt.

Mit dem folgenden Befehl wird die Instanz example-instance mit einem sechsstündigen Wartungsfenster zwischen 12:00 und 18:00 Uhr (UTC) an Samstagen und Sonntagen 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'

Wartungsfensterzeiten und Wiederholung (RRULE) konfigurieren

Wenn Sie 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 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 in Ihrer Zeitzone beginnt (was Donnerstag um 4:00 Uhr UTC entspricht), geben Sie TH anstelle von WE in der Option BYDAY der RRULE an.

Wartungsfenster für eine Instanz entfernen

Console

So entfernen Sie das Wartungsfenster in einer vorhandenen Instanz in derGoogle Cloud -Konsole:

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

Zur Seite „VM-Instanzen“
Klicken Sie auf den Instanznamen, um die Instanzdetails aufzurufen.
Rufen Sie auf der Seite Instanzdetails das Feld Wartungszeitraum auf und klicken Sie auf Bearbeiten.
Wenn Sie das Wartungsfenster aus der Instanz entfernen möchten, entfernen Sie das Häkchen aus dem Kästchen Wartungsfenster aktivieren.
Klicken Sie auf Speichern.

REST API

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

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

{
    "maintenancePolicy": {}
}

gcloud

Verwenden Sie den Befehl gcloud beta data-fusion instances update mit dem Flag --clear-maintenance-window, 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

Weitere Informationen finden Sie in der API-Dokumentation zu Instanzen.

Wartungsfenster konfigurieren Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Wartungsfenster

Wartungsvorgänge

Wartungsfenster beim Erstellen einer Instanz angeben

Console

REST API

gcloud

Wartungsfenster für eine Instanz aktualisieren

Console

REST API

gcloud

Wartungsfensterzeiten und Wiederholung (RRULE) konfigurieren

Wartungsfenster für eine Instanz entfernen

Console

REST API

gcloud

Nächste Schritte

Wartungsfenster konfigurieren