初級読了 3 分

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 は方向ではなく、読み取ったアイテムのサイズで課金します。

true(既定)falseQuery GAME#42ScanIndexForward?古いスコアが先新しいスコアが先

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 DESC

DynamoDB は 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 でクエリタブを降順 (新しい順) に切り替えている様子。
DynoTable でクエリタブを降順 (新しい順) に切り替えている様子。

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

著者: Dmitriy · 更新日