

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á.

# Operação com fragmentos
<a name="shards"></a>

Um fragmento é uma coleção de um a 6 nós. É possível criar um cluster com alto número de fragmentos e baixo número de réplicas totalizando até 500 nós por cluster. Essa configuração do cluster pode variar de 500 fragmentos e 0 réplicas para 100 fragmentos e 4 réplicas, que é o número máximo de réplicas permitidas. Os dados do cluster são particionados entre todos os fragmentos do cluster. Se houver mais de um nó em um fragmento, este implementará a replicação com um nó sendo o nó primário de leitura/gravação e os outros nós como nós de réplica somente leitura.

Ao criar um cluster do MemoryDB usando o Console de gerenciamento da AWS, você especifica o número de fragmentos no cluster e o número de nós nos fragmentos. Para obter mais informações, consulte [Criação de um cluster do MemoryDB](getting-started.md#clusters.create).

Cada nó em um fragmento tem as mesmas especificações de computação, armazenamento e memória. A API do MemoryDB permite que você controle os atributos de todo o cluster, como o número de nós, as configurações de segurança e as janelas de manutenção do sistema.

Para obter mais informações, consulte [Refragmentação off-line para o MemoryDB](cluster-resharding-offline.md) e [Refragmentação on-line para o MemoryDB](cluster-resharding-online.md).

## Localização do nome de um fragmento
<a name="shard-find-id"></a>

Você pode encontrar o nome de um fragmento usando o Console de gerenciamento da AWS, a AWS CLI ou a API do MemoryDB.

### Utilização do Console de gerenciamento da AWS
<a name="shard-find-id-con"></a>

O procedimento a seguir usa o Console de gerenciamento da AWS para encontrar os nomes dos fragmentos de um cluster do MemoryDB.

****

1. Faça login no Console de gerenciamento da AWS e abra o console do MemoryDB em [https://console.aws.amazon.com/memorydb/](https://console.aws.amazon.com/memorydb/).

1. No painel de navegação à esquerda, escolha **Clusters**.

1. Escolha o cluster em **Nome** cujos nomes de fragmentos você deseja encontrar.

1. Na guia **Fragmentos e nós**, visualize a lista de fragmentos em **Nome**. Você também pode expandir cada um para ver detalhes de seus nós.

### Como usar o AWS CLI
<a name="shard-find-id-cli"></a>

Para encontrar nomes de fragmentos (fragmentos) para clusters do MemoryDB, use a operação `describe-clusters` da AWS CLI com o seguinte parâmetro opcional.
+ **`--cluster-name`**: um parâmetro opcional que, quando usado, limita a saída aos detalhes do cluster especificado. Se esse parâmetro for omitido, serão retornados os detalhes de até 100 clusters.
+ **`--show-shard-details`**: retorna detalhes dos fragmentos, incluindo seus nomes.

Esse comando retorna os detalhes do `my-cluster`.

Para Linux, macOS ou Unix:

```
aws memorydb describe-clusters \
    --cluster-name my-cluster
    --show-shard-details
```

Para Windows:

```
aws memorydb describe-clusters ^
    --cluster-name my-cluster
    --show-shard-details
```

Retorna a seguinte resposta em JSON:

As quebras de linha foram adicionadas para legibilidade.

```
{
    "Clusters": [
        {
            "Name": "my-cluster",
            "Status": "available",
            "NumberOfShards": 1,
            "Shards": [
                {
                    "Name": "0001",
                    "Status": "available",
                    "Slots": "0-16383",
                    "Nodes": [
                        {
                            "Name": "my-cluster-0001-001",
                            "Status": "available",
                            "AvailabilityZone": "us-east-1a",
                            "CreateTime": "2021-08-21T20:22:12.405000-07:00",
                            "Endpoint": {
                                "Address": "clustercfg.my-cluster.xxxxx.memorydb.us-east-1.amazonaws.com",
                                "Port": 6379
                            }
                        },
                        {
                            "Name": "my-cluster-0001-002",
                            "Status": "available",
                            "AvailabilityZone": "us-east-1b",
                            "CreateTime": "2021-08-21T20:22:12.405000-07:00",
                            "Endpoint": {
                                "Address": "clustercfg.my-cluster.xxxxx.memorydb.us-east-1.amazonaws.com",
                                "Port": 6379
                            }
                        }
                    ],
                    "NumberOfNodes": 2
                }
            ],
            "ClusterEndpoint": {
                "Address": "clustercfg.my-cluster.xxxxx.memorydb.us-east-1.amazonaws.com",
                "Port": 6379
            },
            "NodeType": "db.r6g.large",
            "EngineVersion": "6.2",
            "EnginePatchVersion": "6.2.6",
            "ParameterGroupName": "default.memorydb-redis6",
            "ParameterGroupStatus": "in-sync",
            "SubnetGroupName": "my-sg",
            "TLSEnabled": true,
            "ARN": "arn:aws:memorydb:us-east-1:xxxxxexamplearn:cluster/my-cluster",
            "SnapshotRetentionLimit": 0,
            "MaintenanceWindow": "wed:03:00-wed:04:00",
            "SnapshotWindow": "04:30-05:30",
            "ACLName": "my-acl",
            "DataTiering": "false",
            "AutoMinorVersionUpgrade": true
        }
    ]
}
```

### Usando a API do MemoryDB
<a name="shard-find-id-api"></a>

Para localizar IDs de fragmentos para clusters do MemoryDB, use a operação `DescribeClusters` da API com o seguinte parâmetro opcional.
+ **`ClusterName`**: um parâmetro opcional que, quando usado, limita a saída aos detalhes do cluster especificado. Se esse parâmetro for omitido, serão retornados os detalhes de até 100 clusters.
+ **`ShowShardDetails`**: retorna detalhes dos fragmentos, incluindo seus nomes.

**Example**  
Esse comando retorna os detalhes do `my-cluster`.  
Para Linux, macOS ou Unix:  

```
https://memory-db.us-east-1.amazonaws.com/
   ?Action=DescribeClusters
   &ClusterName=sample-cluster
   &ShowShardDetails=true
   &Version=2021-01-01
   &SignatureVersion=4
   &SignatureMethod=HmacSHA256
   &Timestamp=20210802T192317Z
   &X-Amz-Credential=<credential>
```