# Trabalho com grupos de fragmentos de banco de dados
Realize as seguintes tarefas para adicionar e gerenciar um grupo de fragmentos de banco de dados para o Aurora PostgreSQL Limitless Database.
**Topics**
+ [Conexão ao cluster de banco de dados do Aurora PostgreSQL Limitless Database](#limitless-endpoint)
+ [Localização do número de roteadores e fragmentos em um grupo de fragmentos de banco de dados](#limitless-shard.number)
+ [Descrição de grupos de fragmentos de banco de dados](#limitless-describe)
+ [Reinicialização de um grupo de fragmentos de banco de dados](#limitless-reboot)
+ [Alteração da capacidade de um grupo de fragmentos de banco de dados](limitless-capacity.md)
+ [Dividir um fragmento em um grupo de fragmentos de banco de dados](limitless-shard-split.md)
+ [Adicionar um roteador a um grupo de fragmentos de banco de dados](limitless-add-router.md)
+ [Exclusão de um grupo de fragmentos de banco de dados](limitless-shard-delete.md)
+ [Adição de um grupo de fragmentos de banco de dados a um cluster de banco de dados do Aurora PostgreSQL Limitless Database existente](limitless-shard-add.md)
## Conexão ao cluster de banco de dados do Aurora PostgreSQL Limitless Database
Para trabalhar com o Aurora PostgreSQL Limitless Database, você se conecta ao endpoint e gravador ou leitor do cluster. Você pode usar `psql` ou qualquer outro utilitário de conexão que funcione com o PostgreSQL:
```
$ psql -h {{DB_cluster_endpoint}} -p {{port_number}} -U {{database_username}} -d postgres_limitless
```
O exemplo a seguir usa o endpoint para o cluster de banco de dados que você criou em [CLI](limitless-create-cluster.md#limitless-create-CLI).
```
$ psql -h my-limitless-cluster.cluster-ckifpdyyyxxx.us-east-1.rds.amazonaws.com -p 5432 -U postgres -d postgres_limitless
```
**nota**
O banco de dados padrão para o grupo de fragmentos de banco de dados no Aurora PostgreSQL Limitless Database é `postgres_limitless`.
### Uso do Limitless Connection Plugin
Ao se conectar ao Aurora PostgreSQL Limitless Database, os clientes se conectam usando o endpoint do cluster e são roteados para um roteador de transações pelo Amazon Route 53. No entanto, o Route 53 é limitado na capacidade de balancear a carga e pode permitir workloads desiguais nos roteadores de transações. O [Limitless Connection Plugin](https://github.com/aws/aws-advanced-jdbc-wrapper/blob/main/docs/using-the-jdbc-driver/using-plugins/UsingTheLimitlessConnectionPlugin.md) no [Driver JDBC da AWS](https://github.com/awslabs/aws-advanced-jdbc-wrapper) resolve isso realizando o balanceamento de carga do lado do cliente com reconhecimento de carga. Para obter mais informações sobre o [Driver JDBC da AWS](https://github.com/awslabs/aws-advanced-jdbc-wrapper), consulte [Conectar-se ao Aurora PostgreSQL com o driver JDBC da Amazon Web Services (AWS)](Aurora.Connecting.md#Aurora.Connecting.JDBCDriverPostgreSQL).
## Localização do número de roteadores e fragmentos em um grupo de fragmentos de banco de dados
Você pode usar a consulta a seguir para encontrar o número de roteadores e fragmentos:
```
SELECT * FROM rds_aurora.limitless_subclusters;
subcluster_id | subcluster_type
---------------+-----------------
1 | router
2 | router
3 | shard
4 | shard
5 | shard
6 | shard
```
## Descrição de grupos de fragmentos de banco de dados
Use o comando `describe-db-shard-groups` da AWS CLI para descrever seus grupos de fragmentos de banco de dados. O seguinte parâmetro é opcional:
+ `--db-shard-group-identifier`: o nome de um grupo de fragmentos de banco de dados.
O exemplo a seguir descreve um grupo de fragmentos de banco de dados específico.
```
aws rds describe-db-shard-groups --db-shard-group-identifier {{my-db-shard-group}}
```
A saída será semelhante ao seguinte exemplo.
```
{
"DBShardGroups": [
{
"DBShardGroupResourceId": "shardgroup-8986d309a93c4da1b1455add17abcdef",
"DBShardGroupIdentifier": "my-shard-group",
"DBClusterIdentifier": "my-limitless-cluster",
"MaxACU": 1000.0,
"ComputeRedundancy": 0,
"Status": "available",
"PubliclyAccessible": false,
"Endpoint": "my-limitless-cluster.limitless-ccetp2abcdef.us-east-1.rds.amazonaws.com"
}
]
}
```
## Reinicialização de um grupo de fragmentos de banco de dados
Às vezes, você precisa reinicializar o grupo de fragmentos de banco de dados, por exemplo, quando o parâmetro `max_connections` muda devido a uma alteração na capacidade máxima.
Você pode usar o Console de gerenciamento da AWS ou a AWS CLI para alterar a capacidade de um grupo de fragmentos de banco de dados.
### Console
Use o procedimento a seguir.
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. Navegue até a página **Databases (Bancos de dados)**.
1. Selecione o grupo de fragmentos de banco de dados que você deseja reiniciar.
1. Em **Actions (Ações)**, escolha **Reboot (Reiniciar)**.
1. Escolha **Confirmar**.
### CLI
Para reiniciar um grupo de fragmentos de banco de dados, use o comando AWS CLI da `reboot-db-shard-group` com o parâmetro a seguir:
+ `--db-shard-group-identifier`: o nome de um grupo de fragmentos de banco de dados.
O exemplo a seguir reinicializa um grupo de fragmentos de banco de dados.
```
aws rds reboot-db-shard-group --db-shard-group-identifier {{my-db-shard-group}}
```