

# DB シャードグループの操作
<a name="limitless-shard"></a>

Aurora PostgreSQL Limitless Database の DB シャードグループを追加および管理するには、次のタスクを実行します。

**Topics**
+ [Aurora PostgreSQL Limitless Database DB クラスターへの接続](#limitless-endpoint)
+ [DB シャードグループ内のルーターとシャードの数を確認する](#limitless-shard.number)
+ [DB シャードグループの記述](#limitless-describe)
+ [DB シャードグループの再起動](#limitless-reboot)
+ [DB シャードグループの容量の変更](limitless-capacity.md)
+ [DB シャードグループ内のシャードの分割](limitless-shard-split.md)
+ [DB シャードグループにルーターを追加する](limitless-add-router.md)
+ [DB シャードグループの削除](limitless-shard-delete.md)
+ [既存の Aurora PostgreSQL Limitless Database DB クラスターに DB シャードグループを追加する](limitless-shard-add.md)

## Aurora PostgreSQL Limitless Database DB クラスターへの接続
<a name="limitless-endpoint"></a>

Aurora PostgreSQL Limitless Database を操作するには、クラスターライターまたはリーダーエンドポイントに接続します。`psql` または PostgreSQL で動作するその他の接続ユーティリティを使用できます。

```
$ psql -h {{DB_cluster_endpoint}} -p {{port_number}} -U {{database_username}} -d postgres_limitless
```

次の例では、[CLI](limitless-create-cluster.md#limitless-create-CLI) で作成した DB クラスターの エンドポイントを使用します。

```
$ psql -h my-limitless-cluster.cluster-ckifpdyyyxxx.us-east-1.rds.amazonaws.com -p 5432 -U postgres -d postgres_limitless
```

**注記**  
Aurora PostgreSQL Limitless Database の DB シャードグループのデフォルトのデータベースは `postgres_limitless` です。

### Limitless 接続プラグインの使用
<a name="limitless-connection-plugin"></a>

Aurora PostgreSQL Limitless Database に接続する際、クライアントはクラスターエンドポイントを使用して接続し、Amazon Route 53 によってトランザクションルーターにルーティングされます。ただし、Route 53 の負荷分散機能には制限があり、トランザクションルーターのワークロードが不均等になる可能性があります。[AWS JDBC ドライバー](https://github.com/awslabs/aws-advanced-jdbc-wrapper)用の [Limitless 接続プラグイン](https://github.com/aws/aws-advanced-jdbc-wrapper/blob/main/docs/using-the-jdbc-driver/using-plugins/UsingTheLimitlessConnectionPlugin.md)は、負荷を考慮してクライアント側の負荷分散を実行することで、この問題に対処します。[AWSJDBC ドライバー](https://github.com/awslabs/aws-advanced-jdbc-wrapper)の詳細については、「[Amazon Web Services (AWS) JDBC ドライバーを使用した Aurora PostgreSQL への接続](Aurora.Connecting.md#Aurora.Connecting.JDBCDriverPostgreSQL)」を参照してください。

## DB シャードグループ内のルーターとシャードの数を確認する
<a name="limitless-shard.number"></a>

次のクエリを使用して、ルーターとシャードの数を確認できます。

```
SELECT * FROM rds_aurora.limitless_subclusters;

 subcluster_id | subcluster_type
---------------+-----------------
 1             | router
 2             | router
 3             | shard
 4             | shard
 5             | shard
 6             | shard
```

## DB シャードグループの記述
<a name="limitless-describe"></a>

`describe-db-shard-groups` の AWS CLI コマンドを使用して DB シャードグループを記述します。次のパラメータはオプションです。
+ `--db-shard-group-identifier` – DB シャードグループの名前。

次の例では、特定の DB シャードグループを記述します。

```
aws rds describe-db-shard-groups --db-shard-group-identifier {{my-db-shard-group}}
```

出力は以下の例のようになります。

```
{
    "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"
        }
    ]
}
```

## DB シャードグループの再起動
<a name="limitless-reboot"></a>

最大容量の変更により `max_connections` パラメータが変更された場合など、DB シャードグループを再起動する必要があることがあります。

AWS マネジメントコンソール または AWS CLI を使用して、DB シャードグループの容量を変更できます。

### コンソール
<a name="limitless-reboot.CON"></a>

次の手順に従ってください。

AWS マネジメントコンソール にサインインし、Amazon RDS コンソール ([https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)) を開きます。

1. [**データベース**] ページに移動します。

1. 再起動する DB シャードグループを選択します。

1. [**アクション**] で、[**再起動**] を選択します。

1. **[確認]** を選択してください。

### CLI
<a name="limitless-reboot.CLI"></a>

DB パラメータグループを再起動するには、`reboot-db-shard-group` の AWS CLI コマンドを使用して、次のパラメータを指定します。
+ `--db-shard-group-identifier` – DB シャードグループの名前。

次の の例では、DB シャードグループを再起動します。

```
aws rds reboot-db-shard-group --db-shard-group-identifier {{my-db-shard-group}}
```