-
Notifications
You must be signed in to change notification settings - Fork 3.8k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Update to design document overview and trim of appendix #9648
Conversation
LGTM |
ranges. | ||
CockroachDB is a distributed SQL database. The primary design goals | ||
are **scalability**, **strong consistency** and **survivability** | ||
(hence the name). Cockroach aims to tolerate disk, machine, rack, and |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Should we consistently use CockroachDB
in this document?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Done
additional CockroachDB nodes. Ranges are merged and split to maintain | ||
a target size, by default `64M`. The relatively small size facilitates | ||
quick repair and rebalancing to address node failures, new capacity | ||
and even read/write load. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
There is also pressure for a larger size to minimize the meta2
index size.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Mentioned.
replication factor), theoretically up to 4 exabytes (4E) of logical | ||
data; | ||
- client queries can be sent to any node in the cluster, and queries | ||
can operate fully independently from each other, meaning that |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The queries can operate independently when there aren't conflicts. Not sure if that detail is worth calling out here.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Done
overall throughput is a linear factor of the number of nodes in the | ||
cluster. | ||
- queries are distributed (ref: distributed SQL) so that the overall | ||
throughput of single queries can also be increased by adding more |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
s/can also be/can be/g
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Done
throughput of single queries can also be increased by adding more | ||
nodes. | ||
|
||
CocroachDB achieves strong consistency: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
s/CocroachDB/CockroachDB/g
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Done
CockroachDB achieves survivability: | ||
- range replicas can be co-located within a single datacenter for low | ||
latency replication and survive disk or machine failures. They can | ||
be located across racks to survive some network switch failures. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
s/located/distributed/g
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Done
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Submitting as a separate PR
additional CockroachDB nodes. Ranges are merged and split to maintain | ||
a target size, by default `64M`. The relatively small size facilitates | ||
quick repair and rebalancing to address node failures, new capacity | ||
and even read/write load. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Mentioned.
replication factor), theoretically up to 4 exabytes (4E) of logical | ||
data; | ||
- client queries can be sent to any node in the cluster, and queries | ||
can operate fully independently from each other, meaning that |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Done
overall throughput is a linear factor of the number of nodes in the | ||
cluster. | ||
- queries are distributed (ref: distributed SQL) so that the overall | ||
throughput of single queries can also be increased by adding more |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Done
throughput of single queries can also be increased by adding more | ||
nodes. | ||
|
||
CocroachDB achieves strong consistency: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Done
CockroachDB achieves survivability: | ||
- range replicas can be co-located within a single datacenter for low | ||
latency replication and survive disk or machine failures. They can | ||
be located across racks to survive some network switch failures. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Done
This change is