Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # Gérez automatiquement la capacité de débit grâce au dimensionnement automatique d'Amazon Keyspaces De nombreuses charges de travail de base de données sont cycliques par nature et difficiles à prévoir. Prenons l'exemple d'une application de réseau social où la plupart des utilisateurs sont actifs pendant la journée. La base de données doit être capable de gérer l’activité durant cette période, mais elle n’a pas besoin des mêmes niveaux de débit pendant la nuit. Un autre exemple : supposons que vous ayez une nouvelles application de jeux pour appareils mobiles qui est rapidement adoptée par les utilisateurs. Si le jeu devient trop populaire, les ressources de base de données disponibles risquent d'être dépassées, entraînant un ralentissement des performances et le mécontentement des clients. Ce type de charges de travail nécessite souvent une intervention manuelle pour augmenter ou diminuer les ressources de base de données en fonction de la variation des niveaux d’utilisation. Amazon Keyspaces (pour Apache Cassandra) vous aide à fournir une capacité de débit efficace pour des charges de travail variables en ajustant automatiquement la capacité de débit en réponse au trafic réel des applications. Amazon Keyspaces utilise le service Application Auto Scaling pour augmenter et diminuer la capacité de lecture et d'écriture d'une table en votre nom. Pour plus d'informations sur Application Auto Scaling, consultez le [Guide de l'utilisateur d'Application Auto Scaling](https://docs.aws.amazon.com/autoscaling/application/userguide/). **Note** Pour démarrer rapidement avec le dimensionnement automatique d'Amazon Keyspaces, consultez. [Configurer et mettre à jour les politiques de dimensionnement automatique d'Amazon Keyspaces](autoscaling.configure.md) ## Comment fonctionne le dimensionnement automatique d'Amazon Keyspaces Le schéma suivant fournit une vue d'ensemble détaillée de la façon dont le dimensionnement automatique d'Amazon Keyspaces gère la capacité de débit d'une table. ![\[Schéma illustrant les différents services concernés lorsqu'un utilisateur modifie une table Amazon Keyspaces. Les services sont Amazon CloudWatch, Amazon SNS et Application Auto Scaling, qui émet l'instruction ALTER TABLE pour modifier la capacité en fonction de l'utilisation en lecture ou en écriture des utilisateurs.\]](http://docs.aws.amazon.com/fr_fr/keyspaces/latest/devguide/images/keyspaces_auto-scaling.png) Pour activer la mise à l'échelle automatique d'une table , vous devez créer une *stratégie de mise à l'échelle*. La stratégie de mise à l’échelle permet de spécifier si vous souhaitez mettre à l’échelle la capacité en lecture ou en écriture (ou les deux), ainsi que les paramètres d’unité de capacité allouée minimum et maximum pour la table. La stratégie de mise à l'échelle définit également une *utilisation cible*. L’utilisation cible correspond au ratio unités de capacité consommées/unités de capacité allouées à un point dans le temps, exprimé sous forme de pourcentage. La mise à l'échelle automatique utilise un algorithme de *suivi de cible* pour ajuster le débit alloué de la table vers le haut ou vers le bas en réponse aux charges de travail réelles. L'utilisation réelle de la capacité reste ainsi proche de votre utilisation cible. Vous pouvez également définir les valeurs d'utilisation cibles de la mise à l'échelle automatique entre 20 % et 90 % pour votre capacité de lecture et d'écriture. Le taux d'utilisation cible par défaut est de 70 %. Vous pouvez définir l'utilisation cible à un pourcentage inférieur si votre trafic change rapidement et si vous souhaitez que la capacité commence à augmenter plus tôt. Vous pouvez également définir le taux d'utilisation cible sur un taux plus élevé si le trafic de votre application change plus lentement et que vous souhaitez réduire le coût du débit. Pour plus d'informations sur les politiques de dimensionnement, consultez la section [Politiques de dimensionnement du suivi des cibles pour Application Auto Scaling](https://docs.aws.amazon.com/autoscaling/application/userguide/application-auto-scaling-target-tracking.html) dans le [https://docs.aws.amazon.com/autoscaling/application/userguide/](https://docs.aws.amazon.com/autoscaling/application/userguide/). Lorsque vous créez une politique de dimensionnement, Amazon Keyspaces crée deux paires d' CloudWatch alarmes Amazon en votre nom. Chaque paire représente vos limites supérieure et inférieure pour les paramètres de débit alloué. Ces CloudWatch alarmes sont déclenchées lorsque l'utilisation réelle de la table s'écarte de votre utilisation cible pendant une période prolongée. Pour en savoir plus sur Amazon CloudWatch, consultez le [guide de CloudWatch l'utilisateur Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/). Lorsque l'une des CloudWatch alarmes est déclenchée, Amazon Simple Notification Service (Amazon SNS) vous envoie une notification (si vous l'avez activée). L' CloudWatch alarme appelle ensuite Application Auto Scaling pour évaluer votre politique de dimensionnement. Cela envoie ensuite une demande Alter Table à Amazon Keyspaces pour ajuster la capacité allouée à la table à la hausse ou à la baisse, selon le cas. Pour en savoir plus sur les notifications Amazon SNS, consultez [Configuration des notifications Amazon SNS](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/US_SetupSNS.html). Amazon Keyspaces traite la demande Alter Table en augmentant (ou en diminuant) la capacité de débit allouée à la table afin qu'elle se rapproche de votre objectif d'utilisation. **Note** Le scalage automatique d'Amazon Keyspaces modifie les paramètres de débit provisionnés uniquement lorsque la charge de travail réelle reste élevée (ou diminuée) pendant une période prolongée de plusieurs minutes. L'algorithme de suivi cherche à garder l'utilisation cible au niveau ou proche de la valeur choisie sur le long terme. Les pics soudains de l’activité de lecture sont gérés par la capacité de transmission en mode rafale intégrée de la table. ## Comment fonctionne la mise à l'échelle automatique pour les tables multirégionales Pour garantir que la capacité de lecture et d'écriture est toujours suffisante pour toutes les répliques de table dans Régions AWS l'ensemble d'une table multirégionale en mode capacité allouée, nous vous recommandons de configurer le dimensionnement automatique d'Amazon Keyspaces. Lorsque vous utilisez une table multirégionale en mode provisionné avec mise à l'échelle automatique, vous ne pouvez pas désactiver la mise à l'échelle automatique pour une seule réplique de table. Mais vous pouvez ajuster les paramètres de mise à l'échelle automatique de lecture du tableau pour différentes régions. Par exemple, vous pouvez spécifier des paramètres de capacité de lecture et de mise à l'échelle automatique de lecture différents pour chaque région dans laquelle la table est répliquée. Les paramètres de redimensionnement automatique en lecture que vous configurez pour une réplique de table dans une région spécifiée remplacent les paramètres généraux de mise à l'échelle automatique de la table. La capacité d'écriture doit toutefois rester synchronisée entre toutes les répliques de tables afin de garantir une capacité suffisante pour répliquer les écritures dans toutes les régions. Amazon Keyspaces auto scaling met à jour indépendamment la capacité allouée de la table dans chacune en Région AWS fonction de l'utilisation dans cette région. Par conséquent, la capacité allouée dans chaque région pour une table multirégionale peut être différente lorsque le dimensionnement automatique est activé. Vous pouvez configurer les paramètres de dimensionnement automatique d'une table multirégionale et de ses répliques à l'aide de la console Amazon Keyspaces, de l'API ou du CQL. AWS CLI Pour plus d'informations sur la création et la mise à jour des paramètres de mise à l'échelle automatique pour les tables multirégionales, consultez[Mettre à jour les paramètres de capacité allouée et de dimensionnement automatique pour une table multirégionale dans Amazon Keyspaces](tables-mrr-autoscaling.md). **Note** Si vous utilisez le dimensionnement automatique pour les tables multirégionales, vous devez toujours utiliser les opérations de l'API Amazon Keyspaces pour configurer les paramètres de dimensionnement automatique. Si vous utilisez directement les opérations de l'API Application Auto Scaling pour configurer les paramètres de dimensionnement automatique, vous n'êtes pas en mesure Régions AWS de spécifier le tableau multirégional. Cela peut entraîner des configurations non prises en charge. ## Notes d’utilisation Avant de commencer à utiliser le dimensionnement automatique d'Amazon Keyspaces, vous devez prendre en compte les points suivants : + Le dimensionnement automatique d'Amazon Keyspaces n'est pas disponible dans la région Moyen-Orient (Émirats arabes unis). + Le dimensionnement automatique d'Amazon Keyspaces peut augmenter la capacité de lecture ou d'écriture aussi souvent que nécessaire, conformément à votre politique de dimensionnement. Tous les quotas Amazon Keyspaces restent en vigueur, comme décrit dans. [Quotas pour Amazon Keyspaces (pour Apache Cassandra)](quotas.md) + Le dimensionnement automatique d'Amazon Keyspaces ne vous empêche pas de modifier manuellement les paramètres de débit provisionnés. Ces ajustements manuels n'affectent pas les CloudWatch alarmes existantes associées à la politique de dimensionnement. + Si vous utilisez la console pour créer une table avec une capacité de débit allouée, le dimensionnement automatique d'Amazon Keyspaces est activé par défaut. Vous pouvez modifier vos paramètres de mise à l'échelle automatique à tout moment. Pour de plus amples informations, veuillez consulter [Désactiver la mise à l'échelle automatique d'Amazon Keyspaces pour un tableau](autoscaling.turnoff.md). + Si vous utilisez CloudFormation pour créer des politiques de dimensionnement, vous devez gérer les politiques de dimensionnement de CloudFormation manière à ce que la pile soit synchronisée avec le modèle de pile. Si vous modifiez les politiques de dimensionnement d'Amazon Keyspaces, elles seront remplacées par les valeurs d'origine du modèle de pile lorsque la CloudFormation pile sera réinitialisée. + Si vous surveillez le dimensionnement automatique CloudTrail d'Amazon Keyspaces, vous pouvez recevoir des alertes concernant les appels effectués par Application Auto Scaling dans le cadre de son processus de validation de configuration. Vous pouvez filtrer ces alertes en utilisant le `invokedBy` champ qui contient `application-autoscaling.amazonaws.com` ces contrôles de validation. # Configurer et mettre à jour les politiques de dimensionnement automatique d'Amazon Keyspaces Vous pouvez utiliser la console, le CQL ou le AWS Command Line Interface (AWS CLI) pour configurer le dimensionnement automatique d'Amazon Keyspaces pour les tables nouvelles et existantes. Vous pouvez également modifier les paramètres de mise à l'échelle automatique ou désactiver la mise à l'échelle automatique. Pour des fonctionnalités plus avancées, telles que la définition des temps de recharge de mise à l'échelle initiale et inférieure, nous vous recommandons d'utiliser CQL ou le pour gérer les politiques de dimensionnement d' AWS CLI Amazon Keyspaces. **Topics** + [Configurer les autorisations pour le dimensionnement automatique d'Amazon Keyspaces](autoscaling.permissions.md) + [Création d'un nouveau tableau avec mise à l'échelle automatique](autoscaling.createTable.md) + [Configurer le dimensionnement automatique sur une table existante](autoscaling.configureTable.md) + [Afficher la configuration de mise à l'échelle automatique d'Amazon Keyspaces de votre table](autoscaling.viewPolicy.md) + [Désactiver la mise à l'échelle automatique d'Amazon Keyspaces pour un tableau](autoscaling.turnoff.md) + [Afficher l'activité de mise à l'échelle automatique d'une table Amazon Keyspaces dans Amazon CloudWatch](autoscaling.activity.md) # Configurer les autorisations pour le dimensionnement automatique d'Amazon Keyspaces Pour commencer, vérifiez que le principal dispose des autorisations appropriées pour créer et gérer les paramètres de dimensionnement automatique. Dans Gestion des identités et des accès AWS (IAM), la politique AWS gérée `AmazonKeyspacesFullAccess` est requise pour gérer les politiques de dimensionnement d'Amazon Keyspaces. **Important** Les autorisations `application-autoscaling:*` sont nécessaires pour désactiver la mise à l'échelle automatique sur une table. Vous devez désactiver la mise à l'échelle automatique pour une table avant de pouvoir la supprimer. Pour configurer un utilisateur ou un rôle IAM pour l'accès à la console Amazon Keyspaces et le dimensionnement automatique d'Amazon Keyspaces, ajoutez la politique suivante. **Pour joindre la `AmazonKeyspacesFullAccess` politique** 1. Connectez-vous à la console IAM AWS Management Console et ouvrez-la à [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)l'adresse. 1. Sur le tableau de bord de la console IAM, choisissez **Utilisateurs**, puis choisissez votre utilisateur ou votre rôle IAM dans la liste. 1. Sur la page **Récapitulatif**, choisissez **Ajouter des autorisations**. 1. Choisissez **Attacher directement les stratégies existantes**. 1. Dans la liste des politiques, choisissez **AmazonKeyspacesFullAccess**, puis cliquez sur **Suivant : Réviser**. 1. Choisissez **Ajouter des autorisations**. # Création d'un nouveau tableau avec mise à l'échelle automatique Lorsque vous créez une nouvelle table Amazon Keyspaces, vous pouvez activer automatiquement le dimensionnement automatique en fonction de la capacité d'écriture ou de lecture de la table. Cela permet à Amazon Keyspaces de contacter Application Auto Scaling en votre nom pour enregistrer la table en tant que cible évolutive et ajuster la capacité d'écriture ou de lecture allouée. Pour plus d'informations sur la façon de créer une table multirégionale et de configurer différents paramètres de mise à l'échelle automatique pour les répliques de tables, consultez. [Création d'une table multirégionale en mode provisionné avec mise à l'échelle automatique dans Amazon Keyspaces](tables-mrr-create-provisioned.md) **Note** Le dimensionnement automatique d'Amazon Keyspaces nécessite la présence d'un rôle lié à un service (`AWSServiceRoleForApplicationAutoScaling_CassandraTable`) qui exécute des actions de dimensionnement automatique en votre nom. Ce rôle est créé automatiquement pour vous. Pour de plus amples informations, veuillez consulter [Utilisation de rôles liés à un service pour Amazon Keyspaces](using-service-linked-roles.md). ------ #### [ Console ] **Créez un nouveau tableau avec la mise à l'échelle automatique activée à l'aide de la console** 1. [Connectez-vous à la AWS Management Console console Amazon Keyspaces et ouvrez-la chez https://console.aws.amazon.com/keyspaces/ vous.](https://console.aws.amazon.com/keyspaces/home) 1. Dans le panneau de navigation, choisissez **Tables**, puis **Create table (Créer une table)**. 1. Sur la page **Créer une table** dans la section **Détails de la table**, sélectionnez un espace de touche et donnez un nom à la nouvelle table. 1. Dans la section **Colonnes**, créez le schéma de votre table. 1. Dans la section **Clé primaire**, définissez la clé primaire de la table et sélectionnez les colonnes de clustering facultatives. 1. Dans la section **Paramètres du tableau**, choisissez **Personnaliser les paramètres**. 1. Continuez jusqu'à **Paramètres de capacité en lecture/écriture**. 1. Pour le **Mode de capacité**, choisissez **Provisioned (Alloué)**. 1. Dans la section **Capacité de lecture** confirmez que l'option **Mettre à l'échelle automatiquement** est sélectionnée. Dans cette étape, vous sélectionnez les unités de capacité de lecture minimale et maximale pour la table, ainsi que l'utilisation cible. + **Unités de capacité minimale** : entrez la valeur du niveau de débit minimal que le tableau doit toujours être prêt à prendre en charge. La valeur doit être comprise entre 1 et le quota par seconde du débit maximal pour votre compte (40 000 par défaut). + **Unités de capacité maximale** : entrez le débit maximal que vous souhaitez allouer pour le tableau. La valeur doit être comprise entre 1 et le quota par seconde du débit maximal pour votre compte (40 000 par défaut). + **Utilisation cible** — Entrez un taux d'utilisation cible compris entre 20 % et 90 %. Lorsque le trafic dépasse le taux d'utilisation cible défini, la capacité est automatiquement mise à l'échelle. Lorsque le trafic tombe en dessous de la cible définie, il est automatiquement réduit de nouveau. **Note** Pour en savoir plus sur les quotas par défaut de votre compte et sur la façon de les augmenter, reportez-vous à la section [Quotas pour Amazon Keyspaces (pour Apache Cassandra)](quotas.md). 1. Dans la section **Capacité d'écriture**, choisissez les mêmes paramètres que ceux définis à l'étape précédente pour la capacité de lecture ou configurez les valeurs de capacité manuellement. 1. Choisissez **Créer un tableau**. Votre table est créée avec les paramètres de mise à l'échelle automatique spécifiés. ------ #### [ Cassandra Query Language (CQL) ] **Créez une nouvelle table avec la mise à l'échelle automatique d'Amazon Keyspaces à l'aide de CQL** Pour configurer les paramètres de mise à l'échelle automatique d'une table par programmation, vous devez utiliser l'`AUTOSCALING_SETTINGS`instruction qui contient les paramètres de mise à l'échelle automatique d'Amazon Keyspaces. Les paramètres définissent les conditions qui obligent Amazon Keyspaces à ajuster le débit provisionné de votre table, ainsi que les actions facultatives supplémentaires à effectuer. Dans cet exemple, vous définissez les paramètres de mise à l'échelle automatique pour *mytable.* Cette politique contient les éléments suivants : + `AUTOSCALING_SETTINGS`— Spécifie si Amazon Keyspaces est autorisé à ajuster la capacité de débit en votre nom. Les valeurs suivantes sont obligatoires : + `provisioned_write_capacity_autoscaling_update`: + `minimum_units` + `maximum_units` + `provisioned_read_capacity_autoscaling_update`: + `minimum_units` + `maximum_units` + `scaling_policy`— Amazon Keyspaces soutient la politique de suivi des cibles. Pour définir la politique de suivi des cibles, vous devez configurer les paramètres suivants. + `target_value`— La mise à l'échelle automatique d'Amazon Keyspaces garantit que le rapport entre la capacité consommée et la capacité allouée reste égal ou proche de cette valeur. Vous définissez `target_value` en tant que pourcentage. + `disableScaleIn`: (Facultatif) Un `boolean` qui indique si la table `scale-in` est désactivée ou activée. Ce paramètre est désactivé par défaut. Pour l'activer`scale-in`, définissez la `boolean` valeur sur`FALSE`. Cela signifie que la capacité est automatiquement réduite pour une table en votre nom. + `scale_out_cooldown`— Une activité de scale-out augmente le débit provisionné de votre table. Pour ajouter un temps de stabilisation pour les activités de montée en charge, spécifiez une valeur, en secondes, pour `scale_out_cooldown`. Si vous ne spécifiez aucune valeur, la valeur par défaut est 0. Pour plus d'informations sur le suivi des cibles et les périodes de recharge, consultez les [politiques de dimensionnement de Target Tracking](https://docs.aws.amazon.com/autoscaling/application/userguide/application-auto-scaling-target-tracking.html) dans le *guide de l'utilisateur d'Application Auto Scaling*. + `scale_in_cooldown`— Une activité de scale-in réduit le débit provisionné de votre table. Pour ajouter un temps de stabilisation pour les activités de mise à l'échelle, spécifiez une valeur, en secondes, pour `scale_in_cooldown`. Si vous ne spécifiez aucune valeur, la valeur par défaut est 0. Pour plus d'informations sur le suivi des cibles et les périodes de recharge, consultez les [politiques de dimensionnement de Target Tracking](https://docs.aws.amazon.com/autoscaling/application/userguide/application-auto-scaling-target-tracking.html) dans le *guide de l'utilisateur d'Application Auto Scaling*. **Note** Pour mieux comprendre le fonctionnement de `target_value`, supposons que vous ayez une table avec un paramètre de débit approvisionné de 200 unités de capacité d’écriture. Vous décidez de créer une politique de mise à l’échelle pour cette table, avec une `target_value` de 70 pour cent. Supposons maintenant que vous commencez à générer du trafic d’écriture vers la table de telle sorte que le débit d’écriture réel est de 150 unités de capacité. Le consumed-to-provisioned ratio est maintenant de (150/200), soit 75 %. Ce ratio étant supérieur à votre objectif, l'autoscaling augmente la capacité d'écriture allouée à 215, de sorte que le ratio soit (150/ 215), soit 69,77 %, le plus proche `target_value` possible de la vôtre, sans toutefois le dépasser. Pour *mytable*, vous avez défini `TargetValue` une capacité de lecture et d'écriture de 50 %. Le dimensionnement automatique d'Amazon Keyspaces ajuste le débit provisionné de la table dans une fourchette de 5 à 10 unités de capacité afin que le consumed-to-provisioned ratio reste égal ou proche de 50 %. Pour la capacité de lecture, vous définissez les valeurs `ScaleInCooldown` pour `ScaleOutCooldown` et sur 60 secondes. Vous pouvez utiliser l'instruction suivante pour créer une nouvelle table Amazon Keyspaces avec la mise à l'échelle automatique activée. ``` CREATE TABLE mykeyspace.mytable(pk int, ck int, PRIMARY KEY (pk, ck)) 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 } } } }; ``` ------ #### [ CLI ] **Créez un nouveau tableau avec le dimensionnement automatique d'Amazon Keyspaces à l'aide du AWS CLI** Pour configurer les paramètres de dimensionnement automatique d'une table par programmation, vous devez utiliser l'`autoScalingSpecification`action qui définit les paramètres du dimensionnement automatique d'Amazon Keyspaces. Les paramètres définissent les conditions qui obligent Amazon Keyspaces à ajuster le débit provisionné de votre table, ainsi que les actions facultatives supplémentaires à effectuer. Dans cet exemple, vous définissez les paramètres de mise à l'échelle automatique pour *mytable.* Cette politique contient les éléments suivants : + `autoScalingSpecification`— Spécifie si Amazon Keyspaces est autorisé à ajuster le débit de capacité en votre nom. Vous pouvez activer la mise à l'échelle automatique pour la capacité de lecture et pour la capacité d'écriture séparément. Vous devez ensuite définir les paramètres suivants pour `autoScalingSpecification` : + `writeCapacityAutoScaling`— Les unités de capacité d'écriture maximale et minimale. + `readCapacityAutoScaling`— Les unités de capacité de lecture maximale et minimale. + `scalingPolicy`— Amazon Keyspaces soutient la politique de suivi des cibles. Pour définir la politique de suivi des cibles, vous devez configurer les paramètres suivants. + `targetValue`— La mise à l'échelle automatique d'Amazon Keyspaces garantit que le rapport entre la capacité consommée et la capacité allouée reste égal ou proche de cette valeur. Vous définissez `targetValue` en tant que pourcentage. + `disableScaleIn`: (Facultatif) Un `boolean` qui indique si la table `scale-in` est désactivée ou activée. Ce paramètre est désactivé par défaut. Pour l'activer`scale-in`, définissez la `boolean` valeur sur`FALSE`. Cela signifie que la capacité est automatiquement réduite pour une table en votre nom. + `scaleOutCooldown`— Une activité de scale-out augmente le débit provisionné de votre table. Pour ajouter un temps de stabilisation pour les activités de montée en charge, spécifiez une valeur, en secondes, pour `ScaleOutCooldown`. La valeur par défaut est 0. Pour plus d'informations sur le suivi des cibles et les périodes de recharge, consultez les [politiques de dimensionnement de Target Tracking](https://docs.aws.amazon.com/autoscaling/application/userguide/application-auto-scaling-target-tracking.html) dans le *guide de l'utilisateur d'Application Auto Scaling*. + `scaleInCooldown`— Une activité de scale-in réduit le débit provisionné de votre table. Pour ajouter un temps de stabilisation pour les activités de mise à l'échelle, spécifiez une valeur, en secondes, pour `ScaleInCooldown`. La valeur par défaut est 0. Pour plus d'informations sur le suivi des cibles et les périodes de recharge, consultez les [politiques de dimensionnement de Target Tracking](https://docs.aws.amazon.com/autoscaling/application/userguide/application-auto-scaling-target-tracking.html) dans le *guide de l'utilisateur d'Application Auto Scaling*. **Note** Pour mieux comprendre le fonctionnement de `TargetValue`, supposons que vous ayez une table avec un paramètre de débit approvisionné de 200 unités de capacité d’écriture. Vous décidez de créer une politique de mise à l’échelle pour cette table, avec une `TargetValue` de 70 pour cent. Supposons maintenant que vous commencez à générer du trafic d’écriture vers la table de telle sorte que le débit d’écriture réel est de 150 unités de capacité. Le consumed-to-provisioned ratio est maintenant de (150/200), soit 75 %. Ce ratio étant supérieur à votre objectif, l'autoscaling augmente la capacité d'écriture allouée à 215, de sorte que le ratio soit (150/ 215), soit 69,77 %, le plus proche `TargetValue` possible de la vôtre, sans toutefois le dépasser. Pour *mytable*, vous avez défini `TargetValue` une capacité de lecture et d'écriture de 50 %. Le dimensionnement automatique d'Amazon Keyspaces ajuste le débit provisionné de la table dans une fourchette de 5 à 10 unités de capacité afin que le consumed-to-provisioned ratio reste égal ou proche de 50 %. Pour la capacité de lecture, vous définissez les valeurs `ScaleInCooldown` pour `ScaleOutCooldown` et sur 60 secondes. Lorsque vous créez des tables avec des paramètres de mise à l'échelle automatique complexes, il est utile de charger les paramètres de mise à l'échelle automatique à partir d'un fichier JSON. Dans l'exemple suivant, vous pouvez télécharger le fichier JSON d'exemple depuis [auto-scaling.zip](samples/auto-scaling.zip) et l'extraire `auto-scaling.json` en prenant note du chemin d'accès au fichier. Dans cet exemple, le fichier JSON se trouve 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](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-parameters-file.html#cli-usage-parameters-file-how). ``` aws keyspaces create-table --keyspace-name mykeyspace --table-name mytable \ --schema-definition 'allColumns=[{name=pk,type=int},{name=ck,type=int}],partitionKeys=[{name=pk},{name=ck}]' \ --capacity-specification throughputMode=PROVISIONED,readCapacityUnits=1,writeCapacityUnits=1 \ --auto-scaling-specification file://auto-scaling.json ``` ------ # Configurer le dimensionnement automatique sur une table existante Vous pouvez mettre à jour une table Amazon Keyspaces existante pour activer le dimensionnement automatique en fonction de la capacité d'écriture ou de lecture de la table. Si vous mettez à jour une table qui est actuellement en mode capacité à la demande, vous devez d'abord changer le mode capacité de la table en mode capacité provisionnée. Pour plus d'informations sur la mise à jour des paramètres de mise à l'échelle automatique pour une table multirégionale, consultez[Mettre à jour les paramètres de capacité allouée et de dimensionnement automatique pour une table multirégionale dans Amazon Keyspaces](tables-mrr-autoscaling.md). Le dimensionnement automatique d'Amazon Keyspaces nécessite la présence d'un rôle lié à un service (`AWSServiceRoleForApplicationAutoScaling_CassandraTable`) qui exécute des actions de dimensionnement automatique en votre nom. Ce rôle est créé automatiquement pour vous. Pour de plus amples informations, veuillez consulter [Utilisation de rôles liés à un service pour Amazon Keyspaces](using-service-linked-roles.md). ------ #### [ Console ] **Configurer le dimensionnement automatique d'Amazon Keyspaces pour une table existante** 1. [Connectez-vous à la AWS Management Console console Amazon Keyspaces et ouvrez-la chez https://console.aws.amazon.com/keyspaces/ vous.](https://console.aws.amazon.com/keyspaces/home) 1. Choisissez la table avec laquelle vous souhaitez travailler, puis accédez à l'onglet **Capacité**. 1. Dans la section **Paramètres de capacité**, choisissez **Modifier**. 1. En **mode Capacité**, assurez-vous que la table utilise le mode Capacité **provisionnée**. 1. Sélectionnez **Mettre à l'échelle automatiquement** et consultez l'étape 6 dans [Création d'un nouveau tableau avec mise à l'échelle automatique](autoscaling.createTable.md) pour modifier la capacité de lecture et d'écriture. 1. Lorsque les paramètres de mise à l'échelle automatique sont définis, choisissez **Enregistrer**. ------ #### [ Cassandra Query Language (CQL) ] **Configurer une table existante avec le dimensionnement automatique d'Amazon Keyspaces à l'aide de CQL** Vous pouvez utiliser l'`ALTER TABLE`instruction d'une table Amazon Keyspaces existante pour configurer le dimensionnement automatique en fonction de la capacité d'écriture ou de lecture de la table. Si vous mettez à jour une table qui est actuellement en mode capacité à la demande, vous devez la `capacity_mode` définir sur provisionnée. Si votre table est déjà en mode capacité provisionnée, ce champ peut être omis. Dans l'exemple suivant, l'instruction met à jour la table *mytable*, qui est en mode capacité à la demande. L'instruction change le mode de capacité de la table en mode provisionné avec le dimensionnement automatique activé. La capacité d'écriture est configurée dans une plage de 5 à 10 unités de capacité avec une valeur cible de 50 %. La capacité de lecture est également configurée dans une plage de 5 à 10 unités de capacité avec une valeur cible de 50 %. Pour la capacité de lecture, vous définissez les valeurs `scale_in_cooldown` pour `scale_out_cooldown` et sur 60 secondes. ``` 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 } } } }; ``` ------ #### [ CLI ] **Configurez une table existante avec le dimensionnement automatique d'Amazon Keyspaces à l'aide du AWS CLI** Pour une table Amazon Keyspaces existante, vous pouvez activer le dimensionnement automatique pour la capacité d'écriture ou de lecture de la table à l'`UpdateTable`aide de cette opération. Vous pouvez utiliser la commande suivante pour activer le dimensionnement automatique d'Amazon Keyspaces pour une table existante. Les paramètres de mise à l'échelle automatique de la table sont chargés à partir d'un fichier JSON. Dans l'exemple suivant, vous pouvez télécharger le fichier JSON d'exemple depuis [auto-scaling.zip](samples/auto-scaling.zip) et l'extraire `auto-scaling.json` en prenant note du chemin d'accès au fichier. Dans cet exemple, le fichier JSON se trouve 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](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-parameters-file.html#cli-usage-parameters-file-how). Pour plus d'informations sur les paramètres de mise à l'échelle automatique utilisés dans l'exemple suivant, consultez[Création d'un nouveau tableau avec mise à l'échelle automatique](autoscaling.createTable.md). ``` 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 ``` ------ # Afficher la configuration de mise à l'échelle automatique d'Amazon Keyspaces de votre table Vous pouvez utiliser la console, le CQL ou le AWS CLI pour afficher et mettre à jour les paramètres de mise à l'échelle automatique d'une table Amazon Keyspaces. ------ #### [ Console ] **** **Afficher les paramètres de mise à l'échelle automatique à l'aide de la console** 1. Choisissez le tableau que vous souhaitez consulter et accédez à l'onglet **Capacité**. 1. Dans la section **Paramètres de capacité**, choisissez **Modifier**. Vous pouvez désormais modifier les paramètres dans les sections **Capacité de lecture** ou **Capacité d'écriture**. Pour plus d’informations sur ces paramètres, consultez la page [Création d'un nouveau tableau avec mise à l'échelle automatique](autoscaling.createTable.md). ------ #### [ Cassandra Query Language (CQL) ] **Consultez la politique de dimensionnement automatique d'Amazon Keyspaces de votre table à l'aide de CQL** Pour afficher les détails de la configuration de mise à l'échelle automatique d'une table, utilisez la commande suivante. ``` SELECT * FROM system_schema_mcs.autoscaling WHERE keyspace_name = 'mykeyspace' AND table_name = 'mytable'; ``` La sortie de cette commande ressemble à ceci : ``` keyspace_name | table_name | provisioned_read_capacity_autoscaling_update | provisioned_write_capacity_autoscaling_update ---------------+------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- mykeyspace | mytable | {'minimum_units': 5, 'maximum_units': 10, 'scaling_policy': {'target_tracking_scaling_policy_configuration': {'scale_out_cooldown': 60, 'disable_scale_in': false, 'target_value': 50, 'scale_in_cooldown': 60}}} | {'minimum_units': 5, 'maximum_units': 10, 'scaling_policy': {'target_tracking_scaling_policy_configuration': {'scale_out_cooldown': 0, 'disable_scale_in': false, 'target_value': 50, 'scale_in_cooldown': 0}}} ``` ------ #### [ CLI ] **Consultez la politique de dimensionnement automatique d'Amazon Keyspaces de votre table à l'aide du AWS CLI** Pour afficher la configuration de mise à l'échelle automatique d'une table, vous pouvez utiliser l'`get-table-auto-scaling-settings`opération. La commande CLI suivante en est un exemple. ``` aws keyspaces get-table-auto-scaling-settings --keyspace-name mykeyspace --table-name mytable ``` La sortie de cette commande ressemble à ceci : ``` { "keyspaceName": "mykeyspace", "tableName": "mytable", "resourceArn": "arn:aws:cassandra:us-east-1:111122223333:/keyspace/mykeyspace/table/mytable", "autoScalingSpecification": { "writeCapacityAutoScaling": { "autoScalingDisabled": false, "minimumUnits": 5, "maximumUnits": 10, "scalingPolicy": { "targetTrackingScalingPolicyConfiguration": { "disableScaleIn": false, "scaleInCooldown": 0, "scaleOutCooldown": 0, "targetValue": 50.0 } } }, "readCapacityAutoScaling": { "autoScalingDisabled": false, "minimumUnits": 5, "maximumUnits": 10, "scalingPolicy": { "targetTrackingScalingPolicyConfiguration": { "disableScaleIn": false, "scaleInCooldown": 60, "scaleOutCooldown": 60, "targetValue": 50.0 } } } } } ``` ------ # Désactiver la mise à l'échelle automatique d'Amazon Keyspaces pour un tableau Vous pouvez désactiver le dimensionnement automatique d'Amazon Keyspaces pour votre table à tout moment. Si vous n'avez plus besoin de redimensionner la capacité de lecture ou d'écriture de votre tableau, vous devriez envisager de désactiver le dimensionnement automatique afin qu'Amazon Keyspaces ne continue pas à modifier les paramètres de capacité de lecture ou d'écriture de votre tableau. Vous pouvez mettre à jour le tableau à l'aide de la console, du CQL ou du AWS CLI. La désactivation de la mise à l'échelle automatique supprime également les CloudWatch alarmes créées en votre nom. Pour supprimer le rôle lié à un service utilisé par Application Auto Scaling pour accéder à votre table Amazon Keyspaces, suivez les étapes décrites dans. [Supprimer un rôle lié à un service pour Amazon Keyspaces](using-service-linked-roles-app-auto-scaling.md#delete-service-linked-role-app-auto-scaling) **Note** Pour supprimer le rôle lié à un service utilisé par Application Auto Scaling, vous devez désactiver le dimensionnement automatique sur toutes les tables du compte. Régions AWS ------ #### [ Console ] **Désactiver le redimensionnement automatique d'Amazon Keyspaces pour votre table à l'aide de la console** **Utilisation de la console Amazon Keyspaces** 1. [Connectez-vous à la AWS Management Console console Amazon Keyspaces et ouvrez-la chez https://console.aws.amazon.com/keyspaces/ vous.](https://console.aws.amazon.com/keyspaces/home) 1. Choisissez le tableau que vous souhaitez mettre à jour et accédez à l'onglet **Capacité**. 1. Dans la section **Paramètres de capacité**, choisissez **Modifier**. 1. Pour désactiver le dimensionnement automatique d'Amazon Keyspaces, décochez la case **Scale automatically**. La désactivation du dimensionnement automatique annule l'enregistrement de la table en tant que cible évolutive avec Application Auto Scaling. ------ #### [ Cassandra Query Language (CQL) ] **Désactiver la mise à l'échelle automatique d'Amazon Keyspaces pour votre table à l'aide de CQL** L'instruction suivante désactive la mise à l'échelle automatique de la capacité d'écriture de la table *mytable.* ``` ALTER TABLE mykeyspace.mytable WITH AUTOSCALING_SETTINGS = { 'provisioned_write_capacity_autoscaling_update': { 'autoscaling_disabled': true } }; ``` ------ #### [ CLI ] **Désactivez le redimensionnement automatique d'Amazon Keyspaces pour votre tableau à l'aide du AWS CLI** La commande suivante désactive le dimensionnement automatique en fonction de la capacité de lecture de la table. Il supprime également les CloudWatch alarmes créées en votre nom. ``` aws keyspaces update-table --keyspace-name mykeyspace --table-name mytable \ --auto-scaling-specification readCapacityAutoScaling={autoScalingDisabled=true} ``` ------ # Afficher l'activité de mise à l'échelle automatique d'une table Amazon Keyspaces dans Amazon CloudWatch Vous pouvez surveiller la manière dont le dimensionnement automatique d'Amazon Keyspaces utilise les ressources en utilisant Amazon CloudWatch, qui génère des statistiques relatives à votre utilisation et à vos performances. Suivez les étapes du [guide de l'Application Auto Scaling utilisateur](https://docs.aws.amazon.com/autoscaling/application/userguide/monitoring-cloudwatch.html) pour créer un CloudWatch tableau de bord.