기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 를 사용하여 파티션 정보 보기 AWS CLI
<a name="describe-topic-partitions-cli"></a>

다음 명령을 실행하여 *ClusterArn*을 클러스터의 Amazon 리소스 이름(ARN)으로 바꾸고 *TopicName*을 주제 이름으로 바꿉니다.

```
aws kafka describe-topic-partitions --cluster-arn ClusterArn --topic-name TopicName
```

이 명령의 출력은 다음 JSON 예제와 같습니다.

```
{
    "partitions": [
        {
            "partition": 0,
            "leader": 1,
            "replicas": [1, 2, 3],
            "isr": [1, 2, 3]
        },
        {
            "partition": 1,
            "leader": 2,
            "replicas": [2, 3, 1],
            "isr": [2, 3, 1]
        },
        {
            "partition": 2,
            "leader": 3,
            "replicas": [3, 1, 2],
            "isr": [3, 1]
        }
    ]
}
```

## 파티션 정보 이해
<a name="describe-topic-partitions-fields"></a>

응답에는 각 파티션에 대한 다음 정보가 포함됩니다.
+ **파티션** - 파티션 번호입니다. 파티션은 0부터 번호가 매겨집니다.
+ **leader** -이 파티션에 대한 리더의 브로커 ID입니다. 리더는 파티션에 대한 모든 읽기 및 쓰기 요청을 처리합니다.
+ **복제본 **-이 파티션의 복제본이 있는 브로커 IDs 목록입니다. 여기에는 동기화 내 복제본과 out-of-sync 복제본이 모두 포함됩니다.
+ **isr** - 동기화된 복제본인 브로커 IDs 목록입니다. 이러한 복제본은 리더와 완전히 연결되며 필요한 경우 리더 역할을 맡을 수 있습니다.

위 예제에서 파티션 2에는 out-of-sync 복제본이 있습니다. `replicas` 목록에는 브로커 2가 포함되지만 `isr` 목록에는 포함되지 않습니다. 이는 브로커 2가이 파티션의 리더와 완전히 연결되지 않았음을 나타냅니다.

## 결과 페이지 매김
<a name="describe-topic-partitions-pagination"></a>

주제에 파티션이 많은 경우 페이지 매김을 사용하여 더 작은 배치로 결과를 검색할 수 있습니다. `--max-results` 파라미터를 사용하여 반환할 최대 파티션 수를 지정하고 `--next-token` 파라미터를 사용하여 결과의 다음 페이지를 검색합니다.

```
aws kafka describe-topic-partitions --cluster-arn ClusterArn --topic-name TopicName --max-results 10
```

사용 가능한 결과가 더 있는 경우 응답에 `nextToken` 값이 포함됩니다. 이 토큰을 사용하여 결과의 다음 페이지를 검색합니다.

```
aws kafka describe-topic-partitions --cluster-arn ClusterArn --topic-name TopicName --max-results 10 --next-token NextToken
```

## 일반 사용 사례
<a name="describe-topic-partitions-use-cases"></a>

파티션 정보 보기는 여러 시나리오에 유용합니다.
+ **과소 복제된 파티션 식별** - `replicas` 및 `isr` 목록을 비교하여 일부 복제본이 동기화되지 않은 파티션을 식별합니다. 이는 성능 문제 또는 브로커 문제를 나타낼 수 있습니다.
+ **파티션 배포 모니터링** - 파티션 리더가 브로커에 고르게 분산되어 있는지 확인하여 로드가 균형 잡힌지 확인합니다.
+ **복제 문제 해결 **- ISR 목록을 검사하여 복제를 따라잡는 데 문제가 있는 브로커를 식별합니다.
+ **파티션 리밸런싱 계획** - 리밸런싱 작업을 수행하기 전에이 정보를 사용하여 현재 파티션 레이아웃을 이해합니다.