Partilhar via

Janela de manutenção - Serviços de dados habilitados para Azure Arc

  • Artigo

Configure uma janela de manutenção em um controlador de dados para definir um período de tempo para atualizações. Nesse período de tempo, as Instâncias Gerenciadas SQL habilitadas para Arc nesse controlador de dados que têm a desiredVersion propriedade definida como auto serão atualizadas.

Durante a configuração, especifique uma duração, recorrência e data e hora de início. Depois que a janela de manutenção for iniciada, ela será executada pelo período de tempo definido na duração. As instâncias anexadas ao controlador de dados começarão as atualizações (em paralelo). No final da duração definida, todas as atualizações em andamento continuarão a ser concluídas. Todas as instâncias que não começaram a atualizar na janela começarão a atualizar na recorrência a seguir.

Pré-requisitos

uma Instância Gerenciada SQL habilitada pelo Azure Arc com a desiredVersion propriedade definida como auto.

Limitações

A duração da janela de manutenção pode ser de 2 horas a 8 horas.

Apenas uma janela de manutenção pode ser definida por controlador de dados.

Configurar uma janela de manutenção

A janela de manutenção tem estas configurações:

  • Duração - O período de tempo em que a janela será executada, expresso em horas e minutos (HH:mm).
  • Recorrência - com que frequência a janela ocorrerá. Todas as palavras diferenciam maiúsculas de minúsculas e devem ser maiúsculas. Você pode definir janelas semanais ou mensais.
    • Semanalmente
      • [Semana | Semanal][dia da semana]
      • Exemplos:
        • --recurrence "Week Thursday"
        • --recurrence "Weekly Saturday"
    • Mensal
      • [Mês | Mensal] [Primeiro | Segundo | Terceiro | Quarta | Último] [dia da semana]
      • Exemplos:
        • --recurrence "Month Fourth Saturday"
        • --recurrence "Monthly Last Monday"
    • Se a recorrência não for especificada, será uma janela de manutenção única.
  • Início - a data e hora em que ocorrerá a primeira janela, no formato YYYY-MM-DDThh:mm (formato de 24 horas).
    • Exemplo:
      • --start "2022-02-01T23:00"
  • Fuso horário - o fuso horário associado à janela de manutenção.

CLI

Para criar uma janela de manutenção, use o seguinte comando:

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

Exemplo:

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

Monitorar as atualizações

Durante a janela de manutenção, você pode visualizar o status das atualizações.

kubectl -n <namespace> get sqlmi -o yaml

Os status.runningVersion campos e status.lastUpdateTime mostrarão a versão mais recente e quando o status foi alterado.

Ver janela de manutenção existente

Você pode visualizar a datacontroller janela de manutenção na especificação.

kubectl describe datacontroller -n <namespace>

Saída:

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

Atualizações com falha

Não há reversão automática para atualizações com falha. Se uma instância não for atualizada automaticamente, será necessária uma intervenção manual para fixar a instância à sua versão atual em execução, usando az sql mi-arc update. Depois que o problema for resolvido, a versão pode ser redefinida para "auto".

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

Exemplo:

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

Desativar janela de manutenção

Quando a janela de manutenção estiver desativada, as atualizações automáticas não serão executadas.

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

Exemplo:

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

Ativar janela de manutenção

Quando a janela de manutenção estiver ativada, as atualizações automáticas serão retomadas.

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

Exemplo:

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

Alterar as opções da janela de manutenção

O comando update pode ser usado para alterar qualquer uma das opções. Neste exemplo, atualizarei a hora de início.

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

Exemplo:

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

Conteúdos relacionados

Habilitar atualizações automáticas de uma instância gerenciada SQL