Condividi tramite

Finestra di manutenzione - Servizi dati abilitati per Azure Arc

  • Articolo

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

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 dei 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 abilitata da Azure Arc con la proprietà desiredVersion impostata su auto.

Limiti

La durata della finestra di manutenzione può essere compresa tra 2 ore e 8 ore.

È possibile impostare una sola finestra di manutenzione per ogni controller dei dati.

Configurare una finestra di manutenzione

La finestra di manutenzione include queste impostazioni:

  • Durata: la durata dell'esecuzione dell'intervallo, espressa in ore e minuti (HH:mm).
  • Ricorrenza: la 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] [Primo | 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 una finestra di manutenzione una tantum.
  • Inizio: la data e l'ora di esecuzione della prima finestra, nel formato YYYY-MM-DDThh:mm (formato a 24 ore).
    • Esempio:
      • --start "2022-02-01T23:00"
  • Fuso orario: il 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 campi status.runningVersion 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 specifica datacontroller.

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 un 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 nuovamente 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 di aggiornamento può essere usato per modificare una qualsiasi delle opzioni. In questo esempio, viene aggiornata 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

Contenuto correlato

Abilitare gli aggiornamenti automatici di un'istanza gestita di SQL