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.
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
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.
- Console
-
Créez un nouveau tableau avec la mise à l'échelle automatique activée à l'aide de la console
-
Connectez-vous au AWS Management Console, et ouvrez la console Amazon Keyspaces chez https://console.aws.amazon.com/keyspaces/ vous.
-
Dans le panneau de navigation, choisissez Tables, puis Create table (Créer une table).
-
Sur la page Créer une table, dans la section Détails de la table, sélectionnez un espace de touche et attribuez un nom à la nouvelle table.
-
Dans la section Colonnes, créez le schéma de votre table.
-
Dans la section Clé primaire, définissez la clé primaire de la table et sélectionnez les colonnes de clustering facultatives.
Dans la section Paramètres du tableau, choisissez Personnaliser les paramètres.
-
Continuez jusqu'à Paramètres de capacité en lecture/écriture.
-
Pour le Mode de capacité, choisissez Provisioned (Alloué).
-
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).
-
-
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.
-
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 un nouveau tableau avec le dimensionnement 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éfinisseztarget_value
en tant que pourcentage. -
disableScaleIn
: (Facultatif) Unboolean
qui indique si la tablescale-in
est désactivée ou activée. Ce paramètre est désactivé par défaut. Pour l'activerscale-in
, définissez laboolean
valeur surFALSE
. 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, pourscale_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 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, pourscale_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 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 unetarget_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 valeursScaleInCooldown
pourScaleOutCooldown
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 pourautoScalingSpecification
:-
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éfinisseztargetValue
en tant que pourcentage. -
disableScaleIn
: (Facultatif) Unboolean
qui indique si la tablescale-in
est désactivée ou activée. Ce paramètre est désactivé par défaut. Pour l'activerscale-in
, définissez laboolean
valeur surFALSE
. 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, pourScaleOutCooldown
. 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 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, pourScaleInCooldown
. 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 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 uneTargetValue
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 valeursScaleInCooldown
pourScaleOutCooldown
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 JSON fichier. Pour l'exemple suivant, vous pouvez télécharger le JSON fichier d'exemple depuis auto-scaling.zip et l'extraire
auto-scaling.json
en prenant note du chemin d'accès au fichier. Dans cet exemple, le JSON fichier se trouve 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 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
-