Atualizar a versão principal de um banco de dados do Lightsail - Amazon Lightsail
Pré-requisitosAtualizar a versão principal do banco de dadosPróximas etapas

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Atualizar a versão principal de um banco de dados do Lightsail

Quando o Amazon Lightsail aceita a nova versão de um mecanismo de banco de dados, você pode atualizar o banco de dados para essa nova versão. O Lightsail oferece dois esquemas de banco de dados: MySQL e PostgreSQL. Este guia descreve como atualizar a versão principal da instância de banco de dados MySQL ou PostgreSQL. Você pode atualizar a versão principal do banco de dados apenas por meio da ação de API update-relational-database.

Usaremos o AWS CloudShell para fazer a atualização. O CloudShell é um shell pré-autenticado e baseado em navegador que você pode iniciar diretamente do console do Lightsail. Com o CloudShell, você pode executar comandos da AWS Command Line Interface (AWS CLI) usando o shell de sua preferência, como Bash, PowerShell ou Z shell. Você pode fazer isso sem baixar nem instalar ferramentas de linha de comando. Para obter mais informações sobre como configurar e usar o CloudShell, consulte AWS CloudShell no Lightsail.

Entender as alterações

As atualizações de versões principais podem introduzir várias incompatibilidades com a versão anterior. Essas incompatibilidades podem causar problemas durante uma atualização. Você talvez tenha que preparar o banco de dados para a atualização ser bem-sucedida. Para obter informações sobre como atualizar as versões principais de um banco de dados, consulte os tópicos a seguir nos sites do MySQL e do PostgreSQL.

Pré-requisitos

  1. Verifique se a sua aplicação é compatível com as duas versões principais do banco de dados.

  2. Recomendamos que você crie um snapshot da instância de banco de dados antes de fazer qualquer alteração. Para obter mais informações, consulte Criar um snapshot do banco de dados do Lightsail.

  3. (Opcional) Crie uma nova instância de banco de dados do snapshot que você acabou de criar. Como as atualizações de banco de dados exigem um tempo de inatividade, você pode testar a atualização no novo banco de dados antes de atualizar o que já está ativo. Para obter mais informações sobre como criar uma cópia do banco de dados, consulte Criar um snapshot do banco de dados do Lightsail.

Atualizar a versão principal do banco de dados

LightsailO oferece suporte para atualizações de versões principais de instâncias de banco de dados MySQL e PostgreSQL. Um banco de dados MySQL é usado como exemplo no procedimento a seguir. No entanto, o processo e os comandos são iguais para um banco de dados PostgreSQL.

Conclua o procedimento a seguir para atualizar a versão principal do banco de dados do Lightsail.

  1. Faça login no console do Lightsail.

  2. No painel de navegação à esquerda, selecione Bancos de dados.

  3. Observe o nome e a Região da AWS da instância de banco de dados que você deseja atualizar.

    O nome e a região da nova instância de banco de dados no console do Lightsail.

  4. No canto inferior esquerdo do console do Lightsail, escolha CloudShell. Um terminal do CloudShell é aberto na mesma guia do navegador. Quando o prompt de comando for exibido, o shell estará pronto para interação.

  5. Digite o comando a seguir no prompt do CloudShell para retornar uma lista de IDs dos esquemas de banco de dados disponíveis.

    aws lightsail get-relational-database-blueprints

  6. Observe o ID do esquema referente à versão principal para a qual você está atualizando. Por exemplo, mysql_8_0.

    A resposta do comando get-relational-database-blueprints na janela do CloudShell.

  7. Digite o comando a seguir para atualizar a versão principal do banco de dados. A atualização será feita na próxima janela de manutenção do banco de dados. No comando, substitua DatabaseName pelo nome do banco de dados, blueprintId pelo ID do esquema da versão principal para a qual você está atualizando e DatabaseRegion pela Região da AWS onde reside o banco de dados.

    aws lightsail update-relational-database \
 --relational-database-name DatabaseName \
 --relational-database-blueprint-id blueprintId \
 --region DatabaseRegion

    (Opcional) Para aplicar a atualização imediatamente, inclua o parâmetro --apply-immediately no comando. Você verá uma resposta semelhante ao exemplo a seguir, e o banco de dados ficará indisponível durante a aplicação da atualização. Para obter mais informações, consulte update-relational-database na Referência da API do Lightsail.

    O resultado bem-sucedido do comando update-relational-database --apply-immediately na janela do CloudShell.

  8. Digite o comando a seguir para verificar se a atualização da versão principal está programada para a próxima janela de manutenção do banco de dados. No comando, substitua DatabaseName pelo nome do banco de dados e DatabaseRegion pela Região da AWS onde reside o banco de dados.

    aws lightsail get-relational-database \
 --relational-database-name DatabaseName \
 --region DatabaseRegion

    Na resposta do get-relational-database, o state do banco de dados informa você sobre uma atualização pendente da versão principal na próxima janela de manutenção. Você encontra a data e a hora da próxima janela de manutenção na seção preferredMaintenanceWindow da resposta.

    Estado da instância de banco de dados

    "state": "upgrading",
  "backupRetentionEnabled": true, 
  "pendingModifiedValues": {
  "engineVersion": "8.0.36"

    Janela de manutenção

    "preferredMaintenanceWindow": "wed: 09:22-wed: 09:52"

Próximas etapas

Se você criou um banco de dados de teste, poderá excluí-lo depois de verificar se a aplicação funciona com o banco de dados atualizado. Mantenha o snapshot que você criou do banco de dados anterior, caso precise revertê-lo. Você também deve criar um snapshot do banco de dados atualizado para ter uma nova cópia dele para um ponto no tempo.