Como localizar e configurar janelas de manutenção

Esta página contém procedimentos para localizar e definir janelas de manutenção para instâncias do Cloud SQL. Para saber mais sobre como e por que o Cloud SQL realiza a manutenção de instâncias, consulte a Visão geral da manutenção de instâncias do Cloud SQL.

Antes de começar

  1. Faça login na sua conta do Google.

    Se você ainda não tiver uma, inscreva-se.

  2. No Console do Cloud, na página do seletor de projetos, selecione ou crie um projeto do Cloud.

    Acessar a página do seletor de projetos

  3. Verifique se a cobrança está ativada para o seu projeto do Google Cloud. Saiba como confirmar se a cobrança está ativada para o seu projeto.

  4. Instale e inicialize o SDK do Cloud..

Como definir uma janela preferencial para manutenção em uma instância

Para definir uma janela de manutenção preferencial, siga estas etapas:

Console

  1. Acesse a página Instâncias.

    ACESSAR A PÁGINA "INSTÂNCIAS"

  2. Clique no nome de uma Instância.
  3. Na página Visão geral da instância do Cloud SQL, clique em Editar preferências de manutenção.
  4. Em Opções de configuração, abra Manutenção.
  5. Configure as seguintes opções:
    • Janela preferencial. Defina o intervalo de dia e hora em que as atualizações podem ocorrer na instância.
    • Ordem de atualização. Defina a ordem de atualização da instância em relação a atualizações de outras instâncias. Defina o momento como Qualquer, Mais cedo ou Mais tarde. Ao comparar instâncias que residem no mesmo local, aquelas que usam a configuração Mais cedo recebem atualizações até uma semana antes das instâncias que usam a configuração Mais tarde.

gcloud

Antes de usar o comando gcloud abaixo, faça as seguintes substituições:
  • instance-id: instância a reagendar
  • day: o dia em que você quer que a manutenção ocorra. Defina como SUN, MON, TUE, WED, THU, FRI ou SAT.
  • hour: hora do dia para a janela de manutenção, no fuso horário UTC (1-24).
    gcloud sql instances patch instance-id
        --maintenance-window-day=day
        --maintenance-window-hour=hour
    
Para informações de referência, consulte gcloud sql instances patch.

Como ativar notificações de manutenção

Mesmo ao ativar as notificações, você não as receberá a menos que defina uma janela preferencial para manutenção em uma instância.

  1. Acesse a página Comunicação.
    ACESSAR A PÁGINA "COMUNICAÇÃO"
  2. Na linha do Cloud SQL, em Janela de manutenção, selecione o botão de opção em E-mail para ATIVAR as notificações.

Cada usuário que precisar receber notificações terá que ativá-las individualmente.

Como encontrar notificações de manutenção no Console do Cloud

É possível visualizar notificações de manutenção em alguns lugares no Console do Cloud:

  • No painel ATIVIDADE, procure instâncias marcadas com Manutenção SQL.
    ACESSAR A PÁGINA "ATIVIDADE"

  • Quando uma instância é programada para manutenção, a data em que isso ocorrerá é listada na coluna Manutenção da página Instâncias. A coluna Manutenção normalmente fica oculta, mas é exibida automaticamente quando a manutenção é programada. Também é possível selecionar Manutenção em Opções de exibição da coluna (O ícone de opções de exibição da coluna tem três linhas) se você quiser que a coluna Manutenção sempre apareça.

  • Como alternativa, é possível selecionar uma instância para acessar a página Detalhes da instância. Se a instância estiver programada para manutenção, você verá uma mensagem no painel Manutenção.
    ACESSAR A PÁGINA "INSTÂNCIAS"

Como reprogramar a manutenção planejada

Para reprogramar a manutenção planejada, siga estas etapas:

Console

  1. Acesse a página Instâncias.

    ACESSAR A PÁGINA "INSTÂNCIAS"

  2. Filtre pelo termo Manutenção para listar todas as instâncias programadas para manutenção.
  3. Na coluna Manutenção, clique em Reprogramar.
  4. Na caixa de diálogo Reprogramar, escolha entre aplicar a manutenção imediatamente, remarcá-la para acontecer dentro de uma semana a partir da hora originalmente planejada ou criar outro momento programado.

gcloud

Antes de usar o comando gcloud abaixo, faça as seguintes substituições:
  • instance-id: a instância a ser reprogramada.
  • reschedule-type: use uma destas opções, IMMEDIATE, NEXT_AVAILABLE_WINDOW ou SPECIFIC_TIME
  • . Se você escolher NEXT_AVAILABLE_WINDOW, a manutenção será reprogramada para ocorrer dentro de uma semana a partir do dia e horário originalmente programados.
  • reschedule-time: se você selecionar SPECIFIC_TIME para reschedule-type, também precisará definir essa sinalização para especificar o novo dia e hora da manutenção. Usa o formato ISO 8601. Por exemplo, 2020-01-16T16:56:00.000Z
  gcloud sql reschedule-maintenance instance-id
      --reschedule-type=reschedule-type
      [--schedule-time=reschedule-time]
  
Para informações de referência, consulte gcloud sql reschedule-maintenance.

REST

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • project-id: o ID do projeto
  • instance-id: o ID da instância
  • reschedule-type: use uma destas opções, IMMEDIATE, NEXT_AVAILABLE_WINDOW ou SPECIFIC_TIME. Se você escolher NEXT_AVAILABLE_WINDOW, a manutenção será reprogramada para ocorrer dentro de uma semana a partir do dia e horário originalmente programados.

Método HTTP e URL:

POST https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/rescheduleMaintenance

Corpo JSON da solicitação:

{
  "reschedule": {
    "reschedule_type": "reschedule-type"
  }
}

Para enviar a solicitação, expanda uma destas opções:

Você receberá uma resposta JSON semelhante a esta:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "startTime": "08:00",
  "endTime": "08:01",
  "operationType": RESCHEDULE_MAINTENANCE,
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}
Para ver como a solicitação de API REST subjacente é criada na tarefa, consulte APIs Explorer na página "instances:post".

A seguir