AWS CLI を使用した DynamoDB Auto Scaling の管理

以下の 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 が 2 つの 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