# Trabalhar com o SQL Server Developer Edition no RDS para SQL Server
O RDS para SQL Server comporta o SQL Server Developer Edition. A Developer Edition inclui todos os recursos do SQL Server Enterprise Edition, mas é licenciada somente para uso não produtivo. Você pode criar instâncias do RDS para SQL Server Developer Edition usando sua própria mídia de instalação por meio do recurso de versão personalizada do mecanismo (CEV).
## Benefícios
Você pode usar o RDS para SQL Server Developer Edition para:
+ Reduzir os custos em ambientes de desenvolvimento e teste e, ao mesmo tempo, manter a paridade de recursos com os bancos de dados de produção.
+ Acessar os recursos da Enterprise Edition em ambientes que não sejam de produção sem taxas de licenciamento corporativo.
+ Usar os recursos de gerenciamento automatizado do Amazon RDS, incluindo backups, aplicação de patches e monitoramento.
**nota**
O SQL Server Developer Edition é licenciado somente para fins de desenvolvimento e teste e não pode ser usado em ambientes de produção.
## Disponibilidade de regiões
O RDS para SQL Server Developer Edition está disponível nas seguintes regiões da AWS:
+ Leste dos EUA (Norte da Virgínia)
+ Leste dos EUA (Ohio)
+ Oeste dos EUA (Oregon)
+ Oeste dos EUA (N. da Califórnia)
+ Ásia-Pacífico (Mumbai)
+ Ásia-Pacífico (Seul)
+ Ásia-Pacífico (Singapura)
+ Ásia-Pacífico (Osaka)
+ Ásia-Pacífico (Sydney)
+ Ásia-Pacífico (Tóquio)
+ Europa (Irlanda)
+ Europa (Frankfurt)
+ Europa (Londres)
+ Europa (Estocolmo)
+ Europa (Paris)
+ Canadá (Central)
+ América do Sul (São Paulo)
+ África (Cidade do Cabo)
## Licenciamento e uso
O SQL Server Developer Edition é licenciado pela Microsoft somente para ambientes de desenvolvimento e teste. Você não pode usar a Developer Edition como servidor de produção. Ao usar o SQL Server Developer Edition no Amazon RDS, você é responsável por cumprir os termos de licenciamento do SQL Server Developer Edition da Microsoft. Você paga somente pelos custos de infraestrutura da AWS: não há taxa adicional de licenciamento do SQL Server. Para acessar detalhes sobre preço, consulte [Preço do Amazon RDS para SQL Server](https://aws.amazon.com/rds/sqlserver/pricing/).
## Pré-requisitos
Antes de usar o SQL Server Developer Edition no RDS para SQL Server, verifique se você tem os seguintes requisitos:
+ Você deve acessar os binários de instalação diretamente da Microsoft e garantir a conformidade com os respectivos termos de licenciamento.
+ Você deve ter acesso para usar os seguintes recursos a fim de criar uma instância de banco de dados Developer Edition:
+ Conta da AWS com as permissões `AmazonRDSFullAccess` e `s3:GetObject`.
+ Um bucket do Amazon S3 é necessário para armazenar a mídia de instalação. Você precisará de um arquivo ISO e de atualização cumulativa para fazer upload no bucket do Amazon S3 como parte da criação da CEV. Para acessar mais informações, consulte [Fazer upload da mídia de instalação para um bucket do Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/upload-objects.html).
+ Todos os arquivos de mídia de instalação devem residir no mesmo bucket que o Amazon S3 e no mesmo caminho de pasta dentro desse bucket do Amazon S3 na mesma região em que a versão personalizada do mecanismo foi criada.
### Versões compatíveis
A Developer Edition no RDS para SQL Server comporta as seguintes versões:
+ SQL Server 2022 CU 21 (16.00.4215.2)
+ SQL Server 2019 CU 32 GDR (15.00.4455.2)
Para listar todas as versões de mecanismo aceitas para a criação de CEV do Developer Edition, execute o seguinte comando AWS CLI:
```
aws rds describe-db-engine-versions --engine sqlserver-dev-ee --output json --query "{DBEngineVersions: DBEngineVersions[?Status=='requires-custom-engine-version'].{Engine: Engine, EngineVersion: EngineVersion, Status: Status, DBEngineVersionDescription: DBEngineVersionDescription}}"
```
O comando exibirá uma saída semelhante ao seguinte exemplo:
```
{
"DBEngineVersions": [
{
"Engine": "sqlserver-dev-ee",
"EngineVersion": "16.00.4215.2.v1",
"Status": "requires-custom-engine-version",
"DBEngineDescription": "Microsoft SQL Server Enterprise Developer Edition",
"DBEngineVersionDescription": "SQL Server 2022 16.00.4215.2.v1"
}
]
}
```
O status da versão do mecanismo como `requires_custom_engine_version` identifica as versões do mecanismo de modelo que são aceitas. Esses modelos mostram quais versões do SQL Server você pode importar.
## Limitações
As seguintes limitações se aplicam ao SQL Server Developer Edition no Amazon RDS:
+ Atualmente, só é compatível com as classes de instância M6i e R6i.
+ As implantações multi-AZ e as réplicas de leitura não são aceitas.
+ Você deve fornecer e gerenciar sua própria mídia de instalação do SQL Server.
+ As versões personalizadas do mecanismo para o SQL Server Developer Edition (sqlserver-dev-ee) não podem ser compartilhadas entre regiões ou entre contas.
# Preparar uma CEV para RDS para SQL Server
## Pré-requisitos
Antes de criar uma versão personalizada do mecanismo, certifique-se de ter cumprido os seguintes pré-requisitos:
### Preparar a mídia de instalação do SQL Server Developer Edition
Você deve ter a mídia de instalação do SQL Server Developer Edition da Microsoft e prepará-la para fazer upload dela para o S3.
**Como baixar a mídia de instalação da Microsoft**
1. **Opção A:** use sua [assinatura do Visual Studio](https://visualstudio.microsoft.com/subscriptions/) para baixar a ISO do Developer Edition. Somente a versão em inglês é aceita.
1. **Opção B: use o instalador do SQL Server**
1. Baixe o [instalador do SQL Server Developer Edition](https://download.microsoft.com/download/c/c/9/cc9c6797-383c-4b24-8920-dc057c1de9d3/SQL2022-SSEI-Dev.exe).
1. Execute o instalador e escolha **Baixar mídia** para baixar o ISO completo.
1. Escolha o **inglês** como idioma preferido.
1. Escolha **ISO** como o tipo de mídia.
1. Escolha **Baixar**.
**Como baixar atualizações cumulativas**
1. Acesse a página [Microsoft Catalog Update](https://www.catalog.update.microsoft.com/Home.aspx).
1. Encontre um SQL Server Developer Edition compatível com o RDS para SQL Server, por exemplo, “Atualização cumulativa do SQL Server 2022”.
1. Baixe o arquivo executável CU mais recente aceito e salve-o em sua máquina.
1. Arquivos de exemplo: `SQLServer2022-KB5065865-x64.exe` (CU21 para SQL Server 2022)
**Importante**
O RDS para SQL Server é compatível somente com versões específicas de atualização cumulativa (CU). É necessário usar a versão exata listada na tabela abaixo. Não use versões mais recentes de CU, mesmo que estejam disponíveis na Microsoft, pois elas podem não ser compatíveis com o RDS.
Também é possível baixar o arquivo de atualização cumulativa (CU) necessário diretamente.
A seguinte tabela lista a versão compatível do SQL Server Developer Edition e a atualização cumulativa correspondente para uso com o RDS:
| Versão do SQL Server | CU compatível | Artigo da base de conhecimento | Nome do arquivo de download |
| --- | --- | --- | --- |
| SQL Server 2022 | `CU21` | [KB5065865](https://learn.microsoft.com/en-us/troubleshoot/sql/releases/sqlserver-2022/cumulativeupdate21) | `SQLServer2022-KB5065865-x64.exe` |
| SQL Server 2019 | `CU32 GDR` | [KB5068404](https://support.microsoft.com/en-us/topic/kb5068404-description-of-the-security-update-for-sql-server-2019-cu32-november-11-2025-c203bfbf-036e-46d2-bc10-6c01200dc48a) | `SQLServer2019-KB5068404-x64.exe` |
# Criar uma versão de mecanismo personalizada para RDS para SQL Server
Uma versão de mecanismo personalizada (CEV) para o RDS para SQL Server consiste na mídia de instalação do SQL Server Developer Edition importada para o Amazon RDS. É necessário fazer upload do instalador ISO básico e dos arquivos de atualização cumulativa (.exe) em seu bucket do Amazon S3. Depois de fazer upload, você deve fornecer a localização do Amazon S3 ao RDS para que ele baixe, valide e, posteriormente, crie a CEV.
## Limitações de nomenclatura
Ao criar uma CEV, você deve seguir convenções de nomenclatura específicas:
+ O nome da CEV deve seguir o padrão `major-version.minor-version.customized-string`.
+ `customized-string` pode conter de 1 a 50 caracteres alfanuméricos, sublinhados, travessões e pontos. Por exemplo: `16.00.4215.2.my-dev-cev` para SQL Server 2022.
Para listar todas as versões do mecanismo disponíveis, use o seguinte comando:
```
aws rds describe-db-engine-versions --engine sqlserver-dev-ee --output json --query "{DBEngineVersions: DBEngineVersions[?Status=='requires-custom-engine-version'].{Engine: Engine, EngineVersion: EngineVersion, Status: Status, DBEngineVersionDescription: DBEngineVersionDescription}}"
{
"DBEngineVersions": [
{
"Engine": "sqlserver-dev-ee",
"EngineVersion": "16.00.4215.2.v1",
"Status": "requires-custom-engine-version",
"DBEngineDescription": "Microsoft SQL Server Enterprise Developer Edition",
"DBEngineVersionDescription": "SQL Server 2022 16.00.4215.2.v1"
}
]
}
```
## AWS CLI
**Como criar a versão do mecanismo personalizado**
+ Use o comando [create-custom-db-engine-version](https://docs.aws.amazon.com/cli/latest/reference/rds/create-custom-db-engine-version.html).
São necessárias as seguintes opções:
+ `--engine`
+ `--engine-version`
+ `--database-installation-files-s3-bucket-name`
+ `--database-installation-files`
+ `--region`
Também é possível especificar as seguintes opções:
+ `--database-installation-files-s3-prefix`
+ `--description`
+ `--tags`
```
aws rds create-custom-db-engine-version \
--engine sqlserver-dev-ee \
--engine-version 16.00.4215.2.cev-dev-ss2022-cu21 \
--region us-west-2 \
--database-installation-files-s3-bucket-name my-s3-installation-media-bucket \
--database-installation-files-s3-prefix sqlserver-dev-media \
--database-installation-files "SQLServer2022-x64-ENU-Dev.iso" "SQLServer2022-KB5065865-x64.exe"
```
A criação da CEV normalmente leva de 15 a 30 minutos. Para monitorar o andamento da criação da CEV, use o seguinte comando:
```
# Check CEV status
aws rds describe-db-engine-versions \
--engine sqlserver-dev-ee \
--engine-version 16.00.4215.2.my-dev-cev \
--region us-west-2
```
## Ciclo de vida de uma CEV do RDS para SQL Server
Ao trabalhar com o SQL Server Developer Edition no RDS para SQL Server, suas versões do mecanismo personalizado passam por vários estados do ciclo de vida.
| Estado do ciclo de vida | Descrição | Quando ocorre | Ações disponíveis |
| --- | --- | --- | --- |
| pending-validation | Estado inicial quando a CEV é criada. | Esse é o estado inicial após a criação com o comando `create-custom-db-engine-version`. | Monitorar o status via `describe-db-engine-version`. |
| validar | Status da validação da CEV | O Amazon RDS está validando a versão personalizada do mecanismo (CEV). Esse processo assíncrono pode levar algum tempo para ser concluído. | Monitore o status até que a validação seja concluída. |
| available | A validação da versão do mecanismo personalizada (CEV) foi concluída com êxito. | A versão personalizada do mecanismo (CEV) já está disponível. O Amazon RDS validou com êxito seus arquivos de atualização cumulativa e ISO do SQL Server. Agora é possível criar instâncias de banco de dados usando essa CEV. | Criar instâncias de banco de dados usando essa CEV. |
| falha | O RDS para SQL Server não pode criar a versão personalizada do mecanismo (CEV) porque a verificação de validação falhou. | Falha na validação de ISO e mídia cumulativa. | Falha na validação do ISO. Confira o motivo da falha em `describe-db-engine-version`, corrija qualquer problema de arquivo, como incompatibilidade de hash ou conteúdo corrompido, e recrie sua versão personalizada do mecanismo (CEV). |
| excluindo | A versão personalizada do mecanismo (CEV) é excluída | Depois que o cliente chama `delete-custom-db-engine-version` até a conclusão do fluxo de trabalho de exclusão. | Monitorar o status via `describe-db-engine-version`. |
| incompatible-installation-media | O Amazon RDS não conseguiu validar a mídia de instalação fornecida para a versão personalizada do mecanismo (CEV). | A validação da versão personalizada do mecanismo (CEV) falhou. Este é um estado terminal. | Consulte failureReason via `describe-db-engine-versions` para acessar informações sobre por que a validação falhou; exclua a CEV. |
### Descrever o status da CEV.
É possível ver o status das suas CEVs usando o AWS CLI:
```
1. aws rds describe-db-engine-versions \
2. --engine sqlserver-dev-ee \
3. --engine-version 16.00.4215.2.my-dev-cev \
4. --region us-west-2 \
5. --query 'DBEngineVersions[0].{Version:EngineVersion,Status:Status}'
```
Exemplo de resultado
```
| DescribeDBEngineVersions |
+------------+---------------------------------+
| Status | Version |
+------------+---------------------------------+
| available | 16.00.4215.2.cev-dev-ss2022-cu21 |
+------------+---------------------------------+
```
Quando uma CEV mostra o status `failed`, você pode determinar o motivo usando o seguinte comando:
```
1. aws rds describe-db-engine-versions \
2. --engine sqlserver-dev-ee \
3. --engine-version 16.00.4215.2.my-dev-cev \
4. --region us-west-2 \
5. --query 'DBEngineVersions[0].{Version:EngineVersion,Status:Status,FailureReason:FailureReason}'
```
# Criar uma instância de banco de dados do RDS para SQL Server Developer Edition
O lançamento da instância do Developer Edition no RDS para SQL Server segue um processo de duas etapas: primeiro crie uma CEV com `create-custom-db-engine-version`. Quando sua versão personalizada do mecanismo estiver disponível, você poderá criar instâncias de banco de dados do Amazon RDS usando a CEV.
**Principais diferenças na criação de instâncias do Developer Edition**
| Parâmetro | Developer Edition |
| --- | --- |
| `--engine` | sqlserver-dev-ee |
| `--engine-version` | Versão personalizada do mecanismo (por exemplo, 16.00.4215.2.cev-dev-ss2022-cu21) |
| `--license-model` | bring-your-own-license |
## AWS CLI
Para criar uma instância de banco de dados do SQL Server Developer Edition, utilize o comando [create-db-instance](https://docs.aws.amazon.com//cli/latest/reference/rds/create-db-instance.html) com os seguintes parâmetros:
São necessárias as seguintes opções:
+ `--db-instance-identifier`
+ `--db-instance-class`
+ `--engine` – `sqlserver-dev-ee`
+ `--region`
**Examples:**
Para Linux, macOS ou Unix:
```
aws rds create-db-instance \
--db-instance-identifier my-dev-sqlserver \
--db-instance-class db.m6i.xlarge \
--engine sqlserver-dev-ee \
--engine-version 16.00.4215.2.my-dev-cev \
--allocated-storage 200 \
--master-username admin \
--master-user-password changeThisPassword \
--license-model bring-your-own-license \
--no-multi-az \
--vpc-security-group-ids sg-xxxxxxxxx \
--db-subnet-group-name my-db-subnet-group \
--backup-retention-period 7 \
--region us-west-2
```
Para Windows:
```
aws rds create-db-instance ^
--db-instance-identifier my-dev-sqlserver ^
--db-instance-class db.m6i.xlarge ^
--engine sqlserver-dev-ee ^
--engine-version 16.00.4215.2.cev-dev-ss2022-cu21 ^
--allocated-storage 200 ^
--master-username admin ^
--master-user-password master_user_password ^
--license-model bring-your-own-license ^
--no-multi-az ^
--vpc-security-group-ids sg-xxxxxxxxx ^
--db-subnet-group-name my-db-subnet-group ^
--backup-retention-period 7 ^
--region us-west-2
```
Consulte [Criar uma instância de banco de dados](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_CreateDBInstance.html#USER_CreateDBInstance.Creating) para criar usando o console da AWS.
# Aplicar atualizações de versões secundárias do banco de dados
O RDS para SQL Server Developer Edition requer a criação de uma versão de mecanismo personalizada (CEV) com a atualização cumulativa mais recente para aplicar a atualização da versão secundária do banco de dados. As atualizações de versões secundárias do banco de dados para o SQL Server Developer Edition envolvem as seguintes etapas:
1. Antes da atualização, verifique a versão atual do mecanismo na instância e identifique a versão do mecanismo de banco de dados de destino a partir das versões aceitas pelo 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).
1. Acesse e faça upload da mídia de instalação (ISO e CU) e, depois, [crie uma versão personalizada do mecanismo](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/sqlserver-dev-edition.creating-cev.html).
1. Aplique a atualização da versão secundária do banco de dados usando o Amazon RDS [https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html) com a nova CEV.
```
aws rds modify-db-instance \
--db-instance-identifier \
--engine-version \
--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.
# Visualizar e gerenciar versões personalizadas do mecanismo
Para visualizar todas as CEVs do RDS para SQL Server Developer Edition, use o comando `describe-db-engine-versions` com a entrada `--engine` como `sqlserver-dev-ee`.
```
aws rds describe-db-engine-versions \
--engine sqlserver-dev-ee \
--include-all \
--region us-west-2
```
Para visualizar os detalhes de uma CEV específica, utilize o seguinte comando:
```
aws rds describe-db-engine-versions \
--engine sqlserver-dev-ee \
--engine-version 16.00.4215.2.cev-dev-ss2022-cu21 \
--region us-west-2
```
**nota**
Esse comando exibe somente CEVs com o status `available`. Para ver as CEVs na validação ou em outros estados, inclua o sinalizador `--include-all`.
## Excluir versões personalizadas do mecanismo
Antes de excluir uma CEV, verifique se ela não está em uso por nenhum dos seguintes procedimentos:
+ Uma instância do banco de dados do Amazon RDS
+ Um snapshot de uma instância de banco de dados do Amazon RDS
+ Um backup automatizado de uma instância de banco de dados do Amazon RDS
**nota**
Você não poderá excluir uma CEV se houver recursos associados a ela.
Para excluir uma versão personalizada do mecanismo, use o comando [delete-custom-db-engine-version](https://docs.aws.amazon.com//cli/latest/reference/rds/delete-custom-db-engine-version.html).
+ `--engine`: especifique `sqlserver-dev-ee` para Developer Edition.
+ `--engine-version`: o identificador exato da versão da CEV a ser excluída.
+ `--region`: Região da AWS em que a CEV existe.
```
aws rds delete-custom-db-engine-version \
--engine sqlserver-dev-ee \
--engine-version 16.00.4215.2.my-dev-cev \
--region us-west-2
```
Para monitorar o processo de exclusão da CEV, use o comando `describe-db-engine-versions` e especifique sua versão do mecanismo da CEV do RDS para SQL Server.
```
aws rds describe-db-engine-versions \
--engine sqlserver-dev-ee \
--engine-version 16.00.4215.2.my-dev-cev \
--region us-west-2
```
Valores do status:
+ `deleting`: exclusão da CEV em andamento.
+ Nenhum resultado exibido: CEV excluída com êxito.
# Solução de problemas do SQL Server Developer Edition para o RDS para SQL Server
A tabela a seguir lista alguns erros comuns e as soluções correspondentes ao trabalhar com o SQL Server Developer Edition para RDS para SQL Server
**Erros e soluções comuns**
| Código de erro | Descrição | Solução |
| --- | --- | --- |
| InvalidParameterValue | Parâmetros da CEV ou referências de arquivo inválidos | Verificar nomes de arquivos, caminhos e sintaxe de parâmetros |
| DBSubnetGroupNotFound | O grupo de sub-redes não existe. | Criar um grupo de sub-redes ou verificar o nome |
| InvalidVPCNetworkState | Problemas de configuração da VPC | Verificar a VPC, as sub-redes e as tabelas de roteamento |
| InvalidEngineVersion | A CEV não está disponível ou é inválida. | Verificar o status e o nome da CEV |
| InvalidDBInstanceClass | Classe de instâncias não aceita | Escolher uma classe de instância aceita |
| CustomDBEngineVersionQuotaExceededFault | Você atingiu o número máximo de versões personalizadas do mecanismo. | Se necessário, aumente a cota de serviço. Como alternativa, exclua as CEVs não utilizadas, se necessário. |
| CreateCustomDBEngineVersionFault | O Amazon RDS não conseguiu acessar o arquivo do instalador especificado no bucket do Amazon S3. | O Amazon RDS não pode acessar os arquivos de instalação do SQL Server no local especificado do Amazon S3. Conceda à entidade principal do serviço do Amazon RDS (rds.amazonaws.com) a permissão s3:GetObject em sua política de bucket do Amazon S3. Verifique se a região do bucket do Amazon S3 é a mesma região em que você está criando a CEV. |