As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Visualize as informações da partição usando o AWS CLI
<a name="describe-topic-partitions-cli"></a>

Execute o comando a seguir, *ClusterArn* substituindo-o pelo Amazon Resource Name (ARN) do seu cluster e *TopicName* pelo nome do tópico.

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

A saída desse comando é semelhante ao seguinte JSON de exemplo.

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

## Compreendendo as informações de partição
<a name="describe-topic-partitions-fields"></a>

A resposta inclui as seguintes informações para cada partição:
+ **partição** — O número da partição. As partições são numeradas a partir de 0.
+ **líder** — O ID do corretor do líder dessa partição. O líder lida com todas as solicitações de leitura e gravação da partição.
+ **réplicas** — A lista de corretores IDs que têm réplicas dessa partição. Isso inclui tanto a sincronização quanto as out-of-sync réplicas.
+ **isr** — A lista de corretores IDs que são réplicas sincronizadas. Essas réplicas são totalmente identificadas pelo líder e podem assumir o cargo de líder, se necessário.

No exemplo acima, a partição 2 tem uma out-of-sync réplica. A `replicas` lista inclui o corretor 2, mas a `isr` lista não. Isso indica que o broker 2 não está totalmente familiarizado com o líder dessa partição.

## Como paginar resultados
<a name="describe-topic-partitions-pagination"></a>

Se o seu tópico tiver muitas partições, você poderá usar a paginação para recuperar os resultados em lotes menores. Use o `--max-results` parâmetro para especificar o número máximo de partições a serem retornadas e use o `--next-token` parâmetro para recuperar a próxima página de resultados.

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

Se houver mais resultados disponíveis, a resposta incluirá um `nextToken` valor. Use esse token para recuperar a próxima página de resultados.

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

## Casos de uso comuns
<a name="describe-topic-partitions-use-cases"></a>

A visualização das informações da partição é útil para vários cenários:
+ **Identificação de partições sub-replicadas** — Compare as `isr` listas `replicas` e para identificar partições em que algumas réplicas não estão sincronizadas. Isso pode indicar problemas de desempenho ou problemas do corretor.
+ **Monitoramento da distribuição de partições** — Verifique se os líderes de partição estão distribuídos uniformemente entre os corretores para garantir uma carga balanceada.
+ **Solução de problemas de replicação** — identifique quais corretores estão tendo problemas para acompanhar a replicação examinando a lista de ISR.
+ **Planejando o rebalanceamento de partições** — Use essas informações para entender o layout atual da partição antes de realizar operações de rebalanceamento.