初級読了 2 分

DynamoDB の Scan が遅くて高コストな理由

Scan はテーブル内のすべてのアイテムを読み取り、その後でしかフィルタリングしません。それは SQL の筋肉記憶で手を伸ばしてしまう操作であり、テーブル全体を課金しながら、あなたが後にしてきた RDS ボックスよりもレイテンシーを悪化させる操作です。

私の DynamoDB の Scan はなぜ遅くて高コストなのか?

Scan は FilterExpression が動く前にテーブル内のすべてのアイテムを読み取るため、返ってくる行がどれほど少なくてもテーブル全体を読み取る分を支払うことになり、テーブルが大きくなるほど遅くなります。修正策はほぼ常にキー付きの Query です。アクセスパターンをキーを中心にモデリングして、DynamoDB がすべてではなく1つのアイテムコレクションを読むようにします。

  • 請求額を決めるのは結果件数ではなくテーブルサイズ。 12件のアイテムを返すのに、1200万件の読み取り分を請求されることがあります。
  • キー付きの Query はテーブルが成長しても横ばいのまま。 テーブルの残りがどれだけ大きくなっても、 1つの を読むだけです。
  • 日常的な質問に答えるために Scan するなら、キーを見落としている。 フィルターを調整しても直りません。

Scan が実際にすること

SQL から来ると、SELECT * FROM events WHERE type = 'login_failed' はタダに感じられます。エンジンにはインデックスがあるか、ないかのいずれかですが、どちらにしても行が返ってきます。 DynamoDB にはそれを決めてくれるクエリプランナーはありません。

Scan はテーブル全体を 1 MB ずつ順に歩き、各ページをあなたの FilterExpression に渡します。フィルターが拒否したものも読み取られ、計量され、なおあなたの請求に乗ります。(AWS: テーブルのスキャン)

それが罠です。フィルターは WHERE 句のように見えますが、変えるのは結果セットであって、コストではありません。 Scan はフィルターの有無に関わらず同じ読み取りキャパシティを消費します。(AWS: テーブルのスキャン)

読み取りユニットを数える

DynamoDB は読み取りを (RCU) で計量します。1 RCU で最大 4 KB の 読み取りを1回行えます。 読み取りはその半分のコストです。

Query と Scan は、1ページで読み取ったすべてのアイテムのサイズを合計し、アイテムごとではなくその合計を次の 4 KB に切り上げます(AWS: 読み取りおよび書き込みオペレーション)。コストの完全な表と定価は Query 対 Scan にあります。

分析用テーブル ProductEvents を取り上げます。各行は SaaS アプリで追跡された1つのイベントです。

PK  = "TENANT#acme"
SK  = "TS#2026-06-23T14:08:55Z#evt_9f3a"
attrs: eventType, sessionId, userId, payloadBytes

これが1つの多忙なテナントの下に、それぞれ約 1 KB の 2,000,000 件のイベントを保持しているとしましょう。あなたは今日のログイン失敗を求めます。反射的な手は次のとおりです。

Scan ProductEvents
FilterExpression: eventType = "login_failed"

そのフィルターは40行を返すかもしれません。しかし Scan はまず 2,000,000 件のアイテムをすべて読み取りました。約 2 GB のデータで、結果整合性でおよそ 250,000 読み取りユニットになり、それで返すのは40件のアイテムです。

フィルターではなく、問いにキーを付ける

ソートキーに日付を入れれば、Query はテーブルではなく1日分を読みます。その日の中からログイン失敗を選び出すのは、依然としてフィルターの役目です。

Query ProductEvents
PK = "TENANT#acme"
AND SK begins_with "TS#2026-06-23"
FilterExpression: eventType = "login_failed"

その日のイベントが約 2,000 件(約 2 MB)なら、支払うのは 2 GB ではなく約 2 MB の読み取り分、およそ 250 読み取りユニットです。3桁の改善ですが、40件を得るために依然として 2,000 件のイベントを読んでいます。

読み取りを答えに一致させるには、イベントタイプをキーに入れます。ベーステーブルはそのままにして、パーティションキーにテナントとタイプを持つ GSI を追加します。

GSI1PK = "TENANT#acme#login_failed"   GSI1SK = "TS#2026-06-23T14:08:55Z"
Query GSI1
GSI1PK = "TENANT#acme#login_failed"
AND GSI1SK begins_with "TS#2026-06-23"

これで読み取るのは40件のログイン失敗、約 40 KB、およそ 5 読み取りユニットです。どちらの Query もキー範囲の外を見ないので、テーブルが成長してもレイテンシーは横ばいのままです。

Scan 対 Query、計量した比較

Scan + フィルターその日への Query + フィルターGSI への Query
読み取りすべてのアイテム1つのアイテムコレクション、1日分一致したイベントのみ
この例約 250,000 ユニット(約 2 GB)約 250 ユニット(約 2 MB)約 5 ユニット(約 40 KB)
レイテンシーテーブルサイズとともに増大テーブルが成長しても横ばいテーブルが成長しても横ばい
結果件数と請求額無関係答えではなく1日分で上限が決まる互いに追随する

Scan では、結果件数と請求額は無関係です。Query はキー範囲で請求額に上限を設け、キーが絞られるほど請求額は答えに近づきます。

Scan する前に決める

偶発的な Scan のほとんどは1つの問いから生まれます。必要なパーティションを名指しできるか?できるなら Query です。できないなら、グローバルセカンダリインデックスを追加して、その問いを Query にします。

Query 対 Scan がその判断をたどり、シングルテーブル設計 がアクセスパターンを中心にキーを前もってモデリングする方法を示しています。

問いがすべてを対象にした1回限りの分析で、どのキーも合わないときは、稼働中のテーブルを Scan しないでください。 S3 にエクスポートし(読み取りキャパシティは消費しません)、そのファイルを Athena でクエリします。コマンドは Query 対 Scan にあります。

ジョブが稼働中のすべてのアイテムに作用しなければならないとき(バックフィル、移行)は、意図して Scan します。並列スキャン でワーカー間に分割し、LastEvaluatedKey でページングし(ページネーション)、ペースを調整します。

Scan で問題ないときの完全な一覧は Query 対 Scan のページにあります。

フィルターではなく、キー付きのクエリを書く

キーを超える条件が必要なときは、すべてを FilterExpression に投げ込むのではなく、意図的に組み立てましょう。

DynamoDB 式ビルダー が KeyConditionExpression と属性のプレースホルダーを生成してくれるので、DynamoDB が読み取りを計量した後ではなく、その前に、パーティションキーとソートキーが絞り込みを行います。

KeyConditionExpression: PK = :tenant AND begins_with(SK, :day)

フィルタリング戦略 では、読み取りを絞り込む4つの方法と、それぞれのコストを比較しています。

PartiQL も救ってはくれない

SELECT * FROM ProductEvents WHERE eventType = 'login_failed' にはパーティションキーの条件がないので、まっすぐフル Scan にコンパイルされます。SQL の衣をまとった同じコストです。問題は * ではなく、キーがないことです。

AWS のルールでは、PartiQL の SELECT がフルテーブルスキャンを避けられるのは、その WHERE がパーティションキーを = または IN で固定しているときだけです(AWS: PartiQL の select)。ステートメントにキーを書き込みましょう。

SELECT * FROM "ProductEvents"
WHERE PK = 'TENANT#acme' AND begins_with(SK, 'TS#2026-06-23')

うっかり書いた PartiQL のフルスキャンを失敗させるには、IAM で拒否します(dynamodb:Scan の許可は別なので、スキャンすべきでないロールには付けないでください)。dynamodb:FullTableScan 条件キーは、テーブル全体をスキャンすることになる PartiQL の SELECT で true になります(AWS: PartiQL を使った IAM ポリシー)。

{
  "Effect": "Deny",
  "Action": ["dynamodb:PartiQLSelect"],
  "Resource": [
    "arn:aws:dynamodb:us-east-1:123456789012:table/ProductEvents",
    "arn:aws:dynamodb:us-east-1:123456789012:table/ProductEvents/index/*"
  ],
  "Condition": {"Bool": {"dynamodb:FullTableScan": ["true"]}}
}

キー付きの SELECT は引き続きロールの Allow のもとで実行され、失敗するのはフルスキャンだけです。

DynamoDB が表現できない GROUP BY、JOIN、集計には、DynoTable の SQL Workbench が手元のマシンで結果を計算します。

ベーステーブルにパーティションキーの条件を与えれば Query で読み取ります。条件がなければそのテーブルをやはり Scan し、どちらになるかは実行前にステータスバーに表示されます。

次のステップ

料金計算ツール でどちらのパターンにいくらかかるかを見積もり、 API レベルの対比については Query 対 Scan を読み、そして DynoTable をダウンロード して、これらを自分自身のテーブルに対して実行し、各アプローチが実際に何件のアイテムを読み取るかを確かめましょう。

著者: Dmitriy · 更新日