DDIA Transactions and Consistency
A reference skill covering the safety properties of single-node transactions (chapter 8) and the additional difficulties that distributed systems impose on those properties (chapters 9-10). Organized into 9 categories that can be loaded individually as needed.
Quick Start
- Open
guidelines.mdto find which files match your task or symptom - Load only the listed files — most tasks need 1-3 reference files
- For a multi-step process (e.g., picking an isolation level), check
workflows/instead
Contents
References
| Category | Files | Purpose |
|---|---|---|
acid-fundamentals/ |
knowledge, rules, examples | What ACID actually means; transaction model basics |
isolation-levels/ |
knowledge, rules, examples | Read committed, snapshot isolation, lost updates, write skew |
serializability/ |
knowledge, rules, examples | Serial execution, 2PL, SSI |
distributed-transactions/ |
knowledge, rules, examples | 2PC, XA, atomic commit across nodes |
distributed-failures/ |
knowledge, rules, examples | Partial failure, network partitions, faults |
distributed-time/ |
knowledge, rules, examples | Wall vs monotonic clocks, NTP, process pauses |
distributed-truth/ |
knowledge, rules, examples | Quorums, leases, fencing tokens, system models |
linearizability/ |
knowledge, rules, examples | Strong consistency, CAP, logical clocks |
consensus/ |
knowledge, rules, examples | Paxos/Raft, ZooKeeper, etcd, leader election |
Workflows
| Task | Workflow |
|---|---|
| Choose database isolation level (read committed, snapshot, serializable) | workflows/choosing-isolation-level.md |
| Diagnose a distributed bug (lost write, stale read, race condition) | workflows/diagnosing-distributed-bug.md |
| Design a fault-tolerant distributed system | workflows/designing-fault-tolerant-system.md |
| Choose consensus / coordination tool (ZooKeeper, etcd, Consul) | workflows/choosing-consensus-tool.md |
Guidelines
See guidelines.md for:
- Task-based file selection (transaction design, concurrency bugs, distributed coordination, failure modes)
- Symptom/question lookup ("two updates raced and one was lost", "clock skew causing weird ordering", etc.)
- Topic index across all 9 categories
- Decision trees for isolation level, consensus tool, and distributed lock design
- Complete file index (27 reference files)