Utilisation de partitions

Un shard est un ensemble de 1 à 6 nœuds. Vous pouvez créer un cluster avec un plus grand nombre de partitions et un nombre inférieur de répliques, pour un total de 500 nœuds par cluster. Cette configuration de cluster peut aller de 500 partitions et 0 répliques à 100 partitions et 4 répliques, soit le nombre maximum de répliques autorisées. Les données du cluster sont partitionnées entre les partitions du cluster. S'il y a plus d'un nœud dans une partition, la partition met en œuvre la réplication avec un nœud qui est le nœud principal en lecture/écriture et les autres nœuds sont des nœuds de réplica en lecture seule.

Lorsque vous créez un cluster MemoryDB à l'aide de AWS Management Console, vous spécifiez le nombre de partitions dans le cluster et le nombre de nœuds dans les partitions. Pour plus d’informations, consultez Création d'un cluster MemoryDB.

Chaque nœud de partition possède les mêmes spécifications de calcul, de stockage et de mémoire. L'API MemoryDB vous permet de contrôler les attributs à l'échelle du cluster, tels que le nombre de nœuds, les paramètres de sécurité et les fenêtres de maintenance du système.

Pour plus d’informations, consultez Repartage hors ligne et rééquilibrage des partitions pour MemoryDB et Repartage en ligne et rééquilibrage des partitions pour MemoryDB.

Trouver le nom d'un shard

Vous pouvez trouver le nom d'une partition à l'aide de l'API AWS Management Console, de AWS CLI ou de MemoryDB.

À l'aide du AWS Management Console

La procédure suivante utilise le AWS Management Console pour rechercher les noms de partition d'un cluster MemoryDB.

1. Connectez-vous à la console MemoryDB AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/memorydb/.

2. Dans le volet de navigation de gauche, choisissez Clusters.

3. Sous Nom, choisissez le cluster dont vous souhaitez rechercher les noms de partition.

4. Sous l'onglet Partitions et nœuds, consultez la liste des partitions sous Nom. Vous pouvez également développer chacun d'eux pour afficher les détails de leurs nœuds.

À l'aide du AWS CLI

Pour trouver les noms de partitions (partitions) pour les clusters MemoryDB, utilisez l' AWS CLI opération describe-clusters avec le paramètre facultatif suivant.

• --cluster-name—Paramètre facultatif qui, lorsqu'il est utilisé, limite la sortie aux détails du cluster spécifié. Si ce paramètre est omis, les détails d'un maximum de 100 clusters sont renvoyés.

• --show-shard-details: renvoie les détails des fragments, y compris leurs noms.

Cette commande renvoie les informations relatives à my-cluster.

Pour Linux, macOS ou Unix :

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

Pour Windows :

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

Elle renvoie la réponse JSON suivante :

Des sauts de ligne sont ajoutés pour faciliter la lecture.

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

Utilisation de l'API MemoryDB

Pour trouver les identifiants de partition pour les clusters MemoryDB, utilisez l'opération API DescribeClusters avec le paramètre facultatif suivant.

• ClusterName—Paramètre facultatif qui, lorsqu'il est utilisé, limite la sortie aux détails du cluster spécifié. Si ce paramètre est omis, les détails d'un maximum de 100 clusters sont renvoyés.

• ShowShardDetails: renvoie les détails des fragments, y compris leurs noms.

Cette commande renvoie les informations relatives à my-cluster.

Pour 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>