As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Alterar o modo de capacidade de uma tabela no Amazon Keyspaces
<a name="ReadWriteCapacityMode.SwitchReadWriteCapacityMode"></a>

Quando você troca uma tabela de modo de capacidade provisionada para modo de capacidade sob demanda, o Amazon Keyspaces faz várias alterações na estrutura de sua tabela e suas partições. Esse processo pode levar alguns minutos. Durante o período de troca, sua tabela entrega throughput consistente com os valores de WCU e RCU provisionados anteriormente. 

Quando você alterna do modo de capacidade sob demanda de volta para o modo de capacidade provisionada, sua tabela fornece um throughput consistente com o pico anterior atingido quando a tabela foi definida para o modo de capacidade sob demanda.

Os períodos de espera a seguir se aplicam quando você alterna os modos de capacidade:
+ É possível alternar uma tabela recém-criada no modo sob demanda para o modo de capacidade provisionada a qualquer momento. No entanto, só é possível voltar ao modo sob demanda 24 horas após o carimbo de data e hora de criação da tabela. 
+ É possível alternar uma tabela existente no modo sob demanda para o modo de capacidade provisionada a qualquer momento. No entanto, você pode alternar os modos de capacidade provisionada para sob demanda somente uma vez em um período de 24 horas.

------
#### [ Cassandra Query Language (CQL) ]

**Alterar o modo de capacidade de throughput de uma tabela usando CQL**

1. Para alterar o modo de capacidade de uma tabela para `PROVIOSIONED`, você precisa configurar as unidades de capacidade de leitura e de gravação com base nos valores de pico esperados da workload. A instrução a seguir é um exemplo disso. Você também pode executar essa instrução para ajustar a capacidade de leitura ou as unidades de capacidade de gravação da tabela.

   ```
   ALTER TABLE catalog.book_awards WITH CUSTOM_PROPERTIES={'capacity_mode':{'throughput_mode': 'PROVISIONED', 'read_capacity_units': 6000, 'write_capacity_units': 3000}};
   ```

   Para configurar o modo de capacidade provisionada com ajuste de escala automático, consulte [Configurar o ajuste de escala automático em uma tabela existente](autoscaling.configureTable.md).

1. Para alterar o modo de capacidade de uma tabela para o modo sob demanda, defina o modo de throughput como `PAY_PER_REQUEST`. A instrução a seguir é um exemplo disso.

   ```
   ALTER TABLE catalog.book_awards WITH CUSTOM_PROPERTIES={'capacity_mode':{'throughput_mode': 'PAY_PER_REQUEST'}};
   ```

1. Você pode usar a seguinte instrução para confirmar o modo de capacidade da tabela.

   ```
   SELECT * from system_schema_mcs.tables where keyspace_name = 'catalog' and table_name = 'book_awards';
   ```

   Uma tabela configurada com o modo de capacidade sob demanda retorna o seguinte.

   ```
   {
      "capacity_mode":{
         "last_update_to_pay_per_request_timestamp":"1727952499092",
         "throughput_mode":"PAY_PER_REQUEST"
      }
   }
   ```

   O valor `last_update_to_pay_per_request_timestamp` é medido em milissegundos.

------
#### [ CLI ]

**Altere o modo de capacidade de taxa de transferência de uma tabela usando o AWS CLI**

1. Para alterar o modo de capacidade da tabela para `PROVIOSIONED`, você precisa configurar as unidades de capacidade de leitura e de gravação com base nos valores de pico esperados da workload. O comando a seguir é um exemplo disso. Você também pode executar esse comando para ajustar a capacidade de leitura ou as unidades de capacidade de gravação da tabela.

   ```
   aws keyspaces update-table --keyspace-name catalog --table-name book_awards  
                                       \--capacity-specification throughputMode=PROVISIONED,readCapacityUnits=6000,writeCapacityUnits=3000
   ```

   Para configurar o modo de capacidade provisionada com ajuste de escala automático, consulte [Configurar o ajuste de escala automático em uma tabela existente](autoscaling.configureTable.md).

1. Para alterar o modo de capacidade de uma tabela para o modo sob demanda, você define o modo de throughput como `PAY_PER_REQUEST`. A instrução a seguir é um exemplo disso.

   ```
   aws keyspaces update-table --keyspace-name catalog --table-name book_awards 
                                       \--capacity-specification throughputMode=PAY_PER_REQUEST
   ```

1. Use os comandos a seguir para analisar o modo de capacidade configurado para uma tabela.

   ```
   aws keyspaces get-table --keyspace-name catalog --table-name book_awards
   ```

   A saída de uma tabela no modo sob demanda é semelhante a esta.

   ```
   "capacitySpecification": {
           "throughputMode": "PAY_PER_REQUEST",
           "lastUpdateToPayPerRequestTimestamp": "2024-10-03T10:48:19.092000+00:00"
       }
   ```

------