データベース・ 2026-05-06

DynamoDB パーティションキー設計の鉄則とホットパーティション対策

パーティションキー（PK）は DynamoDB のアイテムを物理パーティションに振り分けるキー。均等な分散が性能の鍵で、特定 PK にアクセスが集中（ホットパーティション）すると性能が大幅劣化する。SK（ソートキー）と組み合わせる「複合キー」設計も重要。 ---

DynamoDB のテーブルを物理分散する基準キー。設計次第で性能が天と地ほど変わる重要要素。

1. 概要（端的に）

パーティションキー（PK）は DynamoDB のアイテムを物理パーティションに振り分けるキー。均等な分散 が性能の鍵で、特定 PK にアクセスが集中（ホットパーティション）すると性能が大幅劣化する。SK（ソートキー）と組み合わせる「複合キー」設計も重要。

タイプ	構成	例
シンプル PK	PK のみ	UserId
複合キー	PK + SK	UserId（PK）+ Timestamp（SK）

悪い例：PK = "Date"（同日のアクセスが 1 パーティションに集中）
  → 1 日のアクセス全てが 1 パーティションに → 性能制限

良い例：PK = "UserId"（ユーザー単位で分散）
  → アクセスが多数パーティションに分散

DynamoDB は PK のハッシュ値からパーティションを決定する。1 パーティションあたり最大 3,000 RCU / 1,000 WCU / 10 GB の制限がある。

PK ハッシュ → 0x000... 〜 0xfff... の範囲
  ├ パーティション 1（0x000-0x3ff）
  ├ パーティション 2（0x400-0x7ff）
  ├ パーティション 3（0x800-0xbff）
  └ パーティション 4（0xc00-0xfff）

操作	コスト	用途
Query（PK 指定）	低	特定アイテム取得（推奨）
Scan（全スキャン）	超高	テーブル全件参照（本番非推奨）

PK = UserId、SK = Timestamp → ユーザー X の最新 10 件を高速取得。

PK = EventType + Date（パーティション分散）、SK = Timestamp。

PK = CategoryId、SK = ProductId → カテゴリ別商品リスト。

PK = RoomId、SK = MessageId → ルーム別メッセージ履歴。