# Aplicar atualizações de versão do banco de dados
<a name="sqlserver-dev-edition.db-version-upgrade"></a>

O RDS para SQL Server Developer Edition é compatível com atualizações de versão secundária e principal usando Versões de mecanismo personalizadas (CEVs). Para realizar uma atualização, é necessário criar uma nova CEV com a atualização cumulativa (CU) mais recente e aplicá-la à instância. As atualizações de versão do banco de dados para o SQL Server Developer Edition envolvem as seguintes etapas:

## Entender as versões principais e secundárias
<a name="sqlserver-dev-edition.db-version-upgrade.major-minor"></a>

Uma versão principal representa uma versão completa do Microsoft SQL Server. Cada versão principal introduz novos recursos, mudanças significativas na funcionalidade ou nas características de desempenho e mudanças no nível do mecanismo que podem não ser compatíveis com versões anteriores das aplicações existentes.

A tabela a seguir mostra as versões principais:


| Versão do SQL Server | Exemplo de versão do mecanismo | 
| --- | --- | 
| SQL Server 2025 Enterprise Developer Edition | 17.00.4045.5 | 
| SQL Server 2025 Standard Developer Edition | 17.00.4045.5 | 
| SQL Server 2022 Developer Edition | 16.00.4215.2 | 
| SQL Server 2019 Developer Edition | 15.00.4455.2 | 

## Versões secundárias (atualizações cumulativas)
<a name="sqlserver-dev-edition.db-version-upgrade.minor-versions"></a>

Uma versão secundária representa uma atualização cumulativa (CU) lançada pela Microsoft dentro de uma determinada versão principal. As atualizações de versão secundária incluem patches de segurança, correções de bugs e melhorias no mecanismo.

Por exemplo, no SQL Server 2022 (versão principal 16.00), as seguintes são versões secundárias:
+ 16.00.4255.1 (CU25)
+ 16.00.4215.2 (CU21)

Antes de realizar uma atualização de versão, consulte os seguintes recursos para entender os possíveis impactos e as práticas recomendadas:
+ [Considerações sobre a atualização do mecanismo de banco de dados do SQL Server:](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_UpgradeDBInstance.SQLServer.Considerations.html) aborda níveis de compatibilidade, recursos descontinuados, alterações de agrupamento, servidores vinculados e outros fatores que podem afetar as workloads após uma atualização.
+ [Testar uma atualização:](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_UpgradeDBInstance.SQLServer.UpgradeTesting.html) descreve como testar uma atualização de versão principal por meio de uma restauração de snapshot antes de aplicá-la à instância de produção, ajudando a identificar problemas sem afetar as workloads em produção.

## Verificar a versão atual do mecanismo e identificar a versão de destino
<a name="sqlserver-dev-edition.db-version-upgrade.verify"></a>

Use o comando `describe-db-engine-versions` da AWS CLI para visualizar as versões compatíveis e determinar os destinos de atualização válidos para a versão atual do mecanismo. Isso ajuda a distinguir os caminhos de atualização de versão principal e secundária antes de aplicar as alterações. Identifique a versão de destino do mecanismo de banco de dados entre as versões compatíveis do Amazon RDS. Para obter informações sobre quais versões do SQL Server estão disponíveis no Amazon RDS, consulte [Trabalhar com o SQL Server Developer Edition no RDS para SQL Server](sqlserver-dev-edition.md).

```
aws rds describe-db-engine-versions \
  --engine sqlserver-dev-ee \
  --engine-version "16.00.4215.2.my-cev" \
  --query "DBEngineVersions[0].ValidUpgradeTarget[*].{EngineVersion:EngineVersion,IsMajorVersionUpgrade:IsMajorVersionUpgrade}" \
  --output table
```

```
---------------------------------------------------------
|              DescribeDBEngineVersions                  |
+----------------------------+--------------------------+
|       EngineVersion        |  IsMajorVersionUpgrade   |
+----------------------------+--------------------------+
|  16.00.4255.1.my-target-cev|  False                   |
|  17.00.4055.5.my-target-cev|  True                    |
+----------------------------+--------------------------+
```

Nesta saída:
+ `IsMajorVersionUpgrade: False` indica uma atualização de versão secundária
+ `IsMajorVersionUpgrade: True` indica uma atualização de versão principal

## Criar uma nova versão de mecanismo personalizada
<a name="sqlserver-dev-edition.db-version-upgrade.create-cev"></a>

Obtenha e faça upload da mídia de instalação necessária (ISO e CU) e, em seguida, crie uma nova CEV. Consulte instruções detalhadas sobre como criar uma CEV em [Criar uma versão de mecanismo personalizada para RDS para SQL Server Developer Edition](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/sqlserver-dev-edition.creating-cev.html).

Execute `describe-db-engine-versions` para confirmar os caminhos de atualização válidos para sua CEV:

```
aws rds describe-db-engine-versions \
  --engine sqlserver-dev-ee \
  --engine-version "16.00.4215.2.my-cev" \
  --query "DBEngineVersions[0].ValidUpgradeTarget[*].{EngineVersion:EngineVersion,IsMajorVersionUpgrade:IsMajorVersionUpgrade}" \
  --output table
```

Resultado do exemplo:

```
---------------------------------------------------------
|              DescribeDBEngineVersions                  |
+----------------------------+--------------------------+
|       EngineVersion        |  IsMajorVersionUpgrade   |
+----------------------------+--------------------------+
|  17.00.4055.5.my-target-cev|  True                    |
+----------------------------+--------------------------+
```

## Aplicar a atualização de versão
<a name="sqlserver-dev-edition.db-version-upgrade.apply"></a>

### Como usar o AWS CLI
<a name="sqlserver-dev-edition.db-version-upgrade.apply.cli"></a>

Aplique a atualização de versão usando o comando [modify-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html) do Amazon RDS com a nova CEV:

```
aws rds modify-db-instance \
--db-instance-identifier <instance-id> \
--engine-version <new-cev-version> \
--allow-major-version-upgrade ## required only for major version upgrades \
--no-apply-immediately ## use --apply-immediately for immediate update
```

**nota**  
`--no-apply-immediately` (o padrão) para aplicar as alterações durante a próxima janela de manutenção.

**Importante**  
O parâmetro `--allow-major-version-upgrade` é obrigatório para atualizações de versão principal.

### Usar do o Console do Gerenciamento da AWS
<a name="sqlserver-dev-edition.db-version-upgrade.apply.console"></a>

Para atualizar a versão do mecanismo de uma instância de banco de dados usando o Console:

1. Faça login no Console de Gerenciamento da AWS e abra o console do Amazon RDS em [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1. No painel de navegação, escolha **Databases (Bancos de dados)** e a instância de banco de dados que você deseja atualizar.

1. Selecione **Modify**. A página Modify DB Instance (Modificar instância de banco de dados) é exibida.

1. Em **Versão do mecanismo de banco de dados**, escolha a nova versão de destino (sua nova CEV) na lista suspensa.

1. Selecione **Continuar** e revise o resumo das modificações.

1. Escolha quando aplicar as alterações: 
   + Selecione **Aplicar imediatamente** para iniciar a atualização agora.
   + Selecione **Aplicar durante a próxima janela de manutenção programada** para aplicar as alterações durante a próxima janela de manutenção programada.

1. Selecione **Modify DB Instance (Modificar instância de banco de dados)** para salvar suas alterações.