DynamoDB を降順にクエリする方法
DynamoDB の Query はアイテムを昇順のソートキー順で返します。たいていの「最新を見せて」という画面はその逆を望み、切り替えはリクエスト上の 1 つのブール値、ScanIndexForward です。
その名前は実際の動作とは逆向きに読め、事後に結果をソートするものと取り違えやすいのですが、 DynamoDB がそれをすることはありません。
DynamoDB を降順にクエリするにはどうしますか?
Query に ScanIndexForward=false を設定します。DynamoDB はパーティションを最も高いソートキーから下へ歩くので、タイムスタンプのソートキーなら新しい順になります。
どのアイテムが一致するかは引き続きキー条件が決めます。Limit を付けると、どちらの端を得るかも方向が決めます (古い N 件ではなく最新の N 件)。逆向きの読み取りは順方向と同じコストです。
ScanIndexForward=true(デフォルト): 昇順のソートキー順。ScanIndexForward=false: 降順。時系列のキーなら新しい順。Limitを追加して、「最新の N 件」を 1 回の小さな読み取りで得ましょう。- PartiQL では、
WHEREにパーティションキーを入れてORDER BY <sort key> DESCと書きます。
問題:「最新を先に見せて」
マルチプレイヤーゲームを運営していて、あるゲームのスコアイベントを 1 つのパーティションキーの下に、増加するタイムスタンプでソートして格納しているとします。
PK: GAME#42 SK: SCORE#2026-06-27T10:00:00Z points
PK: GAME#42 SK: SCORE#2026-06-27T10:05:00Z points
PK: GAME#42 SK: SCORE#2026-06-27T10:09:00Z points
ダッシュボードのスコアフィードは最新のイベントを必要としますが、GAME#42 への素の Query
はそれらを古い順に返します。アプリで反転するにはすべてを読む必要があり、Limit を追加した瞬間に壊れます。
ScanIndexForward の仕組み
パーティション内のアイテムはソートキーで順序付けて格納されます。Query はその順序を歩き、
ScanIndexForward は歩く方向を選びます。
true(デフォルト): 最も低いソートキーから始めて、上へ歩く。false: 最も高いソートキーから始めて、下へ歩く。
これは読み取りの性質であって、テーブルの性質ではありません。同じアイテム、同じキー条件で、逆向きにするだけです。
Query API リファレンスにあるとおり、DynamoDB は方向ではなく、読み取ったアイテムのサイズで課金します。
Limit=10 と組み合わせれば、最新の 10 件のイベントが得られます。2 KB のアイテム 10 件は 20 KB、つまり 4 KB のブロック 5 つなので、読み取りコストは順方向でも逆方向でも、結果整合性で
2.5 RCU (強い整合性で 5) です。
10,000 件のイベントを持つパーティション (約 20 MB) をコードで反転するために読むと、同じウィジェットのために約 2,500 RCU (結果整合性) かかります。
Limit が数えるのは評価されたアイテムであって、フィルター後に返るアイテムではありません。それが短いページにどう影響するかはページネーションのガイドで扱っています。
「降順」がキーの型ごとに意味すること
降順は「最新」というこちらの考えではなく、ソートキーの型のルールに従います。
| ソートキーの保存形式 | 降順で得られるもの | 落とし穴 |
|---|---|---|
ISO-8601 の UTC 文字列 2026-06-27T10:09:00Z | 最も新しいタイムスタンプが先頭 | すべての値で精度と Z オフセットを揃える必要がある: …:00.5Z は …:00Z より前に並ぶ |
ゼロ埋めした数値文字列 00000000001009 | 最も大きい数値が先頭 | ゼロ埋めしない数値は誤って並ぶ("9" > "10")。ゼロ埋めを参照 |
Number 型 N | 最も大きい数値が先頭 | 文字列順ではなく数値順 |
ステータス接頭辞 STATUS#open#... | SK 全体に対する逆辞書順 | 接尾辞に時刻を符号化していない限り、「最近開いた順」ではない |
「最新」がソートキー以外の何か、たとえばゲーム内での points 順を意味するなら、その指標はソートキーの中に必要で、通常は GSI に置きます。
アプリケーションコードでのクエリ後のソートは、たまたま読んだページしかソートしません。
降順のクエリをページングする
各ページの LastEvaluatedKey を次のリクエストの ExclusiveStartKey として渡し、すべてのページで同じ ScanIndexForward=false を送ります。
ページの間でフラグを反転すると、カーソルは逆方向へ戻って歩くので、すでに表示した行が返ってきます。
トークンの形式や「もっと読み込む」API についてはページネーションを参照してください。
PartiQL での降順
PartiQL には ScanIndexForward がありません。順序はステートメントに書きます。
SELECT * FROM "Scores"
WHERE PK = 'GAME#42'
ORDER BY SK DESCDynamoDB は WHERE 句のない ORDER BY を拒否します。
PartiQL SELECT リファレンスにあるとおり、その WHERE でパーティションキーを = または IN で固定しないと、ステートメントはテーブルのフルスキャンとして実行されます。
降順を使うアクセスパターン
- アクティビティフィード:
SKは ISO のタイムスタンプ。降順とLimitで直近のウィンドウが得られます。 - 監査ログの末尾: 追記のみの
EVENT#<ts>ソートキー。GSI なしで、降順が最新のイベントを表示します。 - リーダーボード: 生のスコアはベーステーブルのソートキーにできません。1 つのゲームで同じスコアの 2 人のプレイヤーは PK + SK を共有し、2 つ目の書き込みが 1 つ目を置き換えてしまうからです。
scoreを GSI のソートキーに置くか (GSI のキーは一意である必要がありません)、ゼロ埋めしたスコアとタイブレーカーを文字列のキーに符号化しましょう。
UI が古い順も必要とする場合、同じクエリを ScanIndexForward=true で実行すれば対応できます。データの 2 つ目のコピーも 2 つ目のインデックスも要りません。
組み立てて試す
キー条件と、それに対応する属性名/値のマップは式ビルダーで組み立てましょう。
リクエスト全体 (インデックス、Limit、ScanIndexForward) については、クエリビルダーが実行可能な SDK v3、CLI、boto3、その他の言語のプログラムを出力します。
順方向と逆方向の読み取りのコストを比べるには、CLI で --return-consumed-capacity TOTAL
(SDK では ReturnConsumedCapacity: 'TOTAL') を追加しましょう。同じ Limit なら一致します。
DynoTable では、クエリタブにソートキーの昇順/降順のトグルがあるので、ScanIndexForward を自分で書かずに、パーティションを古い順と新しい順の間で切り替えられます。

関連: ソートキー戦略、ページネーション。DynoTable をダウンロードして、自分のテーブルで順序を反転させてみましょう。


