scalardb-transaction

스타6

포크0

업데이트2026년 2월 18일 19:08

ScalarDBのトランザクション設計を行います。トランザクション境界定義、パターン選定（単一集約内/2PC/Saga/ハイブリッド）、OCC競合率評価、バッチ処理設計、v3.17最適化適用計画を含みます。ワークフローStep 05（トランザクション設計）で使用します。

설치

Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.

출처

wfukatsu

wfukatsu/coding-agent-for-scalardb

GitHub 저장소 열기 Creator 저장소 보기

다운로드

ScalarDB Transaction Design Skill

目的

ScalarDB のトランザクションパターンを選定・設計し、以下を生成する:

トランザクション境界定義
パターン選定結果と根拠
OCC競合率評価
バッチ処理設計
v3.17 最適化適用計画
エラーハンドリング・リトライ戦略

リファレンス資料

資料	パス	参照内容
トランザクションモデル	`research/07_transaction_model.md`	7つのトランザクションパターン
バッチ処理	`research/09_batch_processing.md`	バッチ有効/無効ケース、チャンクサイズ
ScalarDB 3.17	`research/13_scalardb_317_deep_dive.md`	最適化機能の詳細
ワークフロー05	`workflow/05_transaction_design.md`	Step 05 手順

実行フロー

Stage 1: トランザクション境界の定義

Step 04（データモデル）の結果を基に、各ビジネスプロセスのトランザクション境界を定義する。

トランザクション境界テンプレート:

トランザクション名	ビジネスプロセス	関与集約	関与テーブル	操作種別
				Read/Write/ReadWrite

Stage 2: トランザクションパターン選定

各トランザクションに対してパターンを選定:

パターン	適用条件	ScalarDB API
単一集約内	1サービス・1テーブル	`DistributedTransaction`
単一サービス複数テーブル	1サービス・複数テーブル	`DistributedTransaction`
2PC（2サービス）	2サービス間ACID	`TwoPhaseCommitTransaction`
2PC（3サービス）	3サービス間ACID（上限）	`TwoPhaseCommitTransaction`
Saga	結果整合性で十分	アプリケーション実装
Saga + 部分2PC	一部ACIDが必要	ハイブリッド

パターン選定マトリクス:

トランザクション名	選定パターン	根拠	リスク

Stage 3: OCC 競合率評価

楽観的並行性制御（OCC）の競合率を評価し、対策を検討する。

競合率評価テンプレート:

トランザクション	対象レコード	同時実行数	推定競合率	許容範囲	対策
				< 5%

競合率が高い場合の対策:

Partition Key の見直し（アクセス分散）
トランザクション範囲の縮小
リトライ戦略の調整
ビジネスプロセスの再設計（Saga化検討）

Stage 4: バッチ処理設計

バッチ処理テンプレート:

バッチ名	処理内容	対象テーブル	予想レコード数	チャンクサイズ	トランザクション範囲
				100-1000推奨	チャンク単位

ScalarDB バッチ処理の制約:

長時間トランザクションは OCC 競合リスクが高い
チャンク単位でコミットする設計が必須
Batch Operations（v3.17）で複数操作を一括送信可能

Stage 5: v3.17 最適化適用計画

最適化機能	適用対象	効果	設定
Piggyback Begin	全トランザクション	ラウンドトリップ -1	有効化推奨
Write Buffering	書き込み多いTx	ネットワーク呼出削減	対象Txで有効化
Batch Operations	バッチ処理	スループット向上	バッチ処理で使用
Tx Metadata Decoupling	小レコードテーブル	ストレージ効率化	READレイテンシ影響を評価

Stage 6: エラーハンドリング・リトライ戦略

エラーハンドリングテンプレート:

例外	原因	対応	リトライ
`CrudConflictException`	OCC競合	リトライ	Yes（指数バックオフ）
`CommitConflictException`	コミット時競合	リトライ	Yes（指数バックオフ）
`UnknownTransactionStatusException`	状態不明	確認→リトライ or 補償	条件付き
`CommitException`	コミット失敗	abort→リトライ	Yes
`UnsatisfiedConditionException`	条件未達	ビジネスロジック判断	No

リトライ設定テンプレート:

パラメータ	推奨値	説明
最大リトライ回数	3-5	過度なリトライは避ける
初回待機時間	100ms	指数バックオフの起点
最大待機時間	5000ms	上限
バックオフ係数	2.0	倍増
ジッター	±50ms	同時リトライの分散

Stage 7: 出力

成果物を output/phase2/05_transaction_design.md に出力。

使用例

/plan-step 05

Step 04 のデータモデルに基づいてトランザクション設計を行ってください。
特に以下のプロセスの設計を重視:
- 注文確定（注文 + 在庫 + 決済の3サービス跨ぎ）
- ポイント付与（結果整合性で可）
- 月次バッチ集計

이 저장소의 다른 Skills

같은 저장소

api-design

wfukatsu/coding-agent-for-scalardb

RESTful API の設計を行います。エンドポイント定義、リクエスト/レスポンス仕様、エラーハンドリング、ScalarDBトランザクション例外のマッピングを含みます。

2026-02-186

database-design

wfukatsu/coding-agent-for-scalardb

ScalarDBを前提としたデータベース設計を行います。スキーマ設計、トランザクション設計、マルチストレージ構成を対話形式で決定し、スキーマファイルと設計書を生成します。

2026-02-186

domain-modeling

wfukatsu/coding-agent-for-scalardb

DDDに基づいたドメインモデルを設計します。戦略的設計（境界コンテキスト、ユビキタス言語）と戦術的設計（エンティティ、値オブジェクト、集約、ドメインサービス、ドメインイベント）を定義し、ヘキサゴナルアーキテクチャとの統合を行います。ScalarDBのトランザクション境界や管理テーブル分類の考慮事項を含みます。中間状態はresearch/に記録されます。

2026-02-186

implementation-plan

wfukatsu/coding-agent-for-scalardb

設計ドキュメントに基づいて実装計画を生成します。ScalarDB特有のスキーマ定義、トランザクション実装、統合テストを含む実装可能なタスク指示書を作成し、フェーズ別の実装ロードマップを提供します。

2026-02-186

infrastructure-design

wfukatsu/coding-agent-for-scalardb

Kubernetes、Kong API Gateway、ScalarDB Cluster v3.17を使用したインフラストラクチャ設計を行います。マニフェストファイルと設定ファイルを生成します。

2026-02-186

scalardb-data-model

wfukatsu/coding-agent-for-scalardb

ScalarDBの制約を考慮したデータモデル設計を行います。Partition Key・Clustering Key・Secondary Index の設計、ホットスポット評価、メタデータオーバーヘッド見積もり、バックエンドDB選定を含みます。ワークフローStep 04（データモデル設計）で使用します。

2026-02-186

name	scalardb-transaction
description	ScalarDBのトランザクション設計を行います。トランザクション境界定義、パターン選定（単一集約内/2PC/Saga/ハイブリッド）、OCC競合率評価、バッチ処理設計、v3.17最適化適用計画を含みます。ワークフローStep 05（トランザクション設計）で使用します。

ScalarDB Transaction Design Skill

目的

ScalarDB のトランザクションパターンを選定・設計し、以下を生成する:

トランザクション境界定義
パターン選定結果と根拠
OCC競合率評価
バッチ処理設計
v3.17 最適化適用計画
エラーハンドリング・リトライ戦略

リファレンス資料

資料	パス	参照内容
トランザクションモデル	`research/07_transaction_model.md`	7つのトランザクションパターン
バッチ処理	`research/09_batch_processing.md`	バッチ有効/無効ケース、チャンクサイズ
ScalarDB 3.17	`research/13_scalardb_317_deep_dive.md`	最適化機能の詳細
ワークフロー05	`workflow/05_transaction_design.md`	Step 05 手順

実行フロー

Stage 1: トランザクション境界の定義

Step 04（データモデル）の結果を基に、各ビジネスプロセスのトランザクション境界を定義する。

トランザクション境界テンプレート:

トランザクション名	ビジネスプロセス	関与集約	関与テーブル	操作種別
				Read/Write/ReadWrite

Stage 2: トランザクションパターン選定

各トランザクションに対してパターンを選定:

パターン	適用条件	ScalarDB API
単一集約内	1サービス・1テーブル	`DistributedTransaction`
単一サービス複数テーブル	1サービス・複数テーブル	`DistributedTransaction`
2PC（2サービス）	2サービス間ACID	`TwoPhaseCommitTransaction`
2PC（3サービス）	3サービス間ACID（上限）	`TwoPhaseCommitTransaction`
Saga	結果整合性で十分	アプリケーション実装
Saga + 部分2PC	一部ACIDが必要	ハイブリッド

パターン選定マトリクス:

トランザクション名	選定パターン	根拠	リスク

Stage 3: OCC 競合率評価

楽観的並行性制御（OCC）の競合率を評価し、対策を検討する。

競合率評価テンプレート:

トランザクション	対象レコード	同時実行数	推定競合率	許容範囲	対策
				< 5%

競合率が高い場合の対策:

Partition Key の見直し（アクセス分散）
トランザクション範囲の縮小
リトライ戦略の調整
ビジネスプロセスの再設計（Saga化検討）

Stage 4: バッチ処理設計

バッチ処理テンプレート:

バッチ名	処理内容	対象テーブル	予想レコード数	チャンクサイズ	トランザクション範囲
				100-1000推奨	チャンク単位

ScalarDB バッチ処理の制約:

長時間トランザクションは OCC 競合リスクが高い
チャンク単位でコミットする設計が必須
Batch Operations（v3.17）で複数操作を一括送信可能

Stage 5: v3.17 最適化適用計画

最適化機能	適用対象	効果	設定
Piggyback Begin	全トランザクション	ラウンドトリップ -1	有効化推奨
Write Buffering	書き込み多いTx	ネットワーク呼出削減	対象Txで有効化
Batch Operations	バッチ処理	スループット向上	バッチ処理で使用
Tx Metadata Decoupling	小レコードテーブル	ストレージ効率化	READレイテンシ影響を評価

Stage 6: エラーハンドリング・リトライ戦略

エラーハンドリングテンプレート:

例外	原因	対応	リトライ
`CrudConflictException`	OCC競合	リトライ	Yes（指数バックオフ）
`CommitConflictException`	コミット時競合	リトライ	Yes（指数バックオフ）
`UnknownTransactionStatusException`	状態不明	確認→リトライ or 補償	条件付き
`CommitException`	コミット失敗	abort→リトライ	Yes
`UnsatisfiedConditionException`	条件未達	ビジネスロジック判断	No

リトライ設定テンプレート:

パラメータ	推奨値	説明
最大リトライ回数	3-5	過度なリトライは避ける
初回待機時間	100ms	指数バックオフの起点
最大待機時間	5000ms	上限
バックオフ係数	2.0	倍増
ジッター	±50ms	同時リトライの分散

Stage 7: 出力

成果物を output/phase2/05_transaction_design.md に出力。

使用例

/plan-step 05

Step 04 のデータモデルに基づいてトランザクション設計を行ってください。
特に以下のプロセスの設計を重視:
- 注文確定（注文 + 在庫 + 決済の3サービス跨ぎ）
- ポイント付与（結果整合性で可）
- 月次バッチ集計