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:
Verifique a elegibilidade: acesse a página Mobilidade de Licenças da AWS
para consultar os requisitos e os critérios de elegibilidade. Envie o formulário de verificação: baixe e preencha o formulário de verificação da Mobilidade de Licenças da Microsoft
. Envie o formulário à Microsoft por meio do seu parceiro de licenciamento ou diretamente. 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
. 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
.
Importante
Baixe apenas o arquivo ISO em inglês baseado em Core. Não use o arquivo ISO baseado em Server+CAL.
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.
Faça login no Console de Gerenciamento da AWS
e abra o console do Amazon RDS. No painel de navegação, escolha Custom engine versions (Versões de mecanismos personalizadas).
No menu suspenso, selecione RDS para SQL Server.
Escolha Create custom engine version (Criar versão de mecanismo personalizada).
Em Tipo de mecanismo, escolha SQL Server.
Em Tipo de gerenciamento de banco de dados, escolha Amazon RDS.
Em Edição, escolha uma das seguintes opções:
SQL Server Enterprise Edition
SQL Server Standard Edition
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).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.
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.
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.
