# Criar um cluster de banco de dados que usa o Aurora Serverless v2
Para criar um cluster do Aurora ao qual você possa adicionar instâncias de banco de dados do Aurora Serverless v2, siga o mesmo procedimento usado em [Criar um cluster de bancos de dados do Amazon Aurora](Aurora.CreateInstance.md). Com o Aurora Serverless v2, seus clusters são intercambiáveis com clusters provisionados. É possível ter clusters em que algumas instâncias de banco de dados usam o Aurora Serverless v2 e algumas são provisionadas.
**Topics**
+ [Configurações de clusters de banco de dados do Aurora Serverless v2](#aurora-serverless-v2.create-settings)
+ [Criar um cluster de banco de dados do Aurora Serverless v2](#aurora-serverless-v2.create-cluster)
+ [Criar uma instância de banco de dados de gravador do Aurora Serverless v2](#aurora-serverless-v2-adding-writer)
## Configurações de clusters de banco de dados do Aurora Serverless v2
As configurações iniciais do cluster devem atender aos requisitos listados em [Requisitos e limitações do Aurora Serverless v2](aurora-serverless-v2.requirements.md). Especifique as seguintes configurações para garantir que você possa adicionar instâncias de banco de dados do Aurora Serverless v2 ao cluster:
**Região da AWS**
Criar um cluster em uma Região da AWS onde instâncias de banco de dados do Aurora Serverless v2 estejam disponíveis. Para obter detalhes sobre as regiões disponíveis, consulte [Regiões e mecanismos de banco de dados do Aurora compatíveis com o Aurora Serverless v2](Concepts.Aurora_Fea_Regions_DB-eng.Feature.ServerlessV2.md).
**DB engine version (Versão do mecanismo de banco de dados)**
Escolha uma versão do mecanismo compatível com o Aurora Serverless v2. Para obter informações sobre os requisitos da versão Aurora Serverless v2, consulte [Requisitos e limitações do Aurora Serverless v2](aurora-serverless-v2.requirements.md).
**Classe de instância de banco de dados**
Se você criar um cluster usando o Console de gerenciamento da AWS, escolha a classe para a instância de banco de dados de gravador simultaneamente. Escolha a classe de instância de banco de dados **Serverless** (Sem servidor). Ao escolher essa classe de instância de banco de dados, especifique também o intervalo de capacidade para a instância de banco de dados do gravador. Esse mesmo intervalo de capacidade se aplica a todas as outras instâncias de banco de dados do Aurora Serverless v2 adicionadas a esse cluster.
Se você não vir a opção **Tecnologia sem servidor** para a classe de instância de banco de dados, verifique se você escolheu uma versão do mecanismo de banco de dados compatível com [Regiões e mecanismos de banco de dados do Aurora compatíveis com o Aurora Serverless v2](Concepts.Aurora_Fea_Regions_DB-eng.Feature.ServerlessV2.md).
Quando você usa a AWS CLI ou a API do Amazon RDS, o parâmetro especificado para a classe de instância de banco de dados é `db.serverless`.
**Intervalo de capacidade**
Preencha os valores mínimo e máximo de unidade de capacidade do Aurora (ACU) que se aplicam a todas as instâncias de banco de dados no cluster. Essa opção está disponível nas páginas **Create cluster** (Criar cluster) e **Add reader** (Adicionar leitor) do console quando você escolhe **Serverless** (Sem servidor) para a classe da instância de banco de dados.
Consulte os intervalos de capacidade permitidos de várias versões do mecanismo de banco de dados em [Aurora Serverless v2Capacidade do](aurora-serverless-v2.how-it-works.md#aurora-serverless-v2.how-it-works.capacity).
Caso não veja as caixas de ACU mínima e máxima, verifique se você escolheu a classe **Tecnologia sem servidor** da instância de banco de dados do gravador.
Se você inicialmente criar o cluster com uma instância de banco de dados provisionada, não especificará as ACUs mínima e máxima. Nesse caso, você pode modificar o cluster posteriormente para adicionar essa configuração. Também é possível adicionar uma instância de banco de dados do leitor do Aurora Serverless v2 ao cluster. É necessário especificar o intervalo de capacidade como parte desse processo.
Você só poderá adicionar instâncias de banco de dados do Aurora Serverless v2 ao cluster usando o AWS CLI ou a API do RDS depois de especificar o intervalo de capacidade para o cluster. Se tentar adicionar uma instância de banco de dados do Aurora Serverless v2, será gerado um erro. No AWS CLI ou nos procedimentos da API do RDS, o intervalo de capacidade é representado pelo atributo `ServerlessV2ScalingConfiguration`.
No caso de clusters que contenham mais de uma instância de banco de dados do leitor, a prioridade de failover de cada instância de banco de dados do leitor do Aurora Serverless v2 desempenha um papel importante na forma como a escala dessa instância é aumentada ou reduzida na vertical. Não é possível especificar a prioridade ao criar inicialmente o cluster. Tenha em mente essa propriedade ao adicionar uma segunda instância de banco de dados do leitor ao cluster ou fazê-lo posteriormente. Para ter mais informações, consulte [Escolher o nível de promoção para um leitor do Aurora Serverless v2](aurora-serverless-v2-administration.md#aurora-serverless-v2-choosing-promotion-tier).
## Criar um cluster de banco de dados do Aurora Serverless v2
É possível usar o Console de gerenciamento da AWS, a AWS CLI ou a API do RDS para criar um cluster de banco de dados do Aurora Serverless v2.
### Console
**Como criar um cluster com um gravador Aurora Serverless v2**
1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon RDS em [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. No painel de navegação, escolha **Bancos de dados**.
1. Selecione **Criar banco de dados**. Na página exibida, escolha as seguintes opções:
+ Em **Tipo de mecanismo**, escolha **Aurora (compatível com MySQL)** ou **Aurora (compatível com PostgreSQL)**.
+ Em **Versão**, escolha uma das versões compatíveis para [Regiões e mecanismos de banco de dados do Aurora compatíveis com o Aurora Serverless v2](Concepts.Aurora_Fea_Regions_DB-eng.Feature.ServerlessV2.md).
1. Em **Classe da instância de banco de dados**, escolha **Serverless v2**.
1. Em **Intervalo de capacidade**, você pode aceitar o intervalo padrão. Ou você pode escolher outros valores para unidades de capacidade mínima e máxima. É possível escolher entre 0 ACU, no mínimo, e 256 ACUs, no máximo, em incrementos de 0,5 ACU.
Para obter mais informações sobre unidades de capacidade do Aurora Serverless v2, consulte [Aurora Serverless v2Capacidade do](aurora-serverless-v2.how-it-works.md#aurora-serverless-v2.how-it-works.capacity) e [Performance e escalabilidade no Aurora Serverless v2](aurora-serverless-v2.setting-capacity.md).
Dependendo do mecanismo e da versão que você escolher, o limite máximo poderá ser 128 ACUs, o limite mínimo poderá ser 0,5 ACUs ou ambos. Para obter detalhes sobre o limite para cada combinação de mecanismo e versão do Aurora, consulte [Aurora Serverless v2Capacidade do](aurora-serverless-v2.how-it-works.md#aurora-serverless-v2.how-it-works.capacity).
![\[Definições de configuração da instância para Aurora Serverless v2.\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/AuroraUserGuide/images/serverless_v2_screencaps/serverless_v2_capacity_setting_incl_nonzero_minimum.png)
Escolher uma capacidade mínima de 0 ACUs habilita o recurso de pausa e retomada automáticas do Aurora Serverless v2. Nesse caso, você pode fazer uma escolha adicional de quanto tempo as instâncias de banco de dados do Aurora Serverless v2 esperam sem conexões de banco de dados antes de pausar automaticamente. Para obter informações sobre o recurso de pausa e retomada automáticas, consulte [Escalar para zero ACUs com pausa e retomada automáticas no Aurora Serverless v2](aurora-serverless-v2-auto-pause.md).
![\[Configuração de capacidade do Aurora Serverless v2 quando o limite inferior é 0 ACUs.\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/AuroraUserGuide/images/serverless_v2_screencaps/serverless_v2_capacity_setting_incl_zero_minimum.png)
1. Escolha qualquer outra configuração de cluster de banco de dados, conforme descrito em [Configurações de clusters de bancos de dados do Aurora](Aurora.CreateInstance.md#Aurora.CreateInstance.Settings).
1. Escolha **Criar banco de dados** para criar o cluster do Aurora com um instância de banco de dados do Aurora Serverless v2 como a instância do gravador, também conhecida como instância do banco de dados primário.
### CLI
Para criar um cluster de banco de dados compatível com instâncias de banco de dados do Aurora Serverless v2 usando o AWS CLI, siga o procedimento da CLI em [Criar um cluster de bancos de dados do Amazon Aurora](Aurora.CreateInstance.md). Inclua estes parâmetros em seu comando `create-db-cluster`:
+ --region *AWS\$1Region\$1where\$1Aurora Serverless v2\$1instances\$1are\$1available*
+ --engine-version *serverless\$1v2\$1compatible\$1engine\$1version*
+ --serverless-v2-scaling-configuration MinCapacity=*minimum\$1capacity*,MaxCapacity=*maximum\$1capacity*
O exemplo a seguir mostra a criação de um cluster de banco de dados do Aurora Serverless v2.
```
aws rds create-db-cluster \
--db-cluster-identifier my-serverless-v2-cluster \
--region eu-central-1 \
--engine aurora-mysql \
--engine-version 8.0.mysql_aurora.3.04.1 \
--serverless-v2-scaling-configuration MinCapacity=1,MaxCapacity=4 \
--master-username myuser \
--manage-master-user-password
```
**nota**
Ao criar um cluster de banco de dados do Aurora Serverless v2 usando a AWS CLI, o modo do mecanismo aparece na saída como `provisioned` em vez de `serverless`. O modo de mecanismo `serverless` refere-se a Aurora Serverless v1.
Esse exemplo especifica a opção `--manage-master-user-password` para gerar a senha administrativa e gerenciá-la no Secrets Manager. Para ter mais informações, consulte [Gerenciamento de senhas com Amazon Aurora e AWS Secrets Manager](rds-secrets-manager.md). Como alternativa, você pode usar a opção `--master-password` para especificar e gerenciar a senha por conta própria.
Para obter informações sobre os requisitos da versão Aurora Serverless v2, consulte [Requisitos e limitações do Aurora Serverless v2](aurora-serverless-v2.requirements.md). Para obter informações sobre os números permitidos para o intervalo de capacidade e o que esses números representam, consulte [Aurora Serverless v2Capacidade do](aurora-serverless-v2.how-it-works.md#aurora-serverless-v2.how-it-works.capacity) e [Performance e escalabilidade no Aurora Serverless v2](aurora-serverless-v2.setting-capacity.md).
Para verificar se um cluster existente tem as configurações de capacidade especificadas, confira a saída do comando `describe-db-clusters` para atributo `ServerlessV2ScalingConfiguration`. Esse atributo é semelhante ao seguinte.
```
"ServerlessV2ScalingConfiguration": {
"MinCapacity": 1.5,
"MaxCapacity": 24.0
}
```
**dica**
Se você não especificar as ACUs mínima e máxima ao criar o cluster, poderá usar o comando `modify-db-cluster` depois para adicionar essa configuração. Até esse ponto, você não poderá adicionar nenhuma instância de banco de dados do Aurora Serverless v2 ao cluster. Se tentar adicionar uma instância de banco de dados do `db.serverless`, será gerado um erro.
### API
Para criar um cluster de banco de dados compatível com instâncias de banco de dados do Aurora Serverless v2 usando a API do RDS, siga o procedimento da CLI em [Criar um cluster de bancos de dados do Amazon Aurora](Aurora.CreateInstance.md). Escolha as configurações a seguir. Verifique se a sua operação `CreateDBCluster` inclui os seguintes parâmetros:
```
EngineVersion serverless_v2_compatible_engine_version
ServerlessV2ScalingConfiguration with MinCapacity=minimum_capacity and MaxCapacity=maximum_capacity
```
Para obter informações sobre os requisitos da versão Aurora Serverless v2, consulte [Requisitos e limitações do Aurora Serverless v2](aurora-serverless-v2.requirements.md). Para obter informações sobre os números permitidos para o intervalo de capacidade e o que esses números representam, consulte [Aurora Serverless v2Capacidade do](aurora-serverless-v2.how-it-works.md#aurora-serverless-v2.how-it-works.capacity) e [Performance e escalabilidade no Aurora Serverless v2](aurora-serverless-v2.setting-capacity.md).
Para conferir se um cluster existente tem as configurações de capacidade especificadas, confira a saída da operação `DescribeDBClusters` para o atributo `ServerlessV2ScalingConfiguration`. Esse atributo é semelhante ao seguinte.
```
"ServerlessV2ScalingConfiguration": {
"MinCapacity": 1.5,
"MaxCapacity": 24.0
}
```
**dica**
Se você não especificar as ACUs mínima e máxima ao criar o cluster, poderá usar a operação `ModifyDBCluster` depois para adicionar essa configuração. Até esse ponto, você não poderá adicionar nenhuma instância de banco de dados do Aurora Serverless v2 ao cluster. Se tentar adicionar uma instância de banco de dados do `db.serverless`, será gerado um erro.
## Criar uma instância de banco de dados de gravador do Aurora Serverless v2
Embora você especifique o intervalo de capacidade do Aurora Serverless v2 ao criar um cluster do Aurora, é possível escolher se deseja usar o Aurora Serverless v2 ou provisionado para cada instância de banco de dados no cluster. Para começar a usar o Aurora Serverless v2 imediatamente em seu cluster de banco de dados, adicione uma instância de banco de dados do gravador que use a classe de instância `db.serverless`. No console, você normalmente faz essa escolha como parte do fluxo de trabalho para criar o cluster de banco de dados. Portanto, esse procedimento se aplica principalmente quando você faz a configuração por meio da CLI.
### Console
Ao criar um cluster de banco de dados usando o Console de gerenciamento da AWS, você deve especificar as propriedades da instância de banco de dados do gravador simultaneamente. Para que a instância de banco de dados do gravador use o Aurora Serverless v2, escolha a classe de instância de banco de dados **Serverless**(Sem servidor).
Depois, defina o intervalo de capacidade para o cluster especificando os valores mínimo e máximo de unidade de capacidade do Aurora (ACU). Os mesmos valores mínimo e máximo se aplicam a todas as instâncias de banco de dados do Aurora Serverless v2 no cluster. Para obter esse procedimento e a importância das configurações de capacidade mínima e máxima, consulte [Criar um cluster de banco de dados do Aurora Serverless v2](#aurora-serverless-v2.create-cluster).
Se você não criar uma instância de banco de dados do Aurora Serverless v2 ao criar o cluster, poderá adicionar uma ou mais instâncias de banco de dados do Aurora Serverless v2 posteriormente Para isso, siga os procedimentos em [Adicionar um leitor do Aurora Serverless v2](aurora-serverless-v2-administration.md#aurora-serverless-v2-adding-reader) e [Converter um gravador ou leitor provisionado em Aurora Serverless v2](aurora-serverless-v2-administration.md#aurora-serverless-v2-converting-from-provisioned). Especifique o intervalo de capacidade ao adicionar a primeira instância de banco de dados do Aurora Serverless v2 ao cluster. Você pode alterar o intervalo de capacidade mais tarde seguindo o procedimento em [Configurar o intervalo de capacidade de Aurora Serverless v2 para um cluster](aurora-serverless-v2-administration.md#aurora-serverless-v2-setting-acus).
### CLI
Ao criar um cluster de banco de dados do Aurora Serverless v2 usando a AWS CLI, adicione explicitamente a instância de banco de dados do gravador usando o comando [create-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html). Inclua o seguinte parâmetro:
+ `--db-instance-class db.serverless`
O exemplo a seguir mostra a criação de uma instância de banco de dados de gravador do Aurora Serverless v2.
```
aws rds create-db-instance \
--db-cluster-identifier my-serverless-v2-cluster \
--db-instance-identifier my-serverless-v2-instance \
--db-instance-class db.serverless \
--engine aurora-mysql
```