Docs / Specification

contract store · 10-store.md · 11-snapshot.md · 12-time.md · 13-replica.md · 14-drain.md · 15-endpoint.md · 16-collect.md · 17-merge.md · 18-pull.md · guide · card

Replicas

A replica is a read-only store that downloads whole snapshots from another store’s bucket and writes nothing back.

replicate

Replica refreshes, required snapshot files, local snapshot records and refused reads or writes.

• write-refusedtestA write verb against a replica raises ReplicaWriteRefused, naming the canonical store.
  Why

  A-store#replica-read-whole
• partial-parquettestA replica lacking any of a snapshot’s Parquet files makes refresh raise ReplicaPartialParquet and leave that snapshot unpublished.
  Why

  A-store#replica-read-whole
• descriptortestA replica’s pull writes replica.json beside derived.sqlite, naming per table every held snapshot whose parts and sidecar paths exist on disk; push excludes the file.
  Why

  A-store#replica-read-whole, A-store#replica-advertises-descriptor
• missing-indextestA query needing a sidecar or partition the replica lacks raises ReplicaMissingIndex, naming the refresh supplying it.
  Why

  A-store#replica-read-whole, A-store#replica-advertises-descriptor
• sensitive-refusedtestA refresh requesting a replicate-off table raises ReplicaSensitiveTable. The consumer reads that table through the query proxy.
  Why

  A-store#replica-read-whole