Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Administración automática de la capacidad de rendimiento con el escalado automático de Amazon Keyspaces
Muchas cargas de trabajo de base de datos son cíclicas o difíciles de predecir con antelación. Por ejemplo, tomemos una aplicación de redes sociales en la que la mayoría de los usuarios están activos en el horario diurno. La base de datos debe satisfacer los requisitos de la actividad diurna, pero no se requieren los mismos niveles de rendimiento por la noche.
Otro ejemplo podría ser una nueva aplicación de juegos para móviles cuya adopción está siendo muy rápida. Si el juego se vuelve muy popular, podría superar los recursos de base de datos disponibles, lo que provocaría un rendimiento lento y clientes descontentos. Estos tipos de cargas de trabajo suelen requerir intervención manual para escalar los recursos de la base de datos en sentido ascendente o descendente en respuesta a las variaciones en los niveles de uso.
Amazon Keyspaces (para Apache Cassandra) le ayuda a aprovisionar capacidad de rendimiento de forma eficiente para cargas de trabajo variables ajustando de forma automática la capacidad de rendimiento en respuesta al tráfico real de la aplicación. Amazon Keyspaces utiliza el servicio Application Auto Scaling para aumentar y reducir la capacidad de lectura y escritura de una tabla en su nombre. Para obtener más información sobre Application Auto Scaling, consulte la [Guía del usuario de Application Auto Scaling](https://docs.aws.amazon.com/autoscaling/application/userguide/).
**nota**
Para ver una introducción rápida al escalado automático de Amazon Keyspaces, consulte [Configuración y actualización de las políticas de escalado automático de Amazon Keyspaces](autoscaling.configure.md).
## Funcionamiento del escalado automático de Amazon Keyspaces
En el siguiente diagrama se proporciona información general de alto nivel sobre el modo en que el escalado automático de Amazon Keyspaces administra la capacidad de rendimiento de una tabla.
![\[Un diagrama que muestra los diferentes servicios que intervienen cuando un usuario realiza un cambio en una tabla de Amazon Keyspaces. Los servicios son Amazon CloudWatch, Amazon SNS y Application Auto Scaling, que emite la declaración ALTER TABLE para cambiar la capacidad en función del uso de lectura o escritura de los usuarios.\]](http://docs.aws.amazon.com/es_es/keyspaces/latest/devguide/images/keyspaces_auto-scaling.png)
Para habilitar el escalado automático de una tabla, cree una *política de escalado*. La política de escalado especifica si desea escalar la capacidad de lectura, la capacidad de escritura o ambas, así como la configuración mínima y máxima de la unidad de capacidad aprovisionada para la tabla.
La política de escalado también define una *utilización objetivo*. La utilización objetivo es la relación entre las unidades de capacidad consumidas y las unidades de capacidad aprovisionadas en un momento dado, expresada como porcentaje. El escalado automático utiliza un algoritmo de *seguimiento de objetivos* para ajustar el rendimiento aprovisionado de la tabla al alza o a la baja en respuesta a las cargas de trabajo reales. Lo hace para que la utilización real de la capacidad se mantenga en su utilización objetivo o cerca de ella.
Puede establecer los valores de utilización objetivo de escalado automático entre el 20 y el 90 % de su capacidad de lectura y escritura. La tasa de utilización objetivo predeterminada es del 70 %. Puede fijar la utilización objetivo en un porcentaje inferior si su tráfico cambia rápidamente y desea que la capacidad empiece a escalarse antes. También puede fijar la tasa de utilización objetivo en un valor más alto si el tráfico de su aplicación cambia con lentitud y desea reducir el costo del rendimiento.
Para obtener más información sobre las políticas de escalado, consulte [Políticas de escalado de seguimiento de objetivos de Application Auto Scaling](https://docs.aws.amazon.com/autoscaling/application/userguide/application-auto-scaling-target-tracking.html) en la [https://docs.aws.amazon.com/autoscaling/application/userguide/](https://docs.aws.amazon.com/autoscaling/application/userguide/).
Cuando crea una política de escalado, Amazon Keyspaces crea dos pares de CloudWatch alarmas de Amazon en su nombre. Cada par representa sus límites superior e inferior para las configuraciones de rendimiento aprovisionadas y consumidas. Estas CloudWatch alarmas se activan cuando la utilización real de la tabla se desvía de la utilización objetivo durante un período prolongado. Para obtener más información sobre Amazon CloudWatch, consulta la [Guía del CloudWatch usuario de Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/).
Cuando se activa una de las CloudWatch alarmas, Amazon Simple Notification Service (Amazon SNS) te envía una notificación (si la has activado). A continuación, la CloudWatch alarma invoca Application Auto Scaling para evaluar su política de escalado. Esto, a su vez, emite una solicitud Alterar tabla a Amazon Keyspaces para ajustar la capacidad aprovisionada de la tabla al alza o a la baja según corresponda. Para obtener más información sobre las notificaciones de Amazon SNS, consulte [Configuración de las notificaciones de Amazon SNS](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/US_SetupSNS.html).
Amazon Keyspaces procesa la solicitud Alterar tabla con el aumento (o la disminución) de la capacidad de rendimiento aprovisionada de la tabla para que se aproxime a su utilización objetivo.
**nota**
El escalado automático de Amazon Keyspaces modifica la configuración de rendimiento aprovisionada solo cuando la carga de trabajo real se mantiene elevada (o deprimida) durante un periodo sostenido de varios minutos. El algoritmo de seguimiento de objetivo intenta mantener el objetivo de utilización en el valor elegido o en valores próximos a él a largo plazo. Los picos de actividad repentinos y breves se atienden gracias a la capacidad de ampliación incorporada de la tabla.
## Funcionamiento del escalado automático para tablas multirregión
Para garantizar que siempre haya suficiente capacidad de lectura y escritura para todas las réplicas de tablas Regiones de AWS de una tabla multirregional en el modo de capacidad aprovisionada, le recomendamos que configure el escalado automático de Amazon Keyspaces.
Al utilizar una tabla multirregión en modo aprovisionado con escalado automático, no puede deshabilitar el escalado automático para una réplica de una sola tabla. Sin embargo, puede ajustar la configuración de escalado automático de lectura de la tabla para diferentes regiones. Por ejemplo, puede especificar diferentes configuraciones de capacidad de lectura y escalado automático de lectura para cada región en la que se replique la tabla.
Los ajustes de escalado automático de lectura que se configuran para una réplica de tabla en una región específica sobrescriben los ajustes generales de escalado automático de la tabla. Sin embargo, la capacidad de escritura debe permanecer sincronizada en todas las réplicas de la tabla para garantizar que haya suficiente capacidad para replicar las escrituras en todas las regiones.
El escalado automático de Amazon Keyspaces actualiza de forma independiente la capacidad aprovisionada de la tabla en cada Región de AWS en función del uso en esa región. Como resultado, la capacidad aprovisionada en cada región para una tabla multirregión podría ser diferente cuando el escalado automático esté activo.
Puede configurar los ajustes de escalado automático de una tabla multirregión y sus réplicas mediante la consola, la API o el CQL de Amazon Keyspaces. AWS CLI Para obtener más información sobre cómo crear y actualizar la configuración de escalado automático para tablas multirregión, consulte [Actualización de la capacidad aprovisionada y la configuración de escalado automático para una tabla multirregional en Amazon Keyspaces](tables-mrr-autoscaling.md).
**nota**
Si usa el escalado automático para tablas multirregión, siempre debe usar las operaciones de la API de Amazon Keyspaces para configurar los ajustes de escalado automático. Si utiliza las operaciones de la API Application Auto Scaling directamente para configurar los ajustes de autoescalado, no podrá especificar los Regiones de AWS de la tabla multirregión. Esto puede provocar que las configuraciones no sean compatibles.
## Notas de uso
Antes de comenzar a utilizar el escalado automático de Amazon Keyspaces, debe tener en cuenta lo siguiente:
+ El escalado automático de Amazon Keyspaces no está disponible en la región de Oriente Medio (EAU).
+ El escalado automático de Amazon Keyspaces puede aumentar la capacidad de lectura o de escritura tantas veces como sea necesario, de acuerdo con su política de escalado. Todas las cuotas de Amazon Keyspaces permanecen en vigor, tal y como se describe en [Cuotas para Amazon Keyspaces (para Apache Cassandra)](quotas.md).
+ El escalado automático de Amazon Keyspaces no le impide modificar manualmente los ajustes de capacidad aprovisionada. Estos ajustes manuales no afectan a ninguna de las CloudWatch alarmas existentes asociadas a la política de escalado.
+ Si utiliza la consola para crear una tabla con capacidad de rendimiento aprovisionada, el escalado automático de Amazon Keyspaces se habilita de forma predeterminada. Puede modificar la configuración del escalado automático en cualquier momento. Para obtener más información, consulte [Desactivación del escalado automático de Amazon Keyspaces para una tabla](autoscaling.turnoff.md).
+ Si utiliza políticas de escalado CloudFormation para crear políticas de escalado, debe administrar las políticas de escalado CloudFormation para que la pila esté sincronizada con la plantilla de pila. Si cambias las políticas de escalado de Amazon Keyspaces, se sobrescribirán con los valores originales de la plantilla de CloudFormation pila cuando se restablezca la pila.
+ Si lo utiliza CloudTrail para supervisar el escalado automático de Amazon Keyspaces, es posible que vea alertas de las llamadas realizadas por Application Auto Scaling como parte de su proceso de validación de la configuración. Puede filtrar estas alertas utilizando el campo `invokedBy`, que contiene `application-autoscaling.amazonaws.com` para estas comprobaciones de validación.
# Configuración y actualización de las políticas de escalado automático de Amazon Keyspaces
Puede usar la consola, CQL o AWS Command Line Interface (AWS CLI) para configurar el escalado automático de Amazon Keyspaces para tablas nuevas y existentes. También puede modificar la configuración del escalado automático o deshabilitarlo.
Para funciones más avanzadas, como establecer tiempos de enfriamiento de escalado vertical y escalable, le recomendamos que utilice CQL o las políticas de escalado para gestionar las políticas de escalado de AWS CLI Amazon Keyspaces.
**Topics**
+ [Configuración de permisos para el escalado automático de Amazon Keyspaces](autoscaling.permissions.md)
+ [Creación de una nueva tabla con escalado automático](autoscaling.createTable.md)
+ [Configuración del escalado automático en una tabla existente](autoscaling.configureTable.md)
+ [Visualización de la configuración de escalado automático de Amazon Keyspaces de la tabla](autoscaling.viewPolicy.md)
+ [Desactivación del escalado automático de Amazon Keyspaces para una tabla](autoscaling.turnoff.md)
+ [Ver la actividad de escalado automático de una tabla de Amazon Keyspaces en Amazon CloudWatch](autoscaling.activity.md)
# Configuración de permisos para el escalado automático de Amazon Keyspaces
Para empezar, confirme que la entidad principal tenga los permisos apropiados para crear y administrar la configuración del escalado automático. En AWS Identity and Access Management (IAM), la política AWS gestionada `AmazonKeyspacesFullAccess` es necesaria para gestionar las políticas de escalado de Amazon Keyspaces.
**importante**
Se requieren permisos `application-autoscaling:*` para deshabilitar el escalado automático en una tabla. Debe desactivar el escalado automático de una tabla antes de poder eliminarla.
Para configurar un usuario o un rol de IAM para el acceso a la consola de Amazon Keyspaces y el escalado automático de Amazon Keyspaces, añada la siguiente política.
**Asociación de la política `AmazonKeyspacesFullAccess`**
1. Inicie sesión en la consola de IAM Consola de administración de AWS y ábrala en. [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)
1. En el panel de la consola de IAM, elija **Usuarios** y, a continuación, seleccione el usuario o el rol de IAM en la lista.
1. En la página **Resumen**, elija **Añadir permisos**.
1. Elija **Asociar políticas existentes directamente**.
1. En la lista de políticas, elija y **AmazonKeyspacesFullAccess**, a continuación, elija **Siguiente: revisar**.
1. Elija **Añadir permisos**.
# Creación de una nueva tabla con escalado automático
Al crear una nueva tabla de Amazon Keyspaces, puede habilitar automáticamente el escalado automático de la capacidad de escritura o lectura de la tabla. Esto permite a Amazon Keyspaces ponerse en contacto con Application Auto Scaling en su nombre para registrar la tabla como un objetivo escalable y ajustar la capacidad de escritura o lectura aprovisionada.
Para obtener más información sobre cómo crear una tabla multirregión y configurar distintos ajustes de escalado automático para tablas multirregión, consulte [Creación de una tabla multirregional en modo aprovisionado con escalado automático en Amazon Keyspaces](tables-mrr-create-provisioned.md).
**nota**
El escalado automático de Amazon Keyspaces requiere la presencia de un rol vinculado a servicios (`AWSServiceRoleForApplicationAutoScaling_CassandraTable`) que realice acciones de escalado automático en su nombre. Este rol se crea automáticamente. Para obtener más información, consulte [Uso de roles vinculados a servicios para Amazon Keyspaces](using-service-linked-roles.md).
------
#### [ Console ]
**Creación de una nueva tabla con escalado automático habilitado mediante la consola**
1. [Inicia sesión en la Consola de administración de AWS consola de Amazon Keyspaces y ábrela desde casahttps://console.aws.amazon.com/keyspaces/.](https://console.aws.amazon.com/keyspaces/home)
1. En el panel de navegación, elija **Tablas** y, a continuación, seleccione **Crear tabla**.
1. En la página **Crear tabla**, en la sección **Detalles de la tabla**, seleccione un espacio de claves y proporcione un nombre para la nueva tabla.
1. En la sección **Columnas**, cree el esquema para la tabla.
1. En la sección **Clave principal**, defina la clave principal de la tabla y seleccione las columnas de agrupación en clústeres opcionales.
1. En la sección **Configuración de la tabla**, elija **Personalizar configuración**.
1. Continúe en **Configuración de capacidad de lectura/escritura**.
1. En **Modo de capacidad**, elija **Aprovisionada**.
1. En la sección **Capacidad de lectura**, confirme que esté seleccionada la opción **Escalado automático**.
En este paso, usted selecciona las unidades de capacidad de lectura mínima y máxima para la tabla, así como la utilización objetivo.
+ **Unidades de capacidad mínima**: introduzca el valor de nivel mínimo de rendimiento para el que la tabla debería estar siempre preparada para admitir. El valor debe estar comprendido entre 1 y la cuota máxima de rendimiento por segundo de su cuenta (40 000 de forma predeterminada).
+ **Unidades de capacidad máxima**: introduzca la cantidad máxima de rendimiento que desee aprovisionar para la tabla. El valor debe estar comprendido entre 1 y la cuota máxima de rendimiento por segundo de su cuenta (40 000 de forma predeterminada).
+ **Utilización objetivo**: introduzca una tasa de utilización objetivo entre el 20 % y el 90 %. Cuando el tráfico supera la tasa de utilización objetivo definida, la capacidad aumenta automáticamente. Cuando el tráfico cae por debajo del objetivo definido, se vuelve a reducir automáticamente.
**nota**
Para obtener más información sobre las cuotas predeterminadas de su cuenta y cómo aumentarlas, consulte [Cuotas para Amazon Keyspaces (para Apache Cassandra)](quotas.md).
1. En la sección **Capacidad de escritura**, elija los mismos ajustes que se definieron en el paso anterior para capacidad de lectura o configure los valores de capacidad manualmente.
1. Seleccione **Create table (Creación de tabla)**. Su tabla se crea con los parámetros de escalado automático especificados.
------
#### [ Cassandra Query Language (CQL) ]
**Creación de una nueva tabla con escalado automático de Amazon Keyspaces mediante CQL**
Para configurar los ajustes de escalado automático de una tabla mediante programación, utilice la instrucción `AUTOSCALING_SETTINGS` que contiene los parámetros del escalado automático de Amazon Keyspaces. Los parámetros definen las condiciones que indican a Amazon Keyspaces que debe ajustar el rendimiento aprovisionado de la tabla y las acciones opcionales adicionales que debe realizar. En este ejemplo, se definen los ajustes de escalado automático para *mytable*.
La política contiene los componentes siguientes:
+ `AUTOSCALING_SETTINGS`: especifica si Amazon Keyspaces puede ajustar la capacidad de rendimiento en su nombre. Los siguientes valores son necesarios:
+ `provisioned_write_capacity_autoscaling_update`:
+ `minimum_units`
+ `maximum_units`
+ `provisioned_read_capacity_autoscaling_update`:
+ `minimum_units`
+ `maximum_units`
+ `scaling_policy`: Amazon Keyspaces es compatible con la política de seguimiento de objetivos. Para definir la política de seguimiento de objetivos, debe configurar los siguientes parámetros.
+ `target_value`: el escalado automático de Amazon Keyspaces garantiza que la relación entre capacidad consumida y capacidad aprovisionada se mantenga en este valor o cerca del mismo. `target_value` se define como un porcentaje.
+ `disableScaleIn`: (opcional) un valor `boolean` que especifica si el `scale-in` está deshabilitado o habilitado para la tabla. Este parámetro está deshabilitado de forma predeterminada. Para activar el `scale-in`, establezca el valor `boolean` como `FALSE`. Esto significa que la capacidad se reduce verticalmente de forma automática para una tabla en su nombre.
+ `scale_out_cooldown`: una actividad de escalado horizontal aumenta el rendimiento aprovisionado de su tabla. Para añadir un periodo de recuperación para las actividades de escalado horizontal, especifique un valor para `scale_out_cooldown` en segundos. Si no especifica un valor, el valor predeterminado es 0. Para obtener más información acerca del seguimiento de objetivos y los periodos de recuperación, consulte [Políticas de escalado de seguimiento de objetivos](https://docs.aws.amazon.com/autoscaling/application/userguide/application-auto-scaling-target-tracking.html) en la *Guía del usuario de Application Auto Scaling*.
+ `scale_in_cooldown`: una actividad de reducción horizontal disminuye el rendimiento aprovisionado de su tabla. Para añadir un periodo de recuperación para las actividades de reducción horizontal, especifique un valor para `scale_in_cooldown` en segundos. Si no especifica un valor, el valor predeterminado es 0. Para obtener más información acerca del seguimiento de objetivos y los periodos de recuperación, consulte [Políticas de escalado de seguimiento de objetivos](https://docs.aws.amazon.com/autoscaling/application/userguide/application-auto-scaling-target-tracking.html) en la *Guía del usuario de Application Auto Scaling*.
**nota**
Para entender cómo funciona `target_value`, imagine que tiene una tabla con una configuración de rendimiento aprovisionado de 200 unidades de capacidad de escritura. Decide crear una política de escalado para esta tabla, con un valor de `target_value` del 70 %.
Ahora, supongamos que comienza a dirigir el tráfico de escritura a la tabla, de tal forma que el rendimiento de escritura real es de 150 unidades de capacidad. La consumed-to-provisioned proporción es ahora (150/ 200), o sea, del 75 por ciento. Esta proporción supera su objetivo, de modo que el escalado automático aumenta la capacidad de escritura aprovisionada a 215 para que la proporción sea de (150/215), es decir, del 69,77 %; de esta forma se mantiene lo más próxima posible al valor de `target_value`, pero sin superarlo.
Para *mytable*, establezca `TargetValue` tanto para la lectura como para la escritura en un 50 %. El escalado automático de Amazon Keyspaces ajusta el rendimiento aprovisionado de la tabla dentro del rango de 5 a 10 unidades de capacidad, de modo que la consumed-to-provisioned proporción se mantenga en el 50 por ciento o cerca de él. Para la capacidad de lectura, los valores de `ScaleOutCooldown` y `ScaleInCooldown` se establecen en 60 segundos.
Puede usar la siguiente instrucción para crear una nueva tabla de Amazon Keyspaces con el escalado automático activado.
```
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 ]
**Cree una tabla nueva con el escalado automático de Amazon Keyspaces mediante el AWS CLI**
Para configurar los ajustes de escalado automático de una tabla mediante programación, utilice la acción `autoScalingSpecification` que define los parámetros del escalado automático de Amazon Keyspaces. Los parámetros definen las condiciones que indican a Amazon Keyspaces que debe ajustar el rendimiento aprovisionado de la tabla y las acciones opcionales adicionales que debe realizar. En este ejemplo, se definen los ajustes de escalado automático para *mytable*.
La política contiene los componentes siguientes:
+ `autoScalingSpecification`: especifica si Amazon Keyspaces puede ajustar la capacidad de rendimiento en su nombre. Puede activar el escalado automático de la capacidad de lectura y escritura por separado. A continuación, debe especificar los siguientes parámetros para `autoScalingSpecification`:
+ `writeCapacityAutoScaling`: las unidades de capacidad de escritura máxima y mínima.
+ `readCapacityAutoScaling`: las unidades de capacidad de lectura máxima y mínima.
+ `scalingPolicy`: Amazon Keyspaces es compatible con la política de seguimiento de objetivos. Para definir la política de seguimiento de objetivos, debe configurar los siguientes parámetros.
+ `targetValue`: el escalado automático de Amazon Keyspaces garantiza que la relación entre capacidad consumida y capacidad aprovisionada se mantenga en este valor o cerca del mismo. `targetValue` se define como un porcentaje.
+ `disableScaleIn`: (opcional) un valor `boolean` que especifica si el `scale-in` está deshabilitado o habilitado para la tabla. Este parámetro está deshabilitado de forma predeterminada. Para activar el `scale-in`, establezca el valor `boolean` como `FALSE`. Esto significa que la capacidad se reduce verticalmente de forma automática para una tabla en su nombre.
+ `scaleOutCooldown`: una actividad de escalado horizontal aumenta el rendimiento aprovisionado de su tabla. Para añadir un periodo de recuperación para las actividades de escalado horizontal, especifique un valor para `ScaleOutCooldown` en segundos. El valor predeterminado es 0. Para obtener más información acerca del seguimiento de objetivos y los periodos de recuperación, consulte [Políticas de escalado de seguimiento de objetivos](https://docs.aws.amazon.com/autoscaling/application/userguide/application-auto-scaling-target-tracking.html) en la *Guía del usuario de Application Auto Scaling*.
+ `scaleInCooldown`: una actividad de reducción horizontal disminuye el rendimiento aprovisionado de su tabla. Para añadir un periodo de recuperación para las actividades de reducción horizontal, especifique un valor para `ScaleInCooldown` en segundos. El valor predeterminado es 0. Para obtener más información acerca del seguimiento de objetivos y los periodos de recuperación, consulte [Políticas de escalado de seguimiento de objetivos](https://docs.aws.amazon.com/autoscaling/application/userguide/application-auto-scaling-target-tracking.html) en la *Guía del usuario de Application Auto Scaling*.
**nota**
Para entender cómo funciona `TargetValue`, imagine que tiene una tabla con una configuración de rendimiento aprovisionado de 200 unidades de capacidad de escritura. Decide crear una política de escalado para esta tabla, con un valor de `TargetValue` del 70 %.
Ahora, supongamos que comienza a dirigir el tráfico de escritura a la tabla, de tal forma que el rendimiento de escritura real es de 150 unidades de capacidad. La consumed-to-provisioned proporción es ahora (150/200), o sea, del 75 por ciento. Esta proporción supera su objetivo, de modo que el escalado automático aumenta la capacidad de escritura aprovisionada a 215 para que la proporción sea de (150/215), es decir, del 69,77 %; de esta forma se mantiene lo más próxima posible al valor de `TargetValue`, pero sin superarlo.
Para *mytable*, establezca `TargetValue` tanto para la lectura como para la escritura en un 50 %. El escalado automático de Amazon Keyspaces ajusta el rendimiento aprovisionado de la tabla dentro del rango de 5 a 10 unidades de capacidad, de modo que la consumed-to-provisioned proporción se mantenga en el 50 por ciento o cerca de él. Para la capacidad de lectura, los valores de `ScaleOutCooldown` y `ScaleInCooldown` se establecen en 60 segundos.
Al crear tablas con ajustes de escalado automático complejos, resulta útil cargar los ajustes de escalado automático desde un archivo JSON. Para el siguiente ejemplo, puede descargar el archivo JSON de ejemplo de [auto-scaling.zip](samples/auto-scaling.zip) y extraer `auto-scaling.json`, tomando nota de la ruta de acceso al archivo. En este ejemplo, el archivo JSON se encuentra en el directorio actual. Para conocer las distintas opciones de ruta del archivo, consulte [Carga de parámetros desde un archivo](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
```
------
# Configuración del escalado automático en una tabla existente
Puede actualizar una tabla de Amazon Keyspaces existente para activar el escalado automático de la capacidad de escritura o lectura de la tabla. Si está actualizando una tabla que actualmente está en modo de capacidad bajo demanda, primero tiene que cambiar el modo de capacidad de la tabla al modo de capacidad aprovisionada.
Para obtener más información sobre cómo actualizar la configuración de escalado automático para una tabla multirregión, consulte [Actualización de la capacidad aprovisionada y la configuración de escalado automático para una tabla multirregional en Amazon Keyspaces](tables-mrr-autoscaling.md).
El escalado automático de Amazon Keyspaces requiere la presencia de un rol vinculado a servicios (`AWSServiceRoleForApplicationAutoScaling_CassandraTable`) que realice acciones de escalado automático en su nombre. Este rol se crea automáticamente. Para obtener más información, consulte [Uso de roles vinculados a servicios para Amazon Keyspaces](using-service-linked-roles.md).
------
#### [ Console ]
**Configuración del escalado automático de Amazon Keyspaces para una tabla existente**
1. [Inicia sesión en la Consola de administración de AWS consola de Amazon Keyspaces y ábrela desde casahttps://console.aws.amazon.com/keyspaces/.](https://console.aws.amazon.com/keyspaces/home)
1. Elija la tabla con la que quiera trabajar y, a continuación, seleccione la pestaña **Capacidad**.
1. En la sección **Configuración de capacidad**, elija **Editar**.
1. En **Modo de capacidad**, asegúrese de que la tabla utilice el modo de capacidad **Aprovisionada**.
1. Seleccione **Escalado automático** y, a continuación, consulte el paso 6 en [Creación de una nueva tabla con escalado automático](autoscaling.createTable.md) para editar la capacidad de lectura y escritura.
1. Cuando se hayan definido los ajustes de escalado automático, elija **Guardar**.
------
#### [ Cassandra Query Language (CQL) ]
**Configuración de una tabla existente con el escalado automático de Amazon Keyspaces mediante CQL**
Puede utilizar la instrucción `ALTER TABLE` para que una tabla de Amazon Keyspaces existente active el escalado automático de la capacidad de escritura o lectura de la tabla. Si va a actualizar una tabla que actualmente esté en modo de capacidad bajo demanda, debe configurar `capacity_mode` como aprovisionada. Si la tabla ya está en el modo de capacidad aprovisionada, puede omitir este campo.
En el siguiente ejemplo, la instrucción actualiza la tabla *mytable*, que está en modo de capacidad bajo demanda. La instrucción cambia el modo de capacidad de la tabla al modo aprovisionado con el escalado automático habilitado.
La capacidad de escritura se configura dentro del rango de 5-10 unidades de capacidad con un valor objetivo del 50 %. La capacidad de lectura también se configura dentro del rango de 5-10 unidades de capacidad con un valor objetivo del 50 %. Para la capacidad de lectura, los valores de `scale_out_cooldown` y `scale_in_cooldown` se establecen en 60 segundos.
```
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 ]
**Configure una tabla existente con el escalado automático de Amazon Keyspaces mediante AWS CLI**
Para una tabla de Amazon Keyspaces existente, puede activar el escalado automático de la capacidad de escritura o lectura de la tabla utilizando la operación `UpdateTable`.
Puede utilizar el siguiente comando para habilitar el escalado automático de Amazon Keyspaces para una tabla existente. La configuración de escalado automático de la tabla se carga desde un archivo JSON. Para el siguiente ejemplo, puede descargar el archivo JSON de ejemplo de [auto-scaling.zip](samples/auto-scaling.zip) y extraer `auto-scaling.json`, tomando nota de la ruta de acceso al archivo. En este ejemplo, el archivo JSON se encuentra en el directorio actual. Para conocer las distintas opciones de ruta del archivo, consulte [Carga de parámetros desde un archivo](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-parameters-file.html#cli-usage-parameters-file-how).
Para obtener más información sobre la configuración de escalado automático utilizado en el siguiente ejemplo, consulte [Creación de una nueva tabla con escalado automático](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
```
------
# Visualización de la configuración de escalado automático de Amazon Keyspaces de la tabla
Puede utilizar la consola, el CQL o el AWS CLI para ver y actualizar la configuración de escalado automático de Amazon Keyspaces de una tabla.
------
#### [ Console ]
****
**Visualización de la configuración de escalado automático mediante la consola**
1. Elija la tabla que quiera ver y seleccione la pestaña **Capacidad**.
1. En la sección **Configuración de capacidad**, elija **Editar**. Ahora puede modificar los ajustes en las secciones **Capacidad de lectura** o **Capacidad de escritura**. Para obtener más información sobre estas opciones, consulte [Creación de una nueva tabla con escalado automático](autoscaling.createTable.md).
------
#### [ Cassandra Query Language (CQL) ]
**Visualización de la política de escalado automático de Amazon Keyspaces de la tabla mediante CQL**
Para ver los detalles de la configuración de escalado automático de una tabla, utilice el siguiente comando.
```
SELECT * FROM system_schema_mcs.autoscaling WHERE keyspace_name = 'mykeyspace' AND table_name = 'mytable';
```
La salida de este comando tiene el siguiente aspecto.
```
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 ]
**Consulta la política de escalado automático de Amazon Keyspaces de tu mesa mediante el AWS CLI**
Para ver la configuración de escalado automático de una tabla, puede utilizar la operación `get-table-auto-scaling-settings`. El siguiente comando de la CLI es un ejemplo de esto.
```
aws keyspaces get-table-auto-scaling-settings --keyspace-name mykeyspace --table-name mytable
```
La salida de este comando tiene el siguiente aspecto.
```
{
"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
}
}
}
}
}
```
------
# Desactivación del escalado automático de Amazon Keyspaces para una tabla
Puede desactivar el escalado automático de Amazon Keyspaces para la tabla en cualquier momento. Si ya no necesita escalar la capacidad de lectura o escritura de la tabla, debería plantearse desactivar el escalado automático para que Amazon Keyspaces deje de modificar continuamente la configuración de la capacidad de lectura o escritura de su tabla. Puede actualizar la tabla con la consola, CQL o la AWS CLI.
Al desactivar el escalado automático, también se eliminan las CloudWatch alarmas que se crearon en tu nombre.
Para eliminar el rol vinculado a servicios utilizado por Application Auto Scaling para acceder a la tabla de Amazon Keyspaces, siga los pasos indicados en [Eliminación de un rol vinculado a servicios para Amazon Keyspaces](using-service-linked-roles-app-auto-scaling.md#delete-service-linked-role-app-auto-scaling).
**nota**
Para eliminar el rol vinculado a servicios utilizado por Application Auto Scaling, debe deshabilitar el escalado automático en todas las tablas de la cuenta en todas las Regiones de AWS.
------
#### [ Console ]
**Desactivación del escalado automático de Amazon Keyspaces para la tabla mediante la consola**
**Uso de la consola de Amazon Keyspaces**
1. [Inicia sesión en la Consola de administración de AWS consola de Amazon Keyspaces y ábrela desde casahttps://console.aws.amazon.com/keyspaces/.](https://console.aws.amazon.com/keyspaces/home)
1. Elija la tabla que quiera actualizar y seleccione la pestaña **Capacidad**.
1. En la sección **Configuración de capacidad**, elija **Editar**.
1. Para deshabilitar el escalado automático de Amazon Keyspaces, anule la selección de la casilla **Escalado automático**. Al deshabilitar el escalado automático se anula el registro de la tabla como objetivo escalable con Application Auto Scaling.
------
#### [ Cassandra Query Language (CQL) ]
**Desactivación del escalado automático de Amazon Keyspaces para la tabla mediante CQL**
La siguiente instrucción desactiva el escalado automático de la capacidad de escritura de la tabla *mytable*.
```
ALTER TABLE mykeyspace.mytable
WITH AUTOSCALING_SETTINGS = {
'provisioned_write_capacity_autoscaling_update': {
'autoscaling_disabled': true
}
};
```
------
#### [ CLI ]
**Desactive el escalado automático de Amazon Keyspaces para su tabla mediante el AWS CLI**
El siguiente comando desactiva el escalado automático de la capacidad de lectura de la tabla. También elimina las CloudWatch alarmas que se crearon en su nombre.
```
aws keyspaces update-table --keyspace-name mykeyspace --table-name mytable
\ --auto-scaling-specification readCapacityAutoScaling={autoScalingDisabled=true}
```
------
# Ver la actividad de escalado automático de una tabla de Amazon Keyspaces en Amazon CloudWatch
Puede supervisar la forma en que el escalado automático de Amazon Keyspaces utiliza los recursos mediante Amazon CloudWatch, que genera métricas sobre su uso y rendimiento. Siga los pasos de la [Guía del Application Auto Scaling usuario](https://docs.aws.amazon.com/autoscaling/application/userguide/monitoring-cloudwatch.html) para crear un CloudWatch panel de control.