Skip to content
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

Merged
merged 1 commit into from
Sep 30, 2016

Conversation

spencerkimball
Copy link
Member

@spencerkimball spencerkimball commented Sep 30, 2016

This change is Reviewable

@knz
Copy link
Contributor

knz commented Sep 30, 2016

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
Copy link
Collaborator

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?

Copy link
Member Author

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.
Copy link
Collaborator

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.

Copy link
Member Author

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
Copy link
Collaborator

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.

Copy link
Member Author

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
Copy link
Collaborator

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

Copy link
Member Author

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:
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

s/CocroachDB/CockroachDB/g

Copy link
Member Author

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.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

s/located/distributed/g

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done

@spencerkimball spencerkimball merged commit 3b38e26 into master Sep 30, 2016
@spencerkimball spencerkimball deleted the spencerkimball/designdoc branch September 30, 2016 19:11
Copy link
Member Author

@spencerkimball spencerkimball left a 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.
Copy link
Member Author

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
Copy link
Member Author

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
Copy link
Member Author

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:
Copy link
Member Author

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.
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done

@jseldess jseldess mentioned this pull request Oct 5, 2016
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants