

# 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를 사용하려면 클러스터 라이터 또는 리더 엔드포인트에 연결합니다. PostgreSQL에서 작동하는 `psql` 또는 다른 연결 유틸리티를 사용할 수 있습니다.

```
$ 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`입니다.

### 무한 연결 플러그인 사용
<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)용 [무한 연결 플러그인](https://github.com/aws/aws-advanced-jdbc-wrapper/blob/main/docs/using-the-jdbc-driver/using-plugins/UsingTheLimitlessConnectionPlugin.md)은 로드 인식으로 클라이언트 측 로드 밸런싱을 수행하여 이 문제를 해결합니다. [AWS JDBC 드라이버](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 Management Console 또는 AWS CLI를 사용하여 DB 샤드 그룹의 용량을 변경할 수 있습니다.

### 콘솔
<a name="limitless-reboot.CON"></a>

다음 절차를 따르세요.

AWS Management Console에 로그인한 후 [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)에서 Amazon 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}}
```