DynamoDBのスループット制限を取得するAPIが公開されました
ウィスキー、シガー、パイプをこよなく愛する大栗です。
DynamoDBのスループット制限を取得するAPI（DescribeLimits）が公開されたので検証してみました。
Announcement: Announcing the new DescribeLimits API for DynamoDB
DescribeLimits？
今回公開されたAPI（DescribeLimits）はDynamoDBでプロビジョニングできるスループット（Capacity Unit）の範囲を動的に取得できる機能となります。
ドキュメントには以下のように初期初期の制限が記載されています。
プロビジョニングされるスループットについては、いくつかの初期的な最大制限があります。
- US East (N. Virginia) リージョン:
- テーブル単位 – 読み込みキャパシティーユニット数 40,000 および書き込みキャパシティーユニット数 40,000
- アカウント単位 – 読み込みキャパシティーユニット数 80,000 および書き込みキャパシティーユニット数 80,000
- その他すべてのリージョン:
- テーブル単位 – 読み込みキャパシティーユニット数 10,000 および書き込みキャパシティーユニット数 10,000
- アカウント単位 – 読み込みキャパシティーユニット数 20,000 および書き込みキャパシティーユニット数 20,000
初期制限は記載されていますが、AWSサポートへ申請して上限緩和が可能です。上限を緩和した値を
AWS Documentation » Amazon DynamoDB » Developer Guide » DynamoDB での制限：キャパシティーユニットとプロビジョニングされるスループット
実行してみる
APIはAWS-CLIで確認して見ます。
まずAWS-CLIを最新バージョンへアップデートします。
$ pip install -U awscli
AWS-CLIが最新になったのでaws dynamodb describe-limitsを実行します。
$ aws dynamodb describe-limits --region us-east-1
{
"TableMaxReadCapacityUnits": 40000,
"TableMaxWriteCapacityUnits": 40000,
"AccountMaxReadCapacityUnits": 80000,
"AccountMaxWriteCapacityUnits": 80000
}
各項目は、以下の意味になります。
- TableMaxReadCapacityUnits：テーブル単位 – 読み込みキャパシティーユニット数
- TableMaxWriteCapacityUnits：テーブル単位 – 書き込みキャパシティーユニット数
- AccountMaxReadCapacityUnits：アカウント単位 – 読み込みキャパシティーユニット数
- AccountMaxWriteCapacityUnits：アカウント単位 – 書き込みキャパシティーユニット数
全リージョンでaws dynamodb describe-limitsを実行した結果が、以下の表になります。
| リージョン | テーブルごとの最大WriteCapacityUnits | テーブルごとの最大ReadCapacityUnits | アカウントの最大WriteCapacityUnits | アカウントの最大ReadCapacityUnits | 備考 |
|---|---|---|---|---|---|
| バージニア北部 | 40000 | 40000 | 80000 | 80000 | |
| 北カリフォルニア | 10000 | 10000 | 20000 | 20000 | |
| オレゴン | 10000 | 10000 | 20000 | 20000 | |
| アイルランド | 10000 | 10000 | 20000 | 20000 | |
| フランクフルト | 10000 | 10000 | 20000 | 20000 | |
| 東京 | 取得不可 | 取得不可 | 取得不可 | 取得不可 | DescribeLimitsが未実装と思われる |
| ソウル | 取得不可 | 取得不可 | 取得不可 | 取得不可 | DescribeLimitsが未実装と思われる |
| シンガポール | 10000 | 10000 | 20000 | 20000 | |
| シドニー | 10000 | 10000 | 20000 | 20000 | |
| サンパウロ | 10000 | 10000 | 20000 | 20000 |
上限緩和をしていないためドキュメント通りの内容となりましたが、東京（ap-northeast-1）とソウル（ap-northeast-2）は2016年3月8日9:00 JST時点でaws dynamodb describe-limitsは未実装のようです。使用するためには、少し時間が必要のようです。
$ aws dynamodb describe-limits --region ap-northeast-1 A client error (UnknownOperationException) occurred when calling the DescribeLimits operation:
$ aws dynamodb describe-limits --region ap-northeast-2 A client error (UnknownOperationException) occurred when calling the DescribeLimits operation:
さいごに
動的にスループットの上限が取得できるのでDynamic DynamoDBのように動的にCapacity Unitを変更するようなプロダクトを使用する場合に丁度良いのではないでしょうか？
初期制限を越えるスループットが必要になる事はほとんど無いと思われますが、大規模サービスでDynamoDBを使用する場合に使用できると思います。
GitHub - sebdah/dynamic-dynamodb: Dynamic DynamoDB provides auto scaling for AWS DynamoDB Dynamic DynamoDB — Dynamic DynamoDB 2.2.1 documentation
