Configura periodi di manutenzione

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

Le finestre di manutenzione sono supportate per le istanze Cloud Data Fusion nelle versioni 6.8.0 e successive.

Informazioni sui periodi di manutenzione

Una finestra di manutenzione in Cloud Data Fusion è un periodo di tempo in cui consente di eseguire operazioni di manutenzione, riducendo il rischio di interruzioni del servizio durante i picchi di utilizzo. Se pianifichi le finestre di manutenzione durante le ore di punta o quando la tua attività è in calo, riduci al minimo il loro impatto sulle istanze Cloud Data Fusion e sulle esecuzioni delle pipeline.

La configurazione dei periodi di manutenzione ti consente di controllare quando si verificano le operazioni di manutenzione nella tua 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 operazioni di manutenzione regolare. Queste operazioni includono l'applicazione di aggiornamenti critici e patch di sicurezza per ridurre le vulnerabilità e proteggere i dati utente. Le finestre di manutenzione pianificata garantiscono che gli aggiornamenti vengano applicati in modo efficiente, preservando l'integrità del sistema e riducendo al minimo le interruzioni delle esecuzioni di pipeline e istanze.

  • 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 essere interessate. Ti consigliamo di pianificare i periodi di manutenzione durante i 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 non essere temporaneamente disponibile.
    • L'esecuzione della pipeline potrebbe essere interessata, causando un errore.
    • I servizi Cloud Data Fusion potrebbero essere temporaneamente inattivi, causando l'errore delle chiamate API.
    • Le istanze potrebbero non essere completamente funzionali per un massimo di un'ora durante il periodo di manutenzione. Ti consigliamo di configurare finestre di manutenzione quando le pipeline non sono in esecuzione o non sono pianificate.

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

Console

Per impostare la finestra 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 e una versione. Per ulteriori informazioni su ciascun campo, vedi 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. Nell'elenco Fuso orario, seleziona un fuso orario.
    4. Negli elenchi Giorni e Durata, seleziona i giorni della settimana e la durata della finestra. Per ulteriori informazioni su queste impostazioni, consulta Informazioni sulle operazioni di manutenzione.
    5. Fai clic su Crea.

Per ulteriori informazioni, consulta Configurare la ricorrenza e i tempi 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 RRULE per la ricorrenza della finestra 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. Questo specifica la ricorrenza settimanale della finestra nei giorni selezionati, a partire dal giorno startTime e per la durata specificata.

Per ulteriori informazioni, consulta Configurare la ricorrenza e i tempi del periodo di manutenzione (RRULE).

L'esempio seguente crea un'istanza con una finestra di manutenzione di sei ore tra le 10:00 e le 16:00 (UTC) di sabato e domenica ogni settimana. Per ulteriori informazioni, 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"
          }
      },
  }
}

gcloud

Puoi specificare il periodo di manutenzione durante la creazione di un'istanza utilizzando il comando gcloud beta data-fusion instances create.

Per una finestra di manutenzione devono essere definiti i seguenti parametri:

  • --maintenance-window-start imposta l'ora di inizio della finestra.
  • --maintenance-window-end imposta l'ora di fine della finestra.
  • --maintenance-window-recurrence imposta un'RRULE per la ricorrenza della finestra di manutenzione.
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

Sostituisci quanto segue:

  • INSTANCE_NAME: il nome dell'istanza.
  • PROJECT_NAME: il nome del progetto.
  • LOCATION: il nome della regione dell'istanza.
  • START_TIME: l'ora di inizio della finestra nel formato di immissione della data/dell'ora. Viene utilizzata solo la ora specificata del giorno, mentre la data specificata viene ignorata.
  • END_TIME: l'ora di fine della finestra nel formato di immissione della data/dell'ora. Viene utilizzata solo la ora specificata del giorno, mentre la data specificata viene ignorata. La data e l'ora specificate devono essere successive all'ora di inizio.

  • MAINTENANCE_RECURRENCE: una RRULE per la ricorrenza della finestra 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. Questo specifica la ricorrenza settimanale della finestra nei giorni selezionati, a partire dall'ora --maintenance-window-start e per la durata specificata.

Per ulteriori informazioni, consulta Configurare la ricorrenza e i tempi del periodo di manutenzione (RRULE).

Il seguente comando crea un'istanza con una finestra di manutenzione di sei ore tra le 12:00 e le 18:00 (UTC) di sabato e domenica ogni settimana.

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'

Aggiornare i periodi di manutenzione di un'istanza

Console

Per aggiornare la finestra di manutenzione in un'istanza esistente nella console Google Cloud:

  1. Vai alla pagina Istanze di Cloud Data Fusion.

    Vai a Istanze

  2. Fai clic sul nome dell'istanza per visualizzarne i dettagli.

  3. Nella pagina Dettagli istanza, vai al campo Finestra di manutenzione e fai clic su Modifica.

  4. I campi della finestra di manutenzione vengono aperti in modalità di modifica. Aggiorna i valori, se necessario:

    1. Seleziona la casella di controllo Abilita periodo di manutenzione.
    2. Nel campo Ora di inizio, inserisci un'ora in un formato supportato.
    3. Nell'elenco Fuso orario, seleziona un fuso orario.
    4. Negli elenchi Giorni e Durata, seleziona i giorni della settimana e la durata della finestra. Per ulteriori informazioni su queste impostazioni, consulta Informazioni sulle operazioni di manutenzione.

  5. Fai clic su Salva.

Per ulteriori informazioni, consulta Configurare la ricorrenza e i tempi del periodo di manutenzione (RRULE).

API REST

Per le istanze esistenti, aggiorna le finestre di manutenzione utilizzando la richiesta dell'API instances.patch. Questa impostazione 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 ulteriori informazioni, consulta Configurare la ricorrenza e i tempi del periodo di manutenzione (RRULE).

L'esempio seguente aggiorna la configurazione del criterio di manutenzione dell'istanza con una finestra 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"
    }
  },
}
}

gcloud

Puoi aggiornare il periodo di manutenzione di un'istanza utilizzando il comando gcloud beta data-fusion instances update.

Per una finestra di manutenzione devono essere definiti i seguenti parametri:

  • --maintenance-window-start imposta l'ora di inizio della finestra.
  • --maintenance-window-end imposta l'ora di fine della finestra.
  • --maintenance-window-recurrence imposta un'RRULE per la ricorrenza della finestra di manutenzione.
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

Sostituisci quanto segue:

  • INSTANCE_NAME: il nome dell'istanza.
  • PROJECT_NAME: il nome del progetto.
  • LOCATION: il nome della regione dell'istanza.
  • START_TIME: l'ora di inizio della finestra nel formato di immissione della data/dell'ora. Viene utilizzata solo la ora specificata del giorno, mentre la data specificata viene ignorata.
  • END_TIME: l'ora di fine della finestra nel formato di immissione della data/dell'ora. Viene utilizzata solo la ora specificata del giorno, mentre la data specificata viene ignorata. La data e l'ora specificate devono essere successive all'ora di inizio.

  • MAINTENANCE_RECURRENCE: una RRULE per la ricorrenza della finestra 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. Questo specifica la ricorrenza settimanale della finestra nei giorni selezionati, a partire dall'ora --maintenance-window-start e per la durata specificata.

Il seguente comando aggiorna l'istanza example-instance con una finestra di manutenzione di sei ore tra le ore 12:00 e le ore 18:00 (UTC) di sabato e domenica ogni settimana.

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'

Configurare la ricorrenza (RRULE) e gli orari dei periodi di manutenzione

Quando configuri le ore di inizio e di fine per la finestra di manutenzione, i componenti della data dei timestamp forniti vengono ignorati. Vengono presi in considerazione solo l'ora del giorno e la durata tra l'ora di inizio e quella di fine. I tempi vengono memorizzati in UTC, ma puoi utilizzare UTC o l'offset del fuso orario quando pianifichi le finestre di manutenzione utilizzando l'API REST o l'interfaccia a riga di comando gcloud.

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

Rimuovere il periodo di manutenzione per un'istanza

Console

Per rimuovere la finestra di manutenzione in un'istanza esistente nella console Google Cloud:

  1. Vai alla pagina Istanze di Cloud Data Fusion.

    Vai a Istanze

  2. Fai clic sul nome dell'istanza per visualizzarne i dettagli.

  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 la finestra di manutenzione da un'istanza, passa un oggetto maintenancePolicy vuoto nel corpo della richiesta.

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

{
    "maintenancePolicy": {}
}

gcloud

Per rimuovere la finestra di manutenzione da un'istanza, utilizza il comando gcloud beta data-fusion instances update con il flag --clear-maintenance-window.

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

Sostituisci quanto segue:

  • INSTANCE_NAME: il nome dell'istanza.
  • PROJECT_NAME: il nome del progetto.
  • LOCATION: il nome della regione dell'istanza.

Passaggi successivi