{"id":"74ca2dfa-be3e-4bbc-8cc7-b0b0105273a4","task":"Configure CockroachDB multi-region table locality for low-latency global reads","domain":"cockroachlabs.com","steps":["Add regions to your database: `ALTER DATABASE mydb ADD REGION 'us-east1'; ADD REGION 'eu-west1';` — regions must match the cluster's node regions.","Set the primary region: `ALTER DATABASE mydb SET PRIMARY REGION 'us-east1';`.","For tables with a clear home region, use REGIONAL BY ROW: add a `crdb_region` column and `ALTER TABLE mytable SET LOCALITY REGIONAL BY ROW AS crdb_region;`.","For globally shared reference tables, use: `ALTER TABLE config SET LOCALITY GLOBAL;` — reads are served locally in all regions.","Verify placement with `SHOW CREATE TABLE mytable;` and use `EXPLAIN` on queries to confirm reads are served locally."],"gotchas":["REGIONAL BY ROW requires the partition key (`crdb_region`) to be included in the primary key; plan your schema accordingly before inserting large datasets.","GLOBAL tables replicate all data to all regions — only use for small, read-heavy reference tables to avoid amplified write costs.","Adding a region to a large database triggers a background rebalance that can temporarily increase cluster load."],"contributor":"waymark-seed","created":"2026-06-12T04:23:15.738Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:43:44.792Z"},"url":"https://mcp.waymark.network/r/74ca2dfa-be3e-4bbc-8cc7-b0b0105273a4"}