Documentação do Oracle Cloud Infrastructure

Upgrade do Sistema de Banco de Dados

O MySQL HeatWave Service suporta upgrades automáticos e manuais.

  • Upgrades automáticos:
    • As atualizações na mesma versão, como 8.0.33-u1, são aplicadas automaticamente durante a janela de manutenção que você define no sistema de banco de dados. As versões de atualização contêm patches críticos, como correções de segurança e estabilidade.
    • Uma versão obsoleta torna-se indisponível cerca de três meses após a data de descontinuação. Consulte MySQL Versions Deprecation and Removal Policy in MySQL HeatWave Service. Qualquer sistema de BD que ainda esteja executando uma versão indisponível será submetido a upgrade automaticamente em sua próxima janela de manutenção, de acordo com a política de manutenção definida no Sistema de BD.
    • Para um sistema de banco de dados Always Free, o processo de manutenção sempre fará upgrade da versão do banco de dados para a versão mais alta disponível.
  • Upgrades manuais: Você pode fazer upgrade manualmente da versão. Consulte:
    Observação

    Recomenda-se executar um backup completo do sistema de banco de dados antes de fazer upgrade. Consulte Criando um Backup Manual.

Atualizando Manualmente um Sistema de Banco de Dados Standalone

Use a Console ou a CLI para fazer upgrade manualmente de um sistema de banco de dados stand-alone para uma versão superior. Você pode fazer upgrade para a mesma versão (para obter as correções críticas e de segurança mais recentes), mas não pode fazer downgrade para uma versão anterior.

Observação

Se quiser executar um upgrade de versão principal, como o MySQL 8.0 para o MySQL 8.4, verifique as alterações antes de fazer upgrade. Consulte Upgrade de Versão Principal.

Usando a Console

Use a Console para fazer upgrade manualmente do sistema de banco de dados standalone.

Esta tarefa requer o seguinte:
  • Um sistema de banco de dados standalone em execução.
Para fazer upgrade do sistema de banco de dados, faça o seguinte:
  1. Na página de lista Sistemas de BD, localize os sistemas de BD com os quais você deseja trabalhar. Se precisar de ajuda para localizar a página de lista ou o sistema de banco de dados, consulte Listando Sistemas de Banco de Dados - Usando a Console.
  2. Selecione a guia Detalhes.
  3. No campo Versão do banco de dados, clique em Editar.
    O painel Editar versão do banco de dados é exibido.
  4. Na lista Versão do banco de dados, selecione a versão necessária.
    Observação

    Você poderá selecionar a mesma versão para obter as atualizações de serviço mais recentes se a versão ainda estiver disponível no serviço.
  5. Clique em Atualizar.
O sistema de banco de dados informa o estado UPDATING enquanto está sendo atualizado.

Usando a CLI

Use a interface de linha de comando para fazer upgrade manualmente do sistema de banco de dados stand-alone.

Esta tarefa requer o seguinte:
Para fazer upgrade do sistema de banco de dados, faça o seguinte:
  1. Para recuperar a lista de versões disponíveis, use o comando version list:
    oci mysql version list --compartment-id <CompartmentOCID>
    Você obtém uma resposta semelhante à seguinte:
    {
  "data": [
    {
      "version-family": "8.4",
      "versions": [
        {
          "description": "8.4.6",
          "version": "8.4.6"
        },
        {
          "description": "8.4.7",
          "version": "8.4.7"
    }
  ]
}
  2. Confirme a versão do sistema de banco de dados. Consulte Recuperando a Versão de um MySQL Server.
  3. Atualize a versão de uma versão inferior para uma versão superior, como 8.4.7 para 8.4.8, ou para a mesma versão, como 8.4.7 para 8.4.7, para obter as atualizações de serviço mais recentes:
    oci mysql db-system update 
             --db-system-id <DBSystemOCID> 
             --mysql-version <TargetMySQLVersion>
Depois que você executar o comando da CLI, o status do sistema de banco de dados mudará para UPDATING e, subsequentemente, a versão mudará para a versão MySQL de destino especificada.

Atualizando Manualmente um Sistema de Banco de Dados de Alta Disponibilidade

Quando você faz upgrade de um sistema de banco de dados de alta disponibilidade, as réplicas de leitura são submetidas a upgrade primeiro, seguidas pelos nós secundários, deixando o nó principal por último. Até esse ponto, nenhum período de indisponibilidade é esperado para o ponto final principal do sistema de banco de dados. Quando o upgrade do nó primário começa, as conexões existentes com o principal são fechadas e nenhuma nova conexão é permitida. O nó principal é removido do grupo e um dos nós secundários já atualizados é promovido para o principal. Espera-se que esse failover controlado cause um breve período de indisponibilidade até que as conexões sejam aceitas novamente na instância principal recém-promovida.

Você pode optar por fazer upgrade de todas as instâncias de uma só vez. Ou você pode executar um upgrade controlado do sistema de banco de dados em duas fases separadas, o que permite decidir quando ocorre o período de indisponibilidade do ponto final principal do sistema de banco de dados. No entanto, um upgrade controlado só pode ser executado em um sistema de BD no modo de leitura/gravação. Para executar um upgrade controlado, primeiro faça upgrade dos nós secundários e réplicas de leitura e, em seguida, faça upgrade do nó principal para a mesma versão de destino MySQL. Se você não fizer upgrade do nó principal após fazer upgrade dos nós secundários e réplicas de leitura, o nó principal será automaticamente submetido a upgrade durante a próxima janela de manutenção programada. Um upgrade só é considerado concluído quando todas as instâncias do MySQL no sistema de banco de dados de alta disponibilidade foram submetidas a upgrade para a mesma versão.

Enquanto um upgrade controlado está incompleto ou em andamento:

  • Se uma nova réplica de leitura for criada ou se correções de segurança e patches precisarem ser aplicados aos nós secundários ou réplicas de leitura existentes, as réplicas de leitura e os nós secundários deverão ser atualizados novamente antes de fazer upgrade do nó principal.
  • Você pode iniciar outro upgrade controlado para a mesma versão ou versão superior.
  • Você não pode alternar o sistema de banco de dados do modo leitura-gravação para o modo somente leitura.
Use a Console ou a CLI para fazer upgrade manualmente de um sistema de banco de dados para uma versão superior. Você pode fazer upgrade para a mesma versão (para obter as correções críticas e de segurança mais recentes), mas não pode fazer downgrade para uma versão anterior.
Observação

Se quiser executar um upgrade de versão principal, como o MySQL 8.4 para o MySQL 9.6, verifique as alterações antes de fazer upgrade. Consulte Upgrade de Versão Principal.

Usando a Console

Use a Console para fazer upgrade manualmente do sistema de banco de dados de alta disponibilidade.

Esta tarefa requer o seguinte:
  • Um sistema de banco de dados de alta disponibilidade em execução.
Para atualizar o sistema de banco de dados, execute as seguintes etapas:
  1. Na página de lista Sistemas de BD, localize os sistemas de BD com os quais você deseja trabalhar. Se precisar de ajuda para localizar a página de lista ou o sistema de banco de dados, consulte Listando Sistemas de Banco de Dados - Usando a Console.
  2. Selecione a guia Detalhes.
  3. No campo Versão do banco de dados, clique em Editar.
    O painel Editar versão do banco de dados é exibido.
  4. Na lista Destino de atualização controlada, selecione uma das seguintes opções:
    • Atualizar todas as instâncias de uma vez: para fazer upgrade de todas as instâncias. Se você ainda não tiver executado um upgrade controlado dos nós secundários e réplicas de leitura, essa opção será selecionada por padrão.
    • Atualizar todas as instâncias, exceto a principal: para fazer upgrade de todas as instâncias, exceto do nó principal, que inclui os nós secundários e réplicas de leitura, se houver.
    • Atualizar somente o principal: para fazer upgrade somente do nó principal. Se você já tiver executado um upgrade controlado dos nós secundários e réplicas de leitura, essa opção será selecionada por padrão.
      Observação

      Esta opção só é ativada após você ter concluído um upgrade controlado dos nós secundários e réplicas de leitura.
  5. Na lista Versão do banco de dados, selecione a versão necessária.
    Observação

    Você poderá selecionar a mesma versão para obter as atualizações de serviço mais recentes se a versão ainda estiver disponível no serviço.
  6. Clique em Atualizar.
O sistema de banco de dados informa o estado UPDATING enquanto está sendo submetido a upgrade.

Usando a CLI

Use a interface de linha de comando para fazer upgrade manualmente do sistema de banco de dados de alta disponibilidade.

Esta tarefa requer o seguinte:
Para atualizar o sistema de banco de dados, execute as seguintes etapas:
  1. Para recuperar a lista de versões disponíveis, use o comando version list:
    oci mysql version list --compartment-id <CompartmentOCID>
    Você obtém uma resposta semelhante à seguinte:
    {
  "data": [
    {
      "version-family": "8.4",
      "versions": [
        {
          "description": "8.4.6",
          "version": "8.4.6"
        },
        {
          "description": "8.4.7",
          "version": "8.4.7"
    }
  ]
}
  2. Confirme a versão do sistema de banco de dados. Consulte Recuperando a Versão de um MySQL Server.
  3. Para fazer upgrade da versão inferior para uma versão superior, como 8.4.7 para 8.4.8, ou para a mesma versão, como 8.4.7 para 8.4.7, para obter as atualizações de serviço mais recentes, faça o seguinte:
    1. Para fazer upgrade de todas as instâncias de uma só vez, use o seguinte comando:
      oci mysql db-system update 
             --db-system-id <DBSystemOCID> 
             --mysql-version <TargetMySQLVersion>

      Depois que você executar o comando da CLI, o status do sistema de banco de dados mudará para UPDATING e, subsequentemente, a versão mudará para a versão MySQL de destino especificada.

    2. Como alternativa, para especificar as instâncias de destino de upgrade para um upgrade controlado, faça o seguinte:
      1. Para fazer upgrade de todas as instâncias, exceto do nó principal, que inclui os nós secundários e réplicas de leitura, se houver, use o seguinte comando: 
        oci mysql db-system controlled-update  
             --db-system-id=<DBSystemOCID> 
             --target-mysql-version=<TargetMySQLVersion>  
             --target-db-instances=ALL_BUT_PRIMARY
        Depois que você executa o comando da CLI, o status do sistema de banco de dados muda para UPDATING e, subsequentemente, a versão muda para a versão de destino especificada do MySQL.
      2. Para fazer upgrade do nó principal depois de ter executado um upgrade controlado dos nós secundários e réplicas de leitura, use o seguinte comando: 
        oci mysql db-system controlled-update  
             --db-system-id=<DBSystemOCID> 
             --target-mysql-version=<TargetMySQLVersion>  
             --target-db-instances=PRIMARY_ONLY
        Depois que você executa o comando da CLI, o status do sistema de banco de dados muda para UPDATING e, subsequentemente, a versão muda para a versão de destino especificada do MySQL.