Condividi tramite


Finestra di manutenzione - Servizi dati abilitati per Azure Arc

Configurare una finestra di manutenzione in un controller dati per definire un periodo di tempo per gli aggiornamenti. In questo periodo di tempo, le Istanza gestita di SQL abilitate per Arc nel controller di dati con la desiredVersion proprietà impostata su auto verranno aggiornate.

Durante l'installazione, specificare una durata, una ricorrenza e una data e un'ora di inizio. Dopo l'avvio, la finestra di manutenzione resterà in esecuzione per il periodo di tempo impostato nella durata. Le istanze collegate al controller dati inizieranno gli aggiornamenti (in parallelo). Alla fine della durata impostata, tutti gli aggiornamenti in corso continueranno fino al completamento. Tutte le istanze che non hanno iniziato l'aggiornamento all'interno della finestra inizieranno l'aggiornamento nella ricorrenza successiva.

Prerequisiti

un Istanza gestita di SQL abilitato da Azure Arc con la proprietà impostata su auto.desiredVersion

Limiti

La durata dell'intervallo di manutenzione può essere compresa tra 2 ore e 8 ore.

È possibile impostare una sola finestra di manutenzione per ogni titolare del trattamento dei dati.

Configurare una finestra di manutenzione

La finestra di manutenzione include queste impostazioni:

  • Durata: durata dell'esecuzione dell'intervallo, espressa in ore e minuti (HH:mm).
  • Ricorrenza: frequenza con cui si verificherà la finestra. Tutte le parole fanno distinzione tra maiuscole e minuscole e devono essere maiuscole. È possibile impostare finestre settimanali o mensili.
    • Settimanale
      • [Settimana | Settimanale][giorno della settimana]
      • Esempi:
        • --recurrence "Week Thursday"
        • --recurrence "Weekly Saturday"
    • Mensile
      • [Mese | Mensile] [First | Secondo | Terzo | Quarto | Ultimo] [giorno della settimana]
      • Esempi:
        • --recurrence "Month Fourth Saturday"
        • --recurrence "Monthly Last Monday"
    • Se non viene specificata la ricorrenza, si tratta di un intervallo di manutenzione monouso.
  • Inizio: la data e l'ora della prima finestra verranno eseguite nel formato YYYY-MM-DDThh:mm (formato 24 ore).
    • Esempio:
      • --start "2022-02-01T23:00"
  • Fuso orario: fuso orario associato alla finestra di manutenzione.

CLI

Per creare una finestra di manutenzione, usare il comando seguente:

az arcdata dc update --maintenance-start <date and time> --maintenance-duration <time> --maintenance-recurrence <interval> --maintenance-time-zone <time zone> --k8s-namespace <namespace> --use-k8s

Esempio:

az arcdata dc update --maintenance-start "2022-01-01T23:00" --maintenance-duration 3:00 --maintenance-recurrence "Monthly First Saturday" --maintenance-time-zone US/Pacific --k8s-namespace arc --use-k8s

Monitorare gli aggiornamenti

Durante la finestra di manutenzione, è possibile visualizzare lo stato degli aggiornamenti.

kubectl -n <namespace> get sqlmi -o yaml 

I status.runningVersion campi e status.lastUpdateTime mostreranno la versione più recente e quando lo stato è stato modificato.

Visualizzare la finestra di manutenzione esistente

È possibile visualizzare la finestra di manutenzione nella datacontroller specifica.

kubectl describe datacontroller -n <namespace>

Output:

Spec:  
  Settings:
    Maintenance:
      Duration:    3:00
      Recurrence:  Monthly First Saturday
      Start:       2022-01-01T23:00
      Time Zone:   US/Pacific

Aggiornamenti non riusciti

Non è disponibile alcun rollback automatico per gli aggiornamenti non riusciti. Se un'istanza non è riuscita ad eseguire automaticamente l'aggiornamento, sarà necessario l'intervento manuale per aggiungere l'istanza alla versione corrente in esecuzione usando az sql mi-arc update. Dopo aver risolto il problema, la versione può essere impostata di nuovo su "auto".

az sql mi-arc upgrade --name <instance name> --desired-version <version> 

Esempio:

az sql mi-arc upgrade --name sql01 --desired-version v1.2.0_2021-12-15

Disabilitare la finestra di manutenzione

Quando la finestra di manutenzione è disabilitata, gli aggiornamenti automatici non verranno eseguiti.

az arcdata dc update --maintenance-enabled false --k8s-namespace <namespace> --use-k8s

Esempio:

az arcdata dc update --maintenance-enabled false --k8s-namespace arc --use-k8s

Abilitare la finestra di manutenzione

Quando la finestra di manutenzione è abilitata, gli aggiornamenti automatici riprenderanno.

az arcdata dc update --maintenance-enabled true --k8s-namespace <namespace> --use-k8s

Esempio:

az arcdata dc update --maintenance-enabled true --k8s-namespace arc --use-k8s

Modificare le opzioni della finestra di manutenzione

Il comando update può essere usato per modificare una qualsiasi delle opzioni. In questo esempio aggiornerò l'ora di inizio.

az arcdata dc update --maintenance-start <date and time> --k8s-namespace arc --use-k8s

Esempio:

az arcdata dc update --maintenance-start "2022-04-15T23:00" --k8s-namespace arc --use-k8s

Abilitare gli aggiornamenti automatici di un Istanza gestita di SQL