

# Conferir os números de versão do Aurora MySQL
<a name="AuroraMySQL.Updates.Versions"></a>

 Embora o Aurora Edição compatível com MySQL seja compatível com os mecanismos de banco de dados MySQL, o Aurora MySQL inclui recursos e correções de bugs que são específicos para versões específicas do Aurora MySQL. Os desenvolvedores de aplicações podem verificar a versão do Aurora MySQL em suas aplicações usando SQL. Os administradores de banco de dados podem verificar e especificar versões do Aurora MySQL ao criar ou atualizar instâncias de banco de dados e clusters de bancos de dados Aurora MySQL 

**Topics**
+ [Verificação ou especificação de versões de mecanismo do Aurora MySQL por meio da AWS](#AuroraMySQL.Updates.EngineVersions)
+ [Verificar versões do Aurora MySQL usando SQL](#AuroraMySQL.Updates.DBVersions)

## Verificação ou especificação de versões de mecanismo do Aurora MySQL por meio da AWS
<a name="AuroraMySQL.Updates.EngineVersions"></a>

 Ao executar tarefas administrativas usando o Console de gerenciamento da AWS, a AWS CLI, ou a API RDS, especifique a versão do Aurora MySQL em um formato alfanumérico descritivo. 

 Desde o Aurora MySQL versão 2, as versões do mecanismo Aurora têm a seguinte sintaxe. 

```
mysql-major-version.mysql_aurora.aurora-mysql-version
```

 A porção `mysql-major-version-` é `5.7` ou `8.0`. Esse valor representa a versão do protocolo cliente e nível geral de suporte a recursos MySQL para a versão correspondente do Aurora MySQL. 

 A `aurora-mysql-version` é um valor pontilhado com três partes: a versão principal do Aurora MySQL, a versão secundária do Aurora MySQL e o nível de patch. A versão principal é `2` ou `3`. Esses valores representam o Aurora MySQL compatível com MySQL 5.7 ou 8.0, respectivamente. A versão secundária representa o lançamento de recursos na série 2.x ou 3.x. O nível de patch começa em `0` para cada versão secundária e representa o conjunto de correções de bugs subsequentes que se aplicam à versão secundária. Ocasionalmente, um novo recurso é incorporado em uma versão secundária, mas não fica visível imediatamente. Nesses casos, o recurso passa por ajustes e é publicado em um nível de patch posterior. 

Todas as versões 2.x do mecanismo do Aurora MySQL são compatíveis com o Community MySQL 5.7.12 ou posterior. Todas as versões 3.x do mecanismo Aurora MySQL são compatíveis com o MySQL 8.0.23 ou posterior. Consulte as notas da versão 3.x específica para encontrar a versão correspondente compatível com o MySQL.

Por exemplo, as versões de mecanismo do Aurora MySQL 3.04.0 e 2.11.2 são as seguintes.

```
8.0.mysql_aurora.3.04.0
5.7.mysql_aurora.2.11.2
```

**nota**  
Não existe uma correspondência individual entre as versões do MySQL da comunidade e as versões 2.x do Aurora MySQL. Para o Aurora MySQL versão 3, o mapeamento é mais direto. Para verificar quais correções de erro e novos recursos estão em uma versão específica do Aurora MySQL, consulte [Atualizações no mecanismo de banco de dados do Amazon Aurora MySQL versão 3](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraMySQLReleaseNotes/AuroraMySQL.Updates.30Updates.html) e [Atualizações no mecanismo de banco de dados do Amazon Aurora MySQL versão 2](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraMySQLReleaseNotes/AuroraMySQL.Updates.20Updates.html) nas *Notas de lançamento do Aurora MySQL*. Para obter uma lista cronológica de novos recursos e lançamentos, consulte [Histórico do documento](WhatsNew.md). Para verificar a versão mínima necessária para uma correção relacionada à segurança, consulte [Vulnerabilidades de segurança corrigidas no Aurora MySQL](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraMySQLReleaseNotes/AuroraMySQL.CVE_list.html) em *Notas de lançamento do Aurora MySQL*.

Especifique a versão do mecanismo Aurora MySQL em alguns comandos da AWS CLI e operações da API do RDS. Por exemplo, especifique a opção `--engine-version` ao executar os comandos da AWS CLI [create-db-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-cluster.html) e [modify-db-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-cluster.html). Especifique o parâmetro `EngineVersion` ao executar as operações da API do RDS [CreateDBCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBCluster.html) e [ModifyDBCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBCluster.html).

No Aurora MySQL versão 2 e posteriores, a versão do mecanismo no Console de gerenciamento da AWS também inclui a versão do Aurora. Atualizar o cluster altera o valor exibido. Essa alteração ajuda a especificar e verificar as versões exatas do Aurora MySQL, sem a necessidade de se conectar ao cluster ou executar os comandos SQL.

**dica**  
Para clusters do Aurora gerenciados pelo CloudFormation, essa alteração na configuração `EngineVersion` pode acionar ações por meio do CloudFormation. Para obter informações sobre como o CloudFormation trata alterações feitas na configuração `EngineVersion`, consulte a [documentação do CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-rds-dbcluster.html).

## Verificar versões do Aurora MySQL usando SQL
<a name="AuroraMySQL.Updates.DBVersions"></a>

 Os números de versão Aurora que você pode recuperar em sua aplicação usando consultas SQL usam o formato `<major version>.<minor version>.<patch version>`. É possível obter esse número de versão para qualquer instância de banco de dados em seu cluster do Aurora MySQL consultando a variável do sistema `AURORA_VERSION`. Para obter esse número de versão, use uma das seguintes consultas. 

```
select aurora_version();
select @@aurora_version;
```

 Essas consultas produzem uma saída semelhante à seguinte. 

```
mysql> select aurora_version(), @@aurora_version;
+------------------+------------------+
| aurora_version() | @@aurora_version |
+------------------+------------------+
| 3.05.2           | 3.05.2           |
+------------------+------------------+
```

 Os números de versão que o console, CLI e API do RDS retorna usando as técnicas descritas em [Verificação ou especificação de versões de mecanismo do Aurora MySQL por meio da AWS](#AuroraMySQL.Updates.EngineVersions) geralmente são mais descritivos.