dimgigov
215df1cdf3
- Add Formal Verification section to README and architecture docs - Document TLA+ specs for Raft, 2PC, MVCC, Replication - Add new BaraQL features: JSON path (->, ->>), FTS @@, CREATE INDEX USING FTS, RECOVER TO TIMESTAMP, UNION/INTERSECT/EXCEPT - Add OpenTelemetry tracing example to README - Update Quick Start to use nimble test/bench - Update EN and BG documentation
57 lines
1.6 KiB
Markdown
57 lines
1.6 KiB
Markdown
# Разпределена Система
|
|
|
|
Поддръжка за разпределено внедряване с Raft консенсус, шардиране и репликация.
|
|
|
|
## Raft Консенсус
|
|
|
|
```nim
|
|
import barabadb/core/raft
|
|
|
|
var cluster = newRaftCluster()
|
|
cluster.addNode("node1")
|
|
cluster.addNode("node2")
|
|
cluster.addNode("node3")
|
|
|
|
let n1 = cluster.nodes["n1"]
|
|
n1.becomeLeader()
|
|
```
|
|
|
|
## Шардиране
|
|
|
|
```nim
|
|
import barabadb/core/sharding
|
|
|
|
var router = newShardRouter(ShardConfig(numShards: 4, replicas: 2))
|
|
router.rebalance(@["node1", "node2", "node3"])
|
|
let shard = router.getShard("user_123")
|
|
```
|
|
|
|
## Репликация
|
|
|
|
```nim
|
|
import barabadb/core/replication
|
|
|
|
var rm = newReplicationManager(rmSync)
|
|
rm.addReplica(newReplica("r1", "10.0.0.1", 9472))
|
|
rm.connectReplica("r1")
|
|
```
|
|
|
|
## Формална Верификация
|
|
|
|
Разпределените алгоритми са формално специфицирани в TLA+ и проверени с TLC:
|
|
|
|
- **Raft Консенсус** — `formal-verification/raft.tla`
|
|
- Проверено: ElectionSafety, StateMachineSafety
|
|
- **Two-Phase Commit** — `formal-verification/twopc.tla`
|
|
- Проверено: Atomicity, NoOrphanBlocks
|
|
- **Репликация** — `formal-verification/replication.tla`
|
|
- Проверено: MonotonicLsn, AcksRemovePending
|
|
|
|
Пускане на TLC:
|
|
|
|
```bash
|
|
cd formal-verification
|
|
java -cp tla2tools.jar tlc2.TLC -config models/raft.cfg raft.tla
|
|
java -cp tla2tools.jar tlc2.TLC -config models/twopc.cfg twopc.tla
|
|
java -cp tla2tools.jar tlc2.TLC -config models/replication.cfg replication.tla
|
|
``` |