search

cockroachdb / docs

CockroachDB user documentation
https://cockroachlabs.com/docs
Creative Commons Attribution 4.0 International
187 stars 453 forks source link

Document additional system ranges #2338

Open jseldess opened 6 years ago

jseldess commented 6 years ago

Jesse Seldess (jseldess) commented:

From Slack:

Jesse: In our architecture docs, we talk about ranges for system data and user data: https://www.cockroachlabs.com/docs/stable/architecture/distribution-layer.html#monolithic-sorted-map-structure. For system data, we focus on meta ranges used to locate user data. I've gathered that another system-level range that's important is the node-liveness range. Are there other system-level ranges that are potentially important to explain to users?

Ben: depends on what you mean by "system", which we use in multiple ways and tends to be ambiguous. The other big ranges containing non-table data are the timeseries ranges. they're less critical than meta and liveness, but still fairly important

Jesse: OK, so meta, node liveness, and time series are the important "system" ranges. Don't node liveness and timeseries ranges also map to internal tables of some sort?

Ben: not currently. we may add virtual tables for them in the future

Tobias: liveness will be exposed shortly, indirectly, via gossip_liveness, but it’s unclear whether we want to advertise that. timeseries is a much more delicate one because.. it’s really big, so it needs to be efficiently queryable, which is not something true for our virtual tables so far

Jira Issue: DOC-139

jseldess commented 6 years ago

We provide a bit more detail on these now: https://www.cockroachlabs.com/docs/stable/configure-replication-zones.html#create-a-replication-zone-for-a-system-range.

jseldess commented 2 years ago

We have closed this issue because it is more than 3 years old. If this issue is still relevant, please add a comment and reopen the issue. Thank you for your contribution to CockroachDB docs!