翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# を使用してパーティション情報を表示する 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>

レスポンスには、パーティションごとに次の情報が含まれます。
+ **partition** — パーティション番号。パーティションには 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 リストを調べて、レプリケーションに追いついていないブローカーを特定します。
+ **パーティションの再調整の計画** — この情報を使用して、再調整オペレーションを実行する前に現在のパーティションレイアウトを理解します。