# Atualizar uma instância de banco de dados BYOM para o RDS para SQL Server
Você pode aplicar atualizações de versão secundária do mecanismo às instâncias de banco de dados BYOM no RDS para SQL Server. As atualizações de versão secundária incluem atualizações cumulativas (CUs) da Microsoft que contêm correções de segurança, correções de bugs e melhorias de desempenho.
Diferentemente das instâncias de Licença incluída, a atualização de uma instância BYOM exige que uma versão de mecanismo BYOM esteja disponível antes que você inicie a atualização.
## Identificar destinos de atualização válidos
Antes de atualizar, identifique quais versões de mecanismo estão disponíveis como destinos válidos para atualização da sua versão atual.
Use o comando `describe-db-engine-versions` para listar os destinos válidos para atualização de versão secundária:
**Exemplo:**
```
aws rds describe-db-engine-versions \
--engine sqlserver-ee \
--engine-version 15.00.4440.1.v1 \
--include-all \
--query "DBEngineVersions[?DBEngineMediaType=='Customer Provided'].ValidUpgradeTarget[] | [?IsMajorVersionUpgrade==\`false\`]"
```
**Exemplo de saída:**
```
[
{
"Engine": "sqlserver-ee",
"EngineVersion": "15.00.4455.2.v1",
"AutoUpgrade": false,
"IsMajorVersionUpgrade": false
},
.....
{
"Engine": "sqlserver-ee",
"EngineVersion": "15.00.4465.1.v1",
"AutoUpgrade": false,
"IsMajorVersionUpgrade": false
}
]
```
## Aplicar uma atualização de versão BYOM (AWS CLI)
Antes de iniciar uma atualização de versão, crie um snapshot manual. O Amazon RDS cria snapshots automatizados, mas um snapshot manual fornece um ponto de restauração conhecido.
**Exemplo:**
```
aws rds modify-db-instance \
--db-instance-identifier my-byom-instance \
--engine-version 15.00.4465.1.v1 \
--no-apply-immediately
```
**nota**
Ao usar `--no-apply-immediately`, o Amazon RDS aplica a alteração durante a próxima janela de manutenção. Use `--apply-immediately` para aplicar a alteração imediatamente. Consulte mais informações em [Usar a configuração de programação de modificações](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ModifyInstance.ApplyImmediately.html).
## Verificar a atualização
Depois que a atualização for concluída, verifique a nova versão de mecanismo da instância de banco de dados.
**Exemplo:**
```
aws rds describe-db-instances \
--db-instance-identifier my-byom-instance \
--query "DBInstances[*].[DBInstanceIdentifier,EngineVersion,DBInstanceStatus,LicenseModel]"
```
```
[
[
"my-byom-instance",
"15.00.4465.1.v1",
"available",
"bring-your-own-media"
]
]
```
Confirme os seguintes valores:
+ `EngineVersion` corresponde à versão de destino.
+ `DBInstanceStatus` é `available`.
+ `LicenseModel` é `bring-your-own-media`.
## Converter uma instância de Licença incluída em Traga sua própria mídia
Você pode converter uma instância existente do RDS para SQL Server do modelo de Licença incluída para BYOM. Isso permite usar suas próprias licenças do SQL Server em vez de pagar a taxa de licença incluída da AWS.
**nota**
É necessário que exista uma versão de mecanismo BYOM com o status `available` para a versão de mecanismo atual da instância.
Use o comando `modify-db-instance` para alterar o modelo de licença:
```
aws rds modify-db-instance \
--db-instance-identifier DB_INSTANCE_IDENTIFIER \
--license-model bring-your-own-media \
--no-apply-immediately
```
**nota**
Ao usar `--no-apply-immediately`, o Amazon RDS aplica a alteração durante a próxima janela de manutenção. Use `--apply-immediately` para aplicar a alteração imediatamente. Consulte mais informações em [Usar a configuração de programação de modificações](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ModifyInstance.ApplyImmediately.html).
Para verificar o modelo de licença atual da sua instância de banco de dados, use o comando `describe-db-instances` e verifique o campo `LicenseModel` na resposta. Se houver uma modificação em andamento, verifique o campo `PendingModifiedValues` para ver o modelo de licença pendente. Após a conclusão da modificação, o campo `LicenseModel` refletirá o novo valor. Consulte mais informações em [Descrever uma instância de banco de dados](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-instances.html).
## Considerações
+ Não há suporte para converter BYOM em Licença incluída.
+ Se a instância Licença incluída (LI) tiver réplicas de leitura, remova-as antes de converter o modelo de licença para BYOM e recrie-as depois. As novas réplicas herdarão automaticamente o modelo de licenciamento BYOM.
+ Se a instância de banco de dados LI estiver usando uma classe de instância incompatível com BYOM (por exemplo, db.m5 ou db.r6i), não será possível convertê-la diretamente para BYOM. Primeiro, modifique a instância para uma classe de instância compatível (7ª geração ou posterior) e, depois, converta o modelo de licença em uma operação de modificação separada.