# Criar e gerenciar versões de mecanismo BYOM para o RDS para SQL Server A criação de uma versão de mecanismo BYOM exige uma configuração única (verificação de Mobilidade de Licenças, obtenção da mídia RTM e upload para o S3). Após a configuração, você poderá criar versões de mecanismo usando o console do Amazon RDS ou a AWS CLI. ## Antes de começar ### Etapa 1: concluir a verificação da Mobilidade de Licenças da Microsoft Requer Mobilidade de Licenças por meio do Software Assurance para BYOM. Você deve ter uma cobertura ativa do Software Assurance para suas licenças do SQL Server antes de implantá-las na AWS. Como concluir o processo de verificação: 1. **Verifique a elegibilidade**: acesse a página [Mobilidade de Licenças da AWS](https://aws.amazon.com/windows/resources/licensemobility/) para consultar os requisitos e os critérios de elegibilidade. 1. **Envie o formulário de verificação**: baixe e preencha o [formulário de verificação da Mobilidade de Licenças da Microsoft](https://www.microsoft.com/en-us/licensing/licensing-programs/software-assurance-license-mobility.aspx). Envie o formulário à Microsoft por meio do seu parceiro de licenciamento ou diretamente. 1. **Aguarde a aprovação**: a Microsoft enviará um e-mail de confirmação quando a verificação for aprovada. Você deve enviar o formulário à Microsoft diretamente ou por meio de seu revendedor Microsoft em até dez dias após trazer os produtos para a AWS. **Importante** A AWS não valida nem impõe conformidade com o licenciamento da Microsoft. Você é responsável por manter a conformidade com os contratos de licenciamento da Microsoft. ### Etapa 2: obter a mídia de instalação do SQL Server Baixe o arquivo Release to Manufacturing (RTM) correspondente à versão principal do SQL Server que você deseja usar. O arquivo RTM é a mídia de instalação básica de uma versão principal e edição do SQL Server (por exemplo, SQL Server 2019 Enterprise Edition). Você pode obter o arquivo RTM de uma das seguintes origens da Microsoft: + **Assinatura do Visual Studio** se você tiver uma assinatura ativa do Visual Studio, baixe o arquivo RTM na [página de downloads para assinantes](https://visualstudio.microsoft.com/subscriptions/). + **Centro de administração do Microsoft 365** se você adquiriu produtos por meio de licenciamento por volume, baixe o arquivo RTM na [página Downloads do centro de administração do Microsoft 365](https://admin.microsoft.com). **Importante** Baixe apenas o arquivo ISO em inglês baseado em Core. Não use o arquivo ISO baseado em Server\+CAL. **Importante** Para a mídia de instalação do SQL Server 2019 Release to Manufacturing (RTM) (edições Standard e Enterprise Core), faça o download somente pelo Centro de administração do Microsoft 365. A mídia do SQL Server 2019 baixada das Assinaturas do Visual Studio não é compatível. Para o SQL Server 2022 e versões posteriores, você pode baixar a mídia de instalação RTM pelo Centro de administração do Microsoft 365 ou pelas Assinaturas do Visual Studio. ### Etapa 3: fazer upload da mídia de instalação para o Amazon S3 Faça upload do arquivo RTM do SQL Server para um bucket do Amazon S3 na mesma conta e região da AWS em que você pretende criar a versão de mecanismo BYOM. Para fazer upload do arquivo RTM usando a AWS CLI: ``` aws s3 cp SQLServer2022-x64-ENU-Enterprise.iso s3://my-sqlserver-media/ISOs/ ``` **nota** Se você não fornecer um arquivo de Atualização cumulativa (CU) durante a criação da versão de mecanismo BYOM, o Amazon RDS fará automaticamente o download da CU necessária da Microsoft quando você criar a versão do mecanismo. ## Criar uma versão de mecanismo BYOM Use `describe-db-engine-versions` para verificar quais versões de mecanismo são elegíveis para a criação de uma versão de mecanismo BYOM. Consulte as versões compatíveis em [Traga sua própria mídia (BYOM) para o RDS para SQL Server](sqlserver-byom.md). ### Console 1. Faça login no [Console de Gerenciamento da AWS](https://console.aws.amazon.com/rds/) e abra o console do Amazon RDS. 1. No painel de navegação, escolha **Custom engine versions** (Versões de mecanismos personalizadas). 1. No menu suspenso, selecione **RDS para SQL Server**. 1. Escolha **Create custom engine version** (Criar versão de mecanismo personalizada). 1. Em **Tipo de mecanismo**, escolha **SQL Server**. 1. Em **Tipo de gerenciamento de banco de dados**, escolha **Amazon RDS**. 1. Em **Edição**, escolha uma das seguintes opções: + SQL Server Enterprise Edition + SQL Server Standard Edition 1. Em **Versão do mecanismo**, escolha a versão do SQL Server que corresponde aos seus arquivos de instalação (por exemplo, SQL Server 2022 `16.00.4175.1.v1` ou SQL Server 2025 `17.00.4045.5.v1`). 1. Em **Mídia de instalação**, informe o URI do S3 que contém a mídia RTM do SQL Server ou escolha **Procurar no S3** para localizar e selecionar o arquivo. 1. Escolha **Create custom engine version** (Criar versão de mecanismo personalizada). O console exibe a nova versão de mecanismo BYOM com o status inicial **Validação pendente**. O status progride automaticamente. Para obter mais informações, consulte [Estados do ciclo de vida da versão de mecanismo BYOM](#sqlserver-byom-creating-cev.lifecycle). ### CLI Use o comando `create-custom-db-engine-version` para criar uma versão de mecanismo BYOM a partir da sua mídia de instalação. O Amazon RDS baixa automaticamente a Atualização cumulativa (CU) necessária da Microsoft. ``` aws rds create-custom-db-engine-version \ --engine sqlserver-ee \ --engine-version 16.00.4175.1.v1 \ --database-installation-files-s3-bucket-name my-sqlserver-media \ --database-installation-files-s3-prefix "ISOs/" \ --database-installation-files "SQLServer2022-x64-ENU-Enterprise.iso" ``` **Resposta** ``` { "Engine": "sqlserver-ee", "MajorEngineVersion": "16.00", "EngineVersion": "16.00.4175.1.v1", "DatabaseInstallationFiles": [ "SQLServer2022-x64-ENU-Enterprise.iso" ], "DBEngineDescription": "Microsoft SQL Server Enterprise Edition", "DBEngineVersionArn": "arn:aws:rds:us-east-1:123456789012:cev:sqlserver-ee/16.00.4175.1.v1/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", .... "Status": "pending-validation", ..... } ``` **Parâmetros da CLI** | Parâmetro | Obrigatório | Descrição | | --- | --- | --- | | --engine | Sim | O tipo de mecanismo de banco de dados: sqlserver-ee, sqlserver-se. | | --engine-version | Sim | A versão de mecanismo de destino (por exemplo, 16.00.4175.1.v1). | | --database-installation-files-s3-bucket-name | Sim | O nome do bucket do S3 que contém a mídia de instalação. O bucket deve estar na mesma região da AWS da versão de mecanismo BYOM. | | --database-installation-files-s3-prefix | Não | O prefixo da chave do S3 (caminho da pasta) onde os arquivos da mídia de instalação estão armazenados. | | --database-installation-files | Sim | Os nomes dos arquivos da mídia de instalação. | **nota** Ao usar a AWS CLI, os parâmetros `--database-installation-files-s3-bucket-name`, `--database-installation-files-s3-prefix` e `--database-installation-files` são obrigatórios apenas para a primeira versão de mecanismo BYOM criada para uma versão principal e edição. Para as versões secundárias subsequentes dentro da mesma versão principal, apenas `--engine` e `--engine-version` são obrigatórios. ## Descrever versões do mecanismo BYOM Depois de criar uma versão de mecanismo BYOM, use `describe-db-engine-versions` para verificar seu status e detalhes. A saída retorna dois registros para a mesma versão de mecanismo: um para Licença incluída (LI) (`DBEngineMediaType: None`) e outro para BYOM (`DBEngineMediaType: Customer Provided`). **Exemplo:** ``` aws rds describe-db-engine-versions \ --engine sqlserver-ee \ --engine-version 16.00.4175.1.v1 \ --include-all \ --output table \ --query "DBEngineVersions[].{Engine: Engine, Version: EngineVersion, Status: Status, MediaType: DBEngineMediaType}" ``` **Resposta:** ``` ----------------------------------------------------------------------- | DescribeDBEngineVersions | +--------------+---------------------+------------+-------------------+ | Engine | MediaType | Status | Version | +--------------+---------------------+------------+-------------------+ | sqlserver-ee| None | available | 16.00.4175.1.v1 | | sqlserver-ee| Customer Provided | available | 16.00.4175.1.v1 | +--------------+---------------------+------------+-------------------+ ``` ## Estados do ciclo de vida da versão de mecanismo BYOM | Estado | Descrição | | --- | --- | | pending-validation | O RDS aceitou a solicitação e a colocou na fila para processamento. | | validating | O RDS está validando o arquivo de mídia RTM. | | creating | O RDS está instalando o SQL Server a partir do arquivo de mídia RTM. | | available | A versão de mecanismo BYOM está pronta para a criação de instâncias. | | incompatible\_installation\_media | Os arquivos de instalação são inválidos ou estão corrompidos. Este é um estado terminal. Exclua a versão de mecanismo BYOM e tente novamente usando os arquivos corretos. | ## Modificar uma versão de mecanismo BYOM Você pode modificar uma versão de mecanismo BYOM usando o Console de Gerenciamento da AWS ou a AWS CLI. Você pode modificar a descrição da versão de mecanismo BYOM ou seu status de disponibilidade. Sua versão de mecanismo BYOM possui um dos seguintes valores de status: + **disponível**: você pode usar essa versão de mecanismo BYOM para criar uma instância de banco de dados ou atualizar uma instância de banco de dados. Esse é o status padrão de uma versão de mecanismo BYOM recém-criada. + **inativa**: você não pode criar nem atualizar uma instância de banco de dados usando essa versão de mecanismo BYOM. Também não é possível restaurar um snapshot de banco de dados para criar uma instância de banco de dados usando essa versão de mecanismo BYOM. Você pode alterar o status da versão de mecanismo BYOM de `available` para `inactive` ou de `inactive` para `available`. Você pode alterar o status para `inactive` a fim de evitar o uso acidental de uma versão de mecanismo BYOM ou para tornar novamente elegível para uso uma versão de mecanismo BYOM descontinuada. ``` aws rds modify-custom-db-engine-version \ --engine sqlserver-ee \ --engine-version 16.00.4175.1.v1 \ --status inactive ``` **Resposta** ``` { "Engine": "sqlserver-ee", "MajorEngineVersion": "16.00", "EngineVersion": "16.00.4175.1.v1", .... "Status": "inactive", .... } ``` **nota** As instâncias existentes em execução em uma versão de mecanismo BYOM definida como inactive continuam funcionando normalmente. Somente as operações de criação de instâncias e de restauração são afetadas. ## Excluir uma versão de mecanismo BYOM Use `delete-custom-db-engine-version` para remover permanentemente uma versão de mecanismo BYOM. Após a exclusão, a versão do mecanismo volta a ter apenas uma entrada LI. **Pré-requisitos para exclusão** Antes de excluir uma versão de mecanismo BYOM, verifique se os seguintes requisitos foram atendidos: + Nenhuma instância de banco de dados está usando a versão BYOM. + Nenhum snapshot de banco de dados faz referência à versão BYOM. Se qualquer um desses recursos do RDS existir, a API falhará ao processar a solicitação de exclusão. **Excluir uma versão de mecanismo BYOM (CLI)** ``` aws rds delete-custom-db-engine-version \ --engine sqlserver-ee \ --engine-version 16.00.4175.1.v1 ``` **Resposta** ``` { "Engine": "sqlserver-ee", "MajorEngineVersion": "16.00", "EngineVersion": "16.00.4175.1.v1", ..... "Status": "deleting", .... } ``` ## Considerações + Você fornece o arquivo ISO RTM apenas uma vez para cada versão principal e edição. Todas as versões secundárias da mesma versão principal e edição reutilizarão a mesma mídia de instalação. + Ao fornecer sua mídia RTM do SQL Server para Traga sua própria mídia, você deve usar apenas o arquivo ISO RTM baseado em Core, e não o arquivo ISO RTM baseado em Server \+ CAL. ## Próximas etapas Depois que a versão de mecanismo BYOM atingir o status `available`, você poderá iniciar uma instância do RDS for SQL Server usando essa versão. Consulte [Criar uma instância de banco de dados BYOM para o RDS para SQL Server](sqlserver-byom-creating-instance.md).