ACE Commands

December 2, 2025 ยท View on GitHub

This section documents the ACE (Active Consistency Engine) CLI commands. Be sure you review and meet all of the ACE configuration requirements before using any ACE command:

Basic ACE diff and repair Commands

CommandDescription
repset-diffRuns table-diff on every table in a specified replication set and aggregates results.
schema-diffCompares objects (and optionally data via per-table diffs) across nodes for an entire schema.
spock-diffCompares Spock metadata/state across nodes to find configuration divergences.
table-diffCompares a single table across cluster nodes and writes a diff report (JSON/HTML/CSV).
table-repairApplies fixes from a diff file using a chosen source-of-truth node; supports dry-run, upsert/insert-only, and --fix-nulls for NULL-only drifts.
table-rerunRe-runs a previous diff from a saved file to verify that inconsistencies were resolved.

Merkle Tree (mtree) Commands

CommandDescription
mtree buildBuilds Merkle trees for a specific table on all nodes (after mtree init).
mtree initCreates required schema/objects and sets up CDC (publication/slot) for Merkle operations.
mtree listenLong-running process that consumes CDC and continuously updates Merkle trees.
mtree table-diffCompares Merkle trees across nodes to detect inconsistencies; can emit JSON/HTML reports.
mtree teardownRemoves all Merkle-related objects and CDC setup created by mtree init.
mtree teardown-tableDrops Merkle data/metadata for one table and removes it from CDC publication.
mtree updateApplies captured CDC changes to refresh Merkle trees; optional rebalance.