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

Cette section contient des exemples d'utilisation de la CQL console et du AWS CLI pour gérer les paramètres de dimensionnement automatique d'Amazon Keyspaces des 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 Amazon Keyspaces API pour configurer le dimensionnement automatique. Cela est dû au fait que les API opérations Application Auto Scaling sous-jacentes ne tiennent pas compte des 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 les Amazon KeyspacesAPI, consultez le manuel Amazon Keyspaces Reference. API

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)

Mettez à 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 AWS CLI update-tablecommande.

  Notez que vous devez utiliser les CLI commandes Amazon Keyspaces pour créer ou modifier les paramètres de mise à l'échelle automatique pour plusieurs régions. 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 plusieurs 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 JSON fichiers.

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

  Dans cet exemple, les JSON fichiers se trouvent dans le répertoire en cours. 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