Mettre à jour les paramètres de capacité allouée et de dimensionnement automatique pour une table multirégionale dans Amazon Keyspaces

Cette section inclut des exemples d'utilisation de la console, du CQL, et de gestion des paramètres AWS CLI de dimensionnement automatique d'Amazon Keyspaces pour les tables multirégionales provisionnées. Pour plus d'informations sur les options générales de configuration de l'autoscaling et sur leur fonctionnement, consultezGérez automatiquement la capacité de débit grâce au dimensionnement automatique d'Amazon Keyspaces.

Notez que si vous utilisez le mode capacité provisionnée pour les tables multirégionales, vous devez toujours utiliser les appels d'API Amazon Keyspaces pour configurer le dimensionnement automatique. Cela est dû au fait que les opérations sous-jacentes de l'API Application Auto Scaling ne sont pas adaptées aux régions.

Pour plus d'informations sur la manière d'estimer le débit de capacité d'écriture des tables multirégionales provisionnées, consultez. Estimer et provisionner la capacité d'une table multirégionale dans Amazon Keyspaces

Pour plus d'informations sur l'API Amazon Keyspaces, consultez le manuel Amazon Keyspaces API Reference.

Lorsque vous mettez à jour le mode provisionné ou les paramètres de dimensionnement automatique d'une table multirégionale, vous pouvez mettre à jour les paramètres de capacité de lecture et la configuration de dimensionnement automatique de lecture pour chaque réplique de la table.

La capacité d'écriture reste toutefois synchronisée entre toutes les répliques afin de garantir une capacité suffisante pour répliquer les écritures dans toutes les régions.

Cassandra Query Language (CQL)

Mettre à jour les paramètres de capacité provisionnée et de dimensionnement automatique d'une table multirégionale à l'aide de CQL

• Vous pouvez l'utiliser ALTER TABLE pour mettre à jour le mode de capacité et les paramètres de mise à l'échelle automatique d'une table existante. Si vous mettez à jour une table actuellement en mode capacité à la demande, capacity_mode c'est obligatoire. Si votre table est déjà en mode capacité provisionnée, ce champ peut être omis.

  Pour des informations détaillées sur les paramètres de mise à l'échelle automatique, la politique de suivi des cibles, la valeur cible et les paramètres facultatifs, consultezCréation d'un nouveau tableau avec mise à l'échelle automatique.

  Dans la même déclaration, vous pouvez également mettre à jour les paramètres de capacité de lecture et de mise à l'échelle automatique des répliques de tables dans des régions spécifiques en mettant à jour les replica_updates propriétés de la table. La déclaration suivante en est un exemple.

  ALTER TABLE mykeyspace.mytable
  WITH CUSTOM_PROPERTIES = {  
      'capacity_mode': {  
          'throughput_mode': 'PROVISIONED',  
          'read_capacity_units': 1,  
          'write_capacity_units': 1  
      }
  } AND AUTOSCALING_SETTINGS = {
      'provisioned_write_capacity_autoscaling_update': {
          'maximum_units': 10,  
          'minimum_units': 5,  
          'scaling_policy': {
              'target_tracking_scaling_policy_configuration': {
                  'target_value': 50
              }  
          }  
      },
      'provisioned_read_capacity_autoscaling_update': {  
          'maximum_units': 10,  
          'minimum_units': 5,  
          'scaling_policy': {  
              'target_tracking_scaling_policy_configuration': {  
                  'target_value': 50,
                  'scale_in_cooldown': 60,  
                  'scale_out_cooldown': 60
              }  
          }  
      },
      'replica_updates': {
          'us-east-1': {
              'provisioned_read_capacity_autoscaling_update': {
                  'maximum_units': 20,
                  'minimum_units': 5,
                  'scaling_policy': {
                      'target_tracking_scaling_policy_configuration': {
                          'target_value': 70
                      } 
                  }
              }
          }
      }
  };

CLI

Mettez à jour les paramètres de capacité provisionnée et de dimensionnement automatique d'une table multirégionale à l'aide du AWS CLI

• Pour mettre à jour le mode provisionné et la configuration de dimensionnement automatique d'une table existante, vous pouvez utiliser la AWS CLI update-table commande.

  Notez que vous devez utiliser les commandes de la CLI Amazon Keyspaces pour créer ou modifier les paramètres de mise à l'échelle automatique multirégionale. Cela est dû au fait qu'Application Auto Scaling, le service qu'Amazon Keyspaces utilise pour effectuer le dimensionnement automatique de la capacité des tables en votre nom, ne prend pas en charge les tables multiples. Régions AWS

  Pour mettre à jour la capacité de lecture d'une réplique de table dans une région spécifique, vous pouvez modifier l'un des paramètres facultatifs suivants de la table replicaSpecifications :

  • Les unités de capacité de lecture provisionnées (facultatif)

  • Paramètres de mise à l'échelle automatique pour la capacité de lecture (facultatif)

  Lorsque vous mettez à jour des tables multirégionales avec des paramètres de mise à l'échelle automatique complexes et différentes configurations pour les répliques de tables, il est utile de charger les paramètres de mise à l'échelle automatique et les configurations de réplique de la table à partir de fichiers JSON.

  Pour utiliser l'exemple de code suivant, vous pouvez télécharger les exemples de fichiers JSON depuis auto-scaling.zip, puis extraire auto-scaling.json etreplication.json. Prenez note du chemin d'accès aux fichiers.

  Dans cet exemple, les fichiers JSON se trouvent dans le répertoire actuel. Pour connaître les différentes options de chemin de fichier, consultez Comment charger des paramètres à partir d'un fichier.

  aws keyspaces update-table --keyspace-name mykeyspace --table-name mytable \
  --capacity-specification throughputMode=PROVISIONED,readCapacityUnits=1,writeCapacityUnits=1 \
  --auto-scaling-specification file://auto-scaling.json \
  --replica-specifications file://replication.json