本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 變更 Amazon Keyspaces 中資料表的容量模式
<a name="ReadWriteCapacityMode.SwitchReadWriteCapacityMode"></a>

當您將資料表從佈建容量模式切換到隨需容量模式時，Amazon Keyspaces 會對資料表和分割區的結構進行數項變更。此程序需要幾分鐘的時間。在切換期間，您的資料表會提供與先前佈建的 WCU 和 RCU 金額一致的輸送量。

當您從隨需容量模式切換回佈建容量模式時，您的資料表會提供與資料表設定為隨需容量模式時先前達到的尖峰一致的輸送量。

當您切換容量模式時，適用下列等待期間：
+ 您可以隨時將新建立的隨需模式資料表切換為佈建容量模式。不過，您只能在資料表建立時間戳記的 24 小時後將其切換回隨需模式。
+ 您可以隨時將隨需模式中的現有資料表切換為佈建容量模式。不過，您只能在 24 小時期間內將容量模式從佈建切換到隨需。

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

**使用 CQL 變更資料表的輸送量容量模式**

1. 若要將資料表的容量模式變更為 `PROVIOSIONED` ，您必須根據工作負載預期的峰值來設定讀取容量和寫入容量單位。以下陳述式為範例。您也可以執行此陳述式來調整 資料表的讀取容量或寫入容量單位。

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

   若要使用自動調整規模設定佈建容量模式，請參閱 [在現有資料表上設定自動擴展](autoscaling.configureTable.md)。

1. 若要將資料表的容量模式變更為隨需模式，請將輸送量模式設定為 `PAY_PER_REQUEST`。下列陳述式為範例。

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

1. 您可以使用下列陳述式來確認資料表的容量模式。

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

   使用隨需容量模式設定的資料表會傳回下列項目。

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

   `last_update_to_pay_per_request_timestamp` 值的測量單位為毫秒。

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

**使用 變更資料表的輸送量容量模式 AWS CLI**

1. 若要將資料表的容量模式變更為 `PROVIOSIONED` ，您必須根據工作負載的預期尖峰值來設定讀取容量和寫入容量單位。下列命令是此範例。您也可以執行此命令來調整 資料表的讀取容量或寫入容量單位。

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

   若要使用自動調整規模設定佈建容量模式，請參閱 [在現有資料表上設定自動擴展](autoscaling.configureTable.md)。

1. 若要將資料表的容量模式變更為隨需模式，請將輸送量模式設定為 `PAY_PER_REQUEST`。下列陳述式為範例。

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

1. 您可以使用下列命令來檢閱為資料表設定的容量模式。

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

   隨需模式中資料表的輸出如下所示。

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

------