Configura periodi di manutenzione

Questa pagina spiega come definire periodi di manutenzione per le istanze Cloud Data Fusion.

I periodi di manutenzione sono supportati per le istanze Cloud Data Fusion 6.8.0 e versioni successive.

Informazioni sui periodi di manutenzione

Un periodo di manutenzione in Cloud Data Fusion è un periodo di tempo in cui consenti l'esecuzione di operazioni di manutenzione, riducendo il rischio di interruzioni del servizio durante i periodi di picco di utilizzo. La pianificazione dei periodi di manutenzione al di fuori delle ore di punta o nelle ore in cui l'attività è inferiore consente di ridurre al minimo il loro impatto sulle tue istanze Cloud Data Fusion e sulle esecuzioni della pipeline.

I periodi di manutenzione consentono di controllare quando si verificano operazioni di manutenzione nell'istanza:

  • Se il periodo di manutenzione è definito, le operazioni di manutenzione vengono eseguite da Cloud Data Fusion nei periodi definiti.
  • Se il periodo di manutenzione non è definito, la manutenzione può essere eseguita in qualsiasi momento.

Informazioni sulle operazioni di manutenzione

Per garantire la sicurezza e la conformità del sistema, Cloud Data Fusion esegue normali operazioni di manutenzione. Queste operazioni includono l'applicazione di aggiornamenti critici e patch di sicurezza per mitigare le vulnerabilità e proteggere i dati degli utenti. I periodi di manutenzione programmata assicurano che gli aggiornamenti vengano applicati in modo efficiente, preservando l'integrità del sistema e riducendo al minimo le interruzioni delle istanze e delle esecuzioni delle pipeline.

  • Quando configuri i periodi di manutenzione, devi allocare almeno 12 ore alla settimana per le operazioni di manutenzione. Ogni finestra deve essere compresa tra 4 e 12 ore.

  • Durante le ore del periodo di manutenzione, alcune operazioni potrebbero risentirne. Consigliamo di fare finestre di manutenzione durante periodi di utilizzo non di punta. L'operazione di manutenzione può influire su Cloud Data Fusion nei seguenti modi:

    • L'interfaccia di Cloud Data Fusion Studio potrebbe essere temporaneamente non disponibile.
    • L'esecuzione della pipeline potrebbe risentirne e causare errori.
    • I servizi Cloud Data Fusion potrebbero essere temporaneamente inattivi, causando l'esito negativo delle chiamate API.
    • Le istanze potrebbero non essere completamente funzionali per un'ora al massimo durante gli orari di manutenzione. Ti consigliamo di configurare i periodi di manutenzione quando le pipeline non sono in esecuzione o non sono pianificate per l'esecuzione.

Specifica i periodi di manutenzione durante la creazione di un'istanza

Console

Per impostare il periodo di manutenzione quando crei un'istanza:

  1. Vai alla pagina Istanze di Cloud Data Fusion e fai clic su Crea istanza.

    Crea un'istanza

  2. Inserisci un Nome istanza ed Edizione. Per ulteriori informazioni su ciascun campo, consulta Creare un'istanza.
  3. Espandi la sezione Opzioni avanzate.
  4. Espandi la sezione Manutenzione e segui questi passaggi:
    1. Seleziona la casella di controllo Abilita periodo di manutenzione.
    2. Nel campo Ora di inizio, inserisci un'ora in un formato supportato.
    3. Seleziona un fuso orario nell'elenco TimeZone.
    4. Negli elenchi Giorni e Durata, seleziona i giorni della settimana e la durata della finestra. Per ulteriori informazioni su queste impostazioni, vedi Informazioni sulle operazioni di manutenzione.
    5. Fai clic su Crea.

Per maggiori informazioni, consulta Configurare le tempistiche e la ricorrenza del periodo di manutenzione (RRULE).

API REST

  1. Imposta la configurazione Instance utilizzando l'API instance.create:
{
  "name": string,
  "description": string,
  …
  …
  "maintenancePolicy": {
    "maintenanceWindow": {
      "recurringTimeWindow": {
        "window": {
            "startTime": "START_TIME",
            "endTime": "END_TIME"
        },
        "recurrence": "MAINTENANCE_RECURRENCE"
      }
    },
  }
}

Sostituisci quanto segue:

  • START_TIME: ora di inizio della finestra temporale, nel formato RFC 3339.
  • END_TIME: ora di fine della finestra temporale nel formato RFC 3339.

  • MAINTENANCE_RECURRENCE: una regola RRULE per la ricorrenza del periodo di manutenzione. Cloud Data Fusion supporta solo i seguenti formati:

    • FREQ=WEEKLY;BYDAY=SU,MO,TU,WE,TH,FR,SA o BYDAY=SU,MO,TU,WE,TH,FR,SA,MO;FREQ=WEEKLY. Consente di specificare la ricorrenza settimanale della finestra nei giorni selezionati, a partire dal giorno startTime e per la durata specificata.

Per maggiori informazioni, consulta Configurare le tempistiche e la ricorrenza del periodo di manutenzione (RRULE).

L'esempio seguente crea un'istanza con un periodo di manutenzione di sei ore tra le 10:00 e le 16:00 (UTC) di sabato e domenica ogni settimana. Per saperne di più, consulta la documentazione dell'API instances.

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

Aggiorna i periodi di manutenzione per un'istanza

Console

Per aggiornare il periodo di manutenzione in un'istanza esistente nella console Google Cloud, segui questi passaggi:

  1. Vai alla pagina Istanze di Cloud Data Fusion.

    Vai a Istanze

  2. Fai clic sul nome dell'istanza per visualizzare i dettagli dell'istanza.
  3. Nella pagina Dettagli istanza, vai al campo Finestra di manutenzione e fai clic su Modifica.
  4. I campi del periodo di manutenzione vengono aperti in modalità di modifica. Aggiorna i valori in base alle necessità:
    1. Seleziona la casella di controllo Abilita periodo di manutenzione.
    2. Nel campo Ora di inizio, inserisci un'ora in un formato supportato.
    3. Seleziona un fuso orario nell'elenco TimeZone.
    4. Negli elenchi Giorni e Durata, seleziona i giorni della settimana e la durata del periodo. Per ulteriori informazioni su queste impostazioni, vedi Informazioni sulle operazioni di manutenzione.
  5. Fai clic su Salva.

Per maggiori informazioni, consulta Configurare le tempistiche e la ricorrenza del periodo di manutenzione (RRULE).

API REST

Per le istanze esistenti, aggiorna i periodi di manutenzione utilizzando la richiesta API instances.patch. Questa azione sostituisce la configurazione esistente del periodo di manutenzione, se presente. In caso contrario, viene impostata una nuova configurazione, come indicato nel corpo della richiesta.

Crea una richiesta API come segue:

  1. Nel parametro updateMask, specifica la maschera maintenance_policy.
  2. Nel corpo della richiesta, specifica il periodo di manutenzione nella configurazione del criterio di manutenzione:
{
  "maintenancePolicy": {
    "maintenanceWindow": {
        "recurringTimeWindow": {
          "window": {
              "startTime": "START_TIME",
              "endTime": "END_TIME"
          },
          "recurrence": "MAINTENANCE_RECURRENCE"
        }
    },
  }
}

Per maggiori informazioni, consulta Configurare le tempistiche e la ricorrenza del periodo di manutenzione (RRULE).

L'esempio seguente aggiorna la configurazione dei criteri di manutenzione dell'istanza con un periodo di manutenzione di quattro ore tra le 11:00 e le 15:00 (UTC) di venerdì, sabato e domenica ogni settimana.

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

Configura le ore e la ricorrenza del periodo di manutenzione (RRULE)

Quando configuri le ore di inizio e di fine per il periodo di manutenzione, i componenti delle date dei timestamp forniti vengono ignorati. Vengono prese in considerazione solo l'ora del giorno e la durata compresa tra l'ora di inizio e quella di fine. Gli orari sono memorizzati nel fuso orario UTC, ma puoi utilizzare il fuso orario UTC o la differenza di fuso orario quando pianifichi i periodi di manutenzione mediante l'API.

Quando configuri la ricorrenza, tieni presente che RRULE segue i giorni UTC, quindi apporta le modifiche di conseguenza se il fuso orario è diverso. Ad esempio, se il tuo fuso orario è PDT (UTC-7) e vuoi che il periodo di manutenzione inizi alle 21:00 di mercoledì nel tuo fuso orario (che corrisponde alle 04:00 UTC il giovedì), specifica TH anziché WE nell'opzione BYDAY della regola RRULE.

Elimina il periodo di manutenzione per un'istanza

Console

Per eliminare il periodo di manutenzione in un'istanza esistente nella console Google Cloud, segui questi passaggi:

  1. Vai alla pagina Istanze di Cloud Data Fusion.

    Vai a Istanze

  2. Fai clic sul nome dell'istanza per visualizzare i dettagli dell'istanza.
  3. Nella pagina Dettagli istanza, vai al campo Finestra di manutenzione e fai clic su Modifica.
  4. Per rimuovere il periodo di manutenzione dall'istanza, deseleziona la casella di controllo Abilita periodo di manutenzione.
  5. Fai clic su Salva.

API REST

Per rimuovere il periodo di manutenzione da un'istanza, passa un oggetto criterio di manutenzione vuoto nel corpo della richiesta.

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

{
    "maintenancePolicy": {}
}

Passaggi successivi