

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.

# Creación de una nueva tabla con escalado automático
<a name="autoscaling.createTable"></a>

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
```

------