テーマ別の解説テーマ:AWSのDB:設計・比較・接続調査
DynamoDB入門:キー・Query・読取り整合性を具体例で理解
DynamoDBは、キーと必要なアクセス方法を先に考えてデータを設計する、マネージドなNoSQLデータベースです。 注文を顧客別・日付順に読む例で、主キー、Query、絞り込み、索引と最新性を区別します。SQL Serverのテーブルをそのまま移す説明ではありません。
必要な読取りからキーを選び、Queryの対象と返却結果、索引と整合性の違いを説明できる。
テーブル・行・主キーの考え方を知っている方向けです。架空の4注文を紙上で読みます。AWSアカウントや実データの入力は不要です。
まず、テーブル・項目・キーを分ける
DynamoDBの項目(item)は1件のデータ、属性(attribute)は項目の中の値です。この教材のテーブルでは、パーティションキーとソートキーを組み合わせて1項目を識別します。キー以外の属性を項目ごとに変えられても、業務のデータ形式や更新の整合性まで設計不要になるわけではありません。
| 用語 | 例 | 役割 |
|---|---|---|
| パーティションキー(PK) | CUSTOMER#101 | 同じ顧客の注文をまとめて探すための値 |
| ソートキー(SK) | 20261001#41 | 同じPKの中で注文を区別し、日付順の範囲を指定 |
| その他の属性 | status=PAID、points=1200 | 返したいデータ。これだけで主テーブルのQuery対象にはならない |
保存する前に、何をどう読むかを決める
| 画面で必要なこと | 今回のキーでの考え方 |
|---|---|
| 顧客101の10月の注文一覧 | PKをCUSTOMER#101に固定し、SKの日付範囲でQuery |
| 注文41を特定して取得 | PKと完全なSKを指定してGetItem(1項目の取得) |
| 全顧客のPAID注文を日付順に読む | 主テーブルのPKが顧客別なので、この要求用の索引や別の設計を検討 |
| 注文を確定した直後に自分で読む | どの読取り先と整合性設定なら最新性の要件を満たすか確認 |
SQLのJOINや任意条件の検索を、同じ操作として持ち込めると考えないでください。必要なデータをまとめて持つ設計では、変更時に複数のコピーをどう保つかも課題です。逆に、DynamoDBにトランザクションがない、という説明も誤りです。データの関係・更新単位・読み方を一緒に判断します。
例D1:4注文から、顧客と日付で対象を絞る
以下は架空の注文です。pointsは説明用の値で、AWS料金や処理性能ではありません。SKの日付は桁数をそろえた文字列とし、同じPKの中で日付順に並べられる形にしています。
| 注文 | PK | SK | status | points |
|---|---|---|---|---|
| 41 | CUSTOMER#101 | 20261001#41 | PAID | 1200 |
| 42 | CUSTOMER#101 | 20261002#42 | PENDING | 800 |
| 43 | CUSTOMER#101 | 20261003#43 | PAID | 600 |
| 44 | CUSTOMER#202 | 20261001#44 | PAID | 400 |
- 顧客101+10月1〜3日 → 対象は41・42・43キー条件で読む範囲
- 対象は41・42・43 → PAIDは41・43読んだ後に絞り込み
- 顧客101+10月1〜3日
- PKとSKの条件を指定。
- 対象は41・42・43
- 44は別顧客なので対象外。
- PAIDは41・43
- statusのフィルターで42を除く。
この主テーブルのQuery(キー条件で項目をまとめて読む操作)では、PKの1つの値を指定し、必要ならSK条件で範囲を絞ります。D1は注文41・42・43がキー条件に合い、PAIDで絞ると41・43を返します。返却するpointsの合計は1200+600=1800です。別顧客の44まで合計しません。
フィルターとページ送りは、キー条件の代わりにならない
| ページ | キー条件で評価する項目 | PAIDで返す項目 | 続き |
|---|---|---|---|
| 1 | 注文42(PENDING) | 0件 | 続きのキーがあるため終了しない |
| 2 | 注文43(PAID) | 注文43 | この応答にも続きのキーがあるとする |
| 3 | 該当する項目なし | 0件 | 続きのキーなし。ここで終了 |
D2は説明のため1件ずつ評価し、2ページ目にも続きのキーがある応答を与えています。これはAWSのページ上限や、常に3ページになるという保証ではありません。実際の応答にLastEvaluatedKeyがあれば、そのキーを使って続きを要求します。フィルターで0件になったページだけを見て「該当なし」と結論しません。続きのキーがあることも、後に必ず一致データがあるという意味ではありません。
別の探し方と、最新性を分けて設計する
グローバルセカンダリインデックス(GSI)は、主テーブルとは別のキーで探すための索引です。全顧客のPAID注文という要求では、状態や日付を使う別の読取り設計を検討します。ただし、PAIDのような少数の値へアクセスが集中しないか、索引に持つ属性、書込みと保存の費用も確認します。GSIを追加すれば、あらゆる検索が自動で速くなるわけではありません。
| 読取り先 | 確認すること |
|---|---|
| 主テーブル | デフォルトの結果整合性と、対応する操作の強い整合性を要件に応じて選ぶ |
| ローカルセカンダリインデックス(LSI) | 強い整合性に対応。GSIと名前だけで同一視しない |
| GSI | 結果整合性。主テーブルの更新直後に必ず同じ値を読めるとは限らない |
小さな例から、本番で必要な判断を広げる
- 必要な読取り・書込み・最新性を、画面や処理ごとに列挙する。
- PK/SKと索引を、そのアクセス方法に対応させる。
- 属性の重複や複数項目の更新をどう整合させるか決める。
- アクセスの偏り、項目サイズ、容量方式、保存・索引・転送の費用を見積もる。
- IAMの操作権限とデータ単位の制御、復旧方法、業務結果の検査を決める。
この例は性能や費用の実測ではなく、キーと結果の読み方の練習です。SQL Serverの置換を製品名だけで決めず、RDSとの比較教材で既存SQL・データの関係・新しいアクセス設計の費用も確認してください。
キーとQueryの結果を確かめる
選択すると、正誤と理由が表示されます。
確認して、自分の言葉で説明する
- PK/SKと、キー以外の属性を区別する。
- D1の候補3件と返却2件を説明する。
- 空ページでも続きを確認する理由を説明する。
- GSIのアクセス方法と結果整合性を説明する。
理解を確かめる: 全顧客のPAID注文を一覧にしたい。主テーブルを毎回Scan(全体の読取り)してフィルターすれば、設計は終わり?
いいえ。データ量と頻度、必要な順序・最新性を確認し、索引や別のアクセス設計を検討します。少数の状態値への集中、索引への反映遅れ、保存/更新コストも含めます。Scanで読めることと、要件を満たす設計であることは別です。
データを取得できる方法でも、必要な頻度・規模・最新性と更新の要件に照らして評価します。
出典と確認した条件
説明に用いた公式資料を、確認した内容・条件と本文の参照箇所に分けてまとめています。専門家による監修・実際のAWSとの比較検証は行っていません。
確認した内容・条件項目・属性・主キー。教材の例は主テーブルの単一属性PK/SKであり全索引形式の説明ではない。
確認した内容・条件キー条件後のFilterExpression、評価と返却の違い、空ページとLastEvaluatedKey。
参照した本文保存する前に、何をどう読むかを決める 例D1:4注文から、顧客と日付で対象を絞る フィルターとページ送りは、キー条件の代わりにならない
確認した内容・条件GetItem/Query/Scanの異なる対象と、対応する更新操作。
参照した本文保存する前に、何をどう読むかを決める
確認した内容・条件異なるキーによるアクセスと索引の反映。費用・属性・アクセス集中も設計に含める。
参照した本文保存する前に、何をどう読むかを決める 別の探し方と、最新性を分けて設計する 小さな例から、本番で必要な判断を広げる
確認した内容・条件アクセス方法と権限の違い。既存SQLやJOINの無変更移行を保証しない。
確認した内容・条件DynamoDBにもトランザクションがある。原子性と別の読取りの最新性を区別する。
確認した内容・条件LastEvaluatedKeyが空になるまで継続。キーの存在自体は次の一致データの存在を保証しない。
確認した内容・条件主テーブル/LSIの強い整合性とGSIの結果整合性。Global tablesの全モードへ一般化しない。
参照した本文別の探し方と、最新性を分けて設計する