使用 AWS CLI 管理 DynamoDB 自動擴展

使用下列 AWS CLI 命令來建立資料表。

aws dynamodb create-table \
    --table-name TestTable \
    --attribute-definitions \
        AttributeName=pk,AttributeType=N \
        AttributeName=sk,AttributeType=N \
    --key-schema \
        AttributeName=pk,KeyType=HASH \
        AttributeName=sk,KeyType=RANGE \
    --provisioned-throughput ReadCapacityUnits=5,WriteCapacityUnits=5

若要檢查資料表的狀態，請使用以下命令。

aws dynamodb describe-table \
    --table-name TestTable \
    --query "Table.[TableName,TableStatus,ProvisionedThroughput]"

當資料表狀態為 ACTIVE 時，即可供使用。

輸入下列命令來註冊可擴展的目標。

aws application-autoscaling register-scalable-target \
    --service-namespace dynamodb \
    --resource-id "table/TestTable" \
    --scalable-dimension "dynamodb:table:WriteCapacityUnits" \
    --min-capacity 5 \
    --max-capacity 10

若要確認註冊，請使用下列命令。

aws application-autoscaling describe-scalable-targets \
    --service-namespace dynamodb \
    --resource-id "table/TestTable"

aws application-autoscaling register-scalable-target \
    --service-namespace dynamodb \
    --resource-id "table/TestTable/index/test-index" \
    --scalable-dimension "dynamodb:index:WriteCapacityUnits" \
    --min-capacity 5 \
    --max-capacity 10

使用下列內容建立名為 scaling-policy.json 的檔案。

{
    "PredefinedMetricSpecification": {
        "PredefinedMetricType": "DynamoDBWriteCapacityUtilization"
    },
    "ScaleOutCooldown": 60,
    "ScaleInCooldown": 60,
    "TargetValue": 50.0
}            

使用下列 AWS CLI 命令來建立政策。

aws application-autoscaling put-scaling-policy \
    --service-namespace dynamodb \
    --resource-id "table/TestTable" \
    --scalable-dimension "dynamodb:table:WriteCapacityUnits" \
    --policy-name "MyScalingPolicy" \
    --policy-type "TargetTrackingScaling" \
    --target-tracking-scaling-policy-configuration file://scaling-policy.json

請注意，在輸出中，Application Auto Scaling 已建立兩個 Amazon CloudWatch 警示：擴展目標範圍的上限和下限各一個警示。

使用下列 AWS CLI 命令來檢視擴展政策的詳細資訊。

aws application-autoscaling describe-scaling-policies \
    --service-namespace dynamodb \
    --resource-id "table/TestTable" \
    --policy-name "MyScalingPolicy"

在輸出中，確認政策設定符合 步驟 2：註冊可擴展的目標 和 步驟 3：建立擴展政策 中的規格。

使用下列內容建立名為 bulk-load-test-table.py 的檔案。

import boto3
dynamodb = boto3.resource('dynamodb')

table = dynamodb.Table("TestTable")

filler = "x" * 100000

i = 0
while (i < 10):
    j = 0
    while (j < 10):
        print (i, j)
        
        table.put_item(
            Item={
                'pk':i,
                'sk':j,
                'filler':{"S":filler}
            }
        )
        j += 1
    i += 1

請輸入下列命令來執行程式。

python bulk-load-test-table.py

TestTable 的佈建寫入容量非常低 (5 個寫入容量單位)，因此程式偶爾會因寫入調節而停滯。這是預期的行為。

讓程式繼續執行，您則繼續下一個步驟。

輸入下列命令來檢視 Application Auto Scaling 動作。

aws application-autoscaling describe-scaling-activities \
    --service-namespace dynamodb

在 Python 程式執行時，偶爾重新執行此命令。(叫用擴展政策需要幾分鐘的時間。) 您最終應該會看到下列輸出。

...
{
    "ScalableDimension": "dynamodb:table:WriteCapacityUnits", 
    "Description": "Setting write capacity units to 10.", 
    "ResourceId": "table/TestTable", 
    "ActivityId": "0cc6fb03-2a7c-4b51-b67f-217224c6b656", 
    "StartTime": 1489088210.175, 
    "ServiceNamespace": "dynamodb", 
    "EndTime": 1489088246.85, 
    "Cause": "monitor alarm AutoScaling-table/TestTable-AlarmHigh-1bb3c8db-1b97-4353-baf1-4def76f4e1b9 in state ALARM triggered policy MyScalingPolicy", 
    "StatusMessage": "Successfully set write capacity units to 10. Change successfully fulfilled by dynamodb.", 
    "StatusCode": "Successful"
}, 
...

這表示 Application Auto Scaling 已對 DynamoDB 發出 UpdateTable 請求。

輸入下列命令，確認 DynamoDB 已增加資料表的寫入容量。

aws dynamodb describe-table \
    --table-name TestTable \
    --query "Table.[TableName,TableStatus,ProvisionedThroughput]"

WriteCapacityUnits 應該從 5 擴展至 10。

刪除 TestTable 的擴展政策。

aws application-autoscaling delete-scaling-policy \
    --service-namespace dynamodb \
    --resource-id "table/TestTable" \
    --scalable-dimension "dynamodb:table:WriteCapacityUnits" \
    --policy-name "MyScalingPolicy"

取消註冊可擴展的目標。

aws application-autoscaling deregister-scalable-target \
    --service-namespace dynamodb \
    --resource-id "table/TestTable" \
    --scalable-dimension "dynamodb:table:WriteCapacityUnits"

刪除 TestTable 資料表。

aws dynamodb delete-table --table-name TestTable