中級読了 4 分

変化する (可変な) 属性で DynamoDB をソートする

ある属性をソートキーに入れて、その順序でアイテムをクエリできるようにする。ところがその属性が変わってしまう。チケットのステータス、タスクの優先度、デプロイの状態。

DynamoDB はキー属性をその場で編集させてくれません。キーの値を変えるとアイテムは新しいアドレスへ移動することになり、その移動は自分で行う必要があります。

DynamoDB のソートキーは変更できますか?

いいえ。UpdateItem はパーティションキーやソートキーの値の変更をすべて拒否し、DynamoDB には「アイテムを移動する」操作がありません。

古いアイテムを削除して新しいアイテムを put するか、変わりやすい値を GSI のソートキーに持たせるかのどちらかです。GSI のソートキーなら UpdateItem で変更できます。

  • トランザクション内での削除 + put: 値がベーステーブルのキーに存在しなければならない場合。 1 KB のアイテムで、変更 1 回あたり約 4 書き込みユニットです。
  • GSI のソートキー: 値が頻繁に変わる場合。属性と GSI キーを一緒に設定する 1 回の UpdateItem で約 3 書き込みユニット。インデックスは非同期に追いつきます。
  • 不変のベースキー (チケット id、作成タイムスタンプ): アクセスパターンが許す限り。

問題:ソートに使うステータスが変わり続ける

サポートデスクを運営していて、チームのチケットをステータス順に一覧したいとします。そこでステータスをソートキーに入れます。

PK: TEAM#7   SK: STATUS#open#TICKET#8842

さて、チケットが pending に移ります。SK を STATUS#pending#TICKET#8842 に設定する UpdateItem は、ValidationException で失敗します: "Cannot update attribute SK. This attribute is part of the key"。

新しいキーでの PutItem は成功しますが、2 つ目のアイテムができてしまいます。open のコピーは残ったままで、チームにはチケットが 2 回表示されます。

選択肢1:トランザクション内で削除して作り直す

その値がベーステーブルのキーに存在しなければならないなら、変更するには古いアイテムを取り除いて新しいものを書きます。

1. DeleteItem  PK=TEAM#7  SK=STATUS#open#TICKET#8842
2. PutItem     PK=TEAM#7  SK=STATUS#pending#TICKET#8842  (same attributes)

両方を 1 つの TransactWriteItems で送り、両方成功するか両方失敗するようにします。ガードのない 2 回の呼び出しにすると、その間でクラッシュしたときにチケットが失われたり重複したりします。

トランザクションはすべてのアイテムを 2 回書き込む (prepare、そして commit) ので、1 KB のチケットは変更 1 回あたり約 4 書き込みユニットかかります。削除に 2、put に 2 です。アイテムが現れる GSI があれば、それぞれがさらに独自の削除と put を加えます。

たまの変更なら問題ありませんが、一日中動き続ける値には高くつきます。

多数のアイテムのキーを付け替える

同じ移動は一括でも使えます。例えばキーの形式や、ゼロ埋めした数値の桁幅を変えるときです。

Query (テーブル全体なら並列スキャン) でコレクションをページングし、アイテムごとに 1 つの TransactWriteItems を送ります。

  • 新しいキーでのアイテムの Put。ConditionExpression: attribute_not_exists(PK) を付けて、再実行時にすでに移動済みのアイテムを上書きしないようにします。
  • 古いキーの Delete。

処理が終わるまで、読み手には古いキーと新しいキーが混在して見えるので、クエリを新しい形式に切り替えるのは完了後にしましょう。

選択肢2:変わる値をベースキーから外す (推奨)

ベーステーブルのキーを不変なもの (チケット id) にし、ソート可能な値を GSI のソートキーに置きましょう。GSI1PK と GSI1SK はベースアイテム上の普通の属性で、GSI1 がそれらをキーとして使います。

Base:  PK: TICKET#8842   status: "open"   teamId: TEAM#7
GSI:   GSI1PK: TEAM#7    GSI1SK: STATUS#open#TICKET#8842

GSI1SK はステータスを文字列に焼き込んだコピーなので、status だけを更新するとチケットはインデックス内の古い位置に残ります。両方を同じ UpdateItem で設定しましょう。どちらもベーステーブルのキーではないので、DynamoDB はこれを許します。

await client.send(
  new UpdateItemCommand({
    TableName: 'Tickets',
    Key: {PK: {S: 'TICKET#8842'}},
    UpdateExpression: 'SET #status = :s, GSI1SK = :sk',
    ExpressionAttributeNames: {'#status': 'status'},
    ExpressionAttributeValues: {
      ':s': {S: 'pending'},
      ':sk': {S: 'STATUS#pending#TICKET#8842'}
    }
  })
);

ベースへの書き込みはアトミックです。その後 DynamoDB が、インデックスのエントリを非同期に移動してくれます。古い GSI エントリを削除して新しいものを put するので、呼び出しが返った後も少しの間、インデックスには古い位置が表示されることがあります。

はいいいえ、GSI のソートキーステータスが open から pendingに変化その値はベーステーブルのキー?トランザクション内で削除して再作成UpdateItem で status と GSI1SKを設定

各選択肢のコスト

1 KB のチケットの書き込みユニット (オンデマンドでは書き込みリクエストユニット、プロビジョンドでは書き込みキャパシティユニット):

パターンAPI 呼び出し変更 1 回あたりの書き込みユニット
ベースキー上のトランザクション削除 + putTransactWriteItems (2 ops)約 4 (2 アイテム × prepare と commit の 2)
status + GSI1SK の UpdateItem (GSI 経路)1 回の UpdateItem約 3 (ベース書き込み + GSI 削除 + GSI put)

ガードのない 2 回の呼び出しと違い、どちらの経路にもクラッシュで行が失われる窓はありません。 GSI 経路はトランザクションではなく 1 回の呼び出しで済み、その代償はインデックス読み取りの結果整合性です。

ステータス変更が毎分何度も発生するなら、料金計算機 でそのレートをモデルしてください。

open チケットのキュー向けのスパース GSI

open のチケットだけがステータス順のキューを必要とするなら、スパースインデックスにしましょう。チケットが open の間だけ GSI1PK = TEAM#7 と GSI1SK = STATUS#open#... を設定します。

クローズしたら、同じ UpdateItem で REMOVE GSI1PK, GSI1SK すれば、アイテムはインデックスから外れます。一覧しないクローズ済みチケットには、インデックスのストレージも書き込みもかかりません。

優先すべき不変のベースキー

変動フィールドベーステーブル SKより良いベース SK変動フィールドの置き場所
デプロイステータスSTATUS#failed#DEPLOY#99DEPLOY#99GSI ソートまたは属性
タスク優先度P#1#TASK#12TASK#12GSI ソート
ユーザー表示名NAME#alice#USER#5USER#5非キー属性

タイムスタンプと不変 id(CREATED#2026-06-27T10:00:00Z、TICKET#8842)は、ベーステーブル自体で時系列順が必要なときの安定したベースソートキーになります。

選び方の詳細はソートキー戦略にあります。

落とし穴

  • キー属性を UpdateItem しない。 拒否されます。トランザクション内の削除 + put でアイテムを移動するか、値を GSI に置きましょう。
  • ガードのない 2 回の書き込みでアイテムを移動しない。 その間でクラッシュすると、アイテムが失われるか重複します。
  • 元の属性だけでなく GSI キーも更新する。 複合の GSI1SK は、status に自動では追従しません。
  • 自分の書き込みはベーステーブルから読む。 UpdateItem の後、チケット id での強い整合性の GetItem は新しいステータスをすぐに示します。GSI へのクエリは少し遅れることがあるので、ステータス順のキューへリダイレクトする UI は、正確な状態が必要なときは id で取り直しましょう。 GSI は ConsistentRead を拒否します。

コーディング前にキーを設計する

ベースの読み取りと GSI の読み取りのキー条件を式ビルダーで組み立て、続いて結合テスト用にクエリビルダーでページ付きクエリを出力しましょう。

DynoTable ではクエリをどのインデックス経由で実行するかを選べるので、GSI の読み取りとベーステーブルの読み取りを 2 つのタブで開き、ベースアイテムが不変のキーを保ったまま、インデックス上でステータスがソートされる様子を見られます。

DynoTable で、ベースアイテムが不変のキーを保ったまま、ステータスでソートした GSI をクエリしている様子。
DynoTable で、ベースアイテムが不変のキーを保ったまま、ステータスでソートした GSI をクエリしている様子。

関連: GSI と LSI、トランザクション。 DynoTable をダウンロードして、自分のインデックスをこの方法で探索しましょう。

著者: Dmitriy · 更新日