更新 Amazon Keyspaces 中多區域表格的佈建容量和 auto 擴展設定

本節包含如何使用主控台CQL、和 AWS CLI 管理已佈建的多區域表的 Amazon Keyspaces auto 擴展設定。如需一般 auto 調整設定選項及其運作方式的詳細資訊，請參閱使用 Amazon Keyspaces 自動擴展自 auto 管理輸送量容量。

請注意，如果您使用多區域表的佈建容量模式，則必須始終使用 Amazon Keyspaces API 呼叫來設定 auto 擴展。這是因為基礎的 Application Auto Scaling API 作業不感知區域。

如需如何預估佈建的多區域表格寫入容量輸送量的詳細資訊，請參閱估計和佈建 Amazon Keyspaces 中多區域表格的容量。

如需 Amazon Keyspaces 的詳細資訊API，請參閱 Amazon Keyspaces API 參考。

當您更新多區域表格的佈建模式或 auto 調整設定時，您可以更新表格每個複本的讀取容量設定和讀取 auto 調整規模組態。

但是，寫入容量會在所有複本之間保持同步，以確保有足夠的容量可以跨所有區域複寫寫入。

Cassandra Query Language (CQL)

使用以下方式更新多區域表格的佈建容量和 auto 擴展設定 CQL

• 您可以使ALTER TABLE用更新現有表格的容量模式和 auto 調整設定。如果您要更新目前處於隨選容量模式的資料表，則需要capacity_mode這項功能。如果您的表格已經處於佈建容量模式，則可以省略此欄位。

  如需有關 auto 擴展設定、目標追蹤原則、目標值和選用設定的詳細資訊，請參閱建立具有自動縮放功能的新資料表。

  在相同的陳述式中，您也可以更新資料表的replica_updates屬性，更新特定區域中資料表複本的讀取容量和 auto 調整設定。下面的語句是這樣的一個例子。

  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
              }  
          }  
      },
      'replica_updates': {
          'us-east-1': {
              'provisioned_read_capacity_autoscaling_update': {
                  'maximum_units': 20,
                  'minimum_units': 5,
                  'scaling_policy': {
                      'target_tracking_scaling_policy_configuration': {
                          'target_value': 70
                      } 
                  }
              }
          }
      }
  };

CLI

使用更新多區域表格的佈建容量和 auto 調整設定 AWS CLI

• 若要更新現有表格的佈建模式和 auto 調整設定，您可以使用 AWS CLI update-table指令。

  請注意，您必須使用 Amazon Keyspaces CLI 命令來建立或修改多區域 auto 擴展設定。這是因為 Amazon Keyspaces 用來代表您執行表格容量 auto 擴展的服務「Application Auto Scaling 用程式自動擴展」不支援多個 AWS 區域.

  若要更新特定區域中表格複本的讀取容量，您可以變更表格的下列其中一個選用參數replicaSpecifications：

  • 佈建的讀取容量單位 (選用)

  • 讀取容量的自動縮放設定 (選用)

  當您使用複雜的 auto 調整設定和不同的資料表複本組態來JSON更新多區域表時，從檔案載入表格的 auto 調整設定和複本組態會很有幫助。

  若要使用下列程式碼範例，您可以從 auto-scaling.zip 下載範例JSON檔案，然後擷取auto-scaling.json和replication.json。記下檔案的路徑。

  在此範例中，JSON檔案位於目前目錄中。如需不同的檔案路徑選項，請參閱如何從檔案載入參數。

  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 
             \ --replica-specifications file://replication.json