Compartilhar via

Janela de manutenção – serviços de dados habilitados para o 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, as Instâncias Gerenciadas de SQL habilitadas para o Arc desse controlador de dados que têm a propriedade desiredVersion definida como auto, serão atualizadas.

Durante a configuração, especifique uma duração, a recorrência e a 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 iniciarão as atualizações (em paralelo). No final da duração definida, todas as atualizações em andamento continuarão até a conclusão. As instâncias que não começaram a atualizar na janela começarão a ser atualizadas na próxima recorrência.

Pré-requisitos

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

Limitações

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

Somente 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, expressa 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 colocadas em maiúsculas. Você pode definir janelas semanais ou mensais.
    • Semanal
      • [Semana | Semanalmente][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 de uma única vez.
  • Início – a data e a hora em que a primeira janela ocorrerá, 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 exibir o status das atualizações.

kubectl -n <namespace> get sqlmi -o yaml

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

Exibir a janela de manutenção existente

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

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 tiver sido atualizada automaticamente, será necessária uma intervenção manual para fixar a instância em sua versão em execução atual, usando az sql mi-arc update. Depois que o problema for resolvido, a versão poderá ser definida novamente como "automática".

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

Desabilitar janela de manutenção

Quando a janela de manutenção for desabilitada, 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

Habilitar janela de manutenção

Quando a janela de manutenção for habilitada, 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 de atualização 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údo relacionado

Habilitar atualizações automáticas de uma Instância Gerenciada de SQL