Wartungsfenster konfigurieren

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

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

Wartungsfenster

Ein Wartungsfenster in Cloud Data Fusion ist ein Zeitraum, in dem Sie um Wartungsvorgänge auszuführen und so das Servicerisiko zu senken. Störungen während der Spitzennutzungszeiten. Wartungsfenster in folgendem Zeitraum planen: Außerhalb der Hauptbetriebszeiten oder Zeiten, in denen Ihre Aktivität weniger aktiv ist, werden deren Auswirkungen auf Ihre Cloud Data Fusion-Instanzen und Ihre Pipelineausführungen.

Durch das Konfigurieren von Wartungsfenstern können Sie steuern, wann Wartungsvorgänge ausgeführt werden in Ihrer Instanz auftreten:

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

Wartungsvorgänge

Zur Sicherstellung der Systemsicherheit und -konformität führt Cloud Data Fusion und regelmäßige Wartungsvorgänge. Dazu gehört die Anwendung kritischer Updates und Sicherheitspatches, um Sicherheitslücken zu mindern und Nutzerdaten zu schützen. Geplante Wartungsfenster sorgen dafür, dass Updates effizient angewendet werden, Bewahrung der Systemintegrität und Minimierung von Störungen von Instanzen und Pipeline Ausführungen.

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

  • Während der Wartungsfenster können bestimmte Vorgänge beeinträchtigt sein. Wir empfehlen, Wartungsfenster außerhalb der Spitzennutzungszeiten einzurichten. Die Wartungsvorgang kann sich auf Cloud Data Fusion folgendermaßen 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 schlagen fehl.
    • Instanzen sind möglicherweise für bis zu einer Stunde während die Stunden des Wartungsfensters. Wir empfehlen, eine Wartung einzurichten wenn Ihre Pipelines entweder nicht ausgeführt werden oder ausführen.

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 Erstellen. Instanz.

    Instanz erstellen

  2. Geben Sie einen Instanznamen und eine Edition ein. Weitere Informationen zu 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: <ph type="x-smartling-placeholder">
      </ph>
    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 gewünschten Wochentage und Dauer des Zeitfensters. Weitere Informationen zu diesen Einstellungen finden Sie unter Wartungsvorgänge
    5. Klicken Sie auf Erstellen.

Weitere Informationen finden Sie unter Konfigurieren Sie die Zeiten und Wiederholungen von Wartungsfenstern (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: Zeitfensterende, in das Format RFC 3339.

  • MAINTENANCE_RECURRENCE: ein RRULE für den das Wiederholungsintervall des Wartungsfensters. Cloud Data Fusion unterstützt nur folgenden Formaten:

    • 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, beginnend am startTime und für die angegebene Dauer.

Weitere Informationen finden Sie unter Konfigurieren Sie die Zeiten und Wiederholungen von Wartungsfenstern (RRULE).

Im folgenden Beispiel wird eine Instanz mit einem sechsstündigen Wartungsfenster erstellt Samstag und Sonntag von 10:00 bis 16:00 Uhr (UTC) verfügbar. Weitere Informationen 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"
          }
      },
  }
}

gcloud

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

Die folgenden Parameter müssen für ein Wartungsfenster definiert werden:

  • --maintenance-window-start legt den Beginn des Zeitfensters fest.
  • --maintenance-window-end legt das Ende des Zeitfensters fest.
  • --maintenance-window-recurrence legt eine RRULE für das das Wiederholungsintervall des Wartungsfensters.
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 in der Eingabeformat für Datum/Uhrzeit. Es wird nur die angegebene Uhrzeit verwendet. Das angegebene Datum wird ignoriert.
  • END_TIME: das Ende des Fensters in der Eingabeformat für Datum/Uhrzeit. Es wird nur die angegebene Uhrzeit verwendet. Das angegebene Datum wird ignoriert. Die Datum und Uhrzeit müssen nach dem Beginn liegen.

  • MAINTENANCE_RECURRENCE: ein RRULE für den das Wiederholungsintervall des Wartungsfensters. Cloud Data Fusion unterstützt nur folgenden Formaten:

    • 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, beginnend am --maintenance-window-start-mal und für die angegebene Dauer.

Weitere Informationen finden Sie unter Konfigurieren Sie die Zeiten und Wiederholungen von Wartungsfenstern (RRULE).

Der folgende Befehl erstellt eine Instanz mit einem sechsstündigen Wartungsfenster. Samstag und Sonntag zwischen 12:00 und 18:00 Uhr UTC.

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 im Google Cloud Console führen Sie die folgenden Schritte aus:

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

    Zur Seite „VM-Instanzen“

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

  3. Gehen Sie auf der Seite Instanzdetails zum 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 aus. des Fensters. Weitere Informationen zu diesen Einstellungen finden Sie unter Wartungsvorgänge

  5. Klicken Sie auf Speichern.

Weitere Informationen finden Sie unter Konfigurieren Sie die Zeiten und Wiederholungen von Wartungsfenstern (RRULE).

REST API

Aktualisieren Sie die Wartungsfenster für vorhandene Instanzen mithilfe der instances.patch API-Anfrage. Dadurch wird die vorhandene Konfiguration des Wartungsfensters überschrieben, wenn präsent sind. Andernfalls wird eine neue Konfiguration festgelegt, wie in der Anfrage angegeben. Textkörper.

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 Wartung an. Richtlinienkonfiguration:
{
  "maintenancePolicy": {
    "maintenanceWindow": {
        "recurringTimeWindow": {
          "window": {
              "startTime": "START_TIME",
              "endTime": "END_TIME"
          },
          "recurrence": "MAINTENANCE_RECURRENCE"
        }
    },
  }
}

Weitere Informationen finden Sie unter Konfigurieren Sie die Zeiten und Wiederholungen von Wartungsfenstern (RRULE).

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

// 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.

Die folgenden Parameter müssen für ein Wartungsfenster definiert werden:

  • --maintenance-window-start legt den Beginn des Zeitfensters fest.
  • --maintenance-window-end legt das Ende des Zeitfensters fest.
  • --maintenance-window-recurrence legt eine RRULE für das das Wiederholungsintervall des Wartungsfensters.
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 in der Eingabeformat für Datum/Uhrzeit. Es wird nur die angegebene Uhrzeit verwendet. Das angegebene Datum wird ignoriert.
  • END_TIME: das Ende des Fensters in der Eingabeformat für Datum/Uhrzeit. Es wird nur die angegebene Uhrzeit verwendet. Das angegebene Datum wird ignoriert. Die Datum und Uhrzeit müssen nach dem Beginn liegen.

  • MAINTENANCE_RECURRENCE: ein RRULE für den das Wiederholungsintervall des Wartungsfensters. Cloud Data Fusion unterstützt nur folgenden Formaten:

    • 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, beginnend am --maintenance-window-start-mal und für die angegebene Dauer.

Der folgende Befehl aktualisiert die Instanz example-instance mit einem Wartungsfenster zwischen Samstag und Sonntag zwischen 12:00 und 18:00 Uhr (UTC) Woche.

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 von Wartungsfenstern konfigurieren (RRULE)

Wenn Sie Start- und Endzeiten für das Wartungsfenster konfigurieren, wird das Datum -Komponenten der angegebenen Zeitstempel werden ignoriert. Nur die Tageszeit und zwischen Start- und Endzeit berücksichtigt werden. Zeiten werden in UTC gespeichert, Sie können bei der Planung von Wartungsfenstern UTC oder Ihren Zeitzonenversatz verwenden über die REST API oder die gcloud CLI.

Beachten Sie beim Konfigurieren der Wiederholung, dass RRULE in UTC-Tagen folgt, sodass bei Abweichungen in Ihrer Zeitzone entsprechend anpassen. Beispiel: Ihre Zeitzone ist PDT (UTC-7) und Sie möchten, dass ein Wartungsfenster mittwochs um 21:00 Uhr im Ihre Zeitzone (entspricht donnerstags 4:00 Uhr UTC) und geben Sie TH an. statt WE in der BYDAY-Option der RRULE.

Wartungsfenster für eine Instanz entfernen

Console

So entfernen Sie das Wartungsfenster aus einer vorhandenen Instanz in der Google Cloud Console führen Sie die folgenden Schritte aus:

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

    Zur Seite „VM-Instanzen“

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

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

  4. Um das Wartungsfenster aus der Instanz zu entfernen, löschen Sie die Kästchen Wartungsfenster aktivieren an.

  5. Klicken Sie auf Speichern.

REST API

Um das Wartungsfenster aus einer Instanz zu entfernen, übergeben Sie eine leere Wartung im Anfragetext.

// 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, um das Wartungsfenster aus einer Instanz zu entfernen mit dem Flag --clear-maintenance-window.

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