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

Document read and write request paths #3534

Closed
jseldess opened this issue Aug 10, 2018 · 4 comments
Closed

Document read and write request paths #3534

jseldess opened this issue Aug 10, 2018 · 4 comments

Comments

@jseldess
Copy link
Contributor

Our architecture docs cover the components involved in reads and writes, but it would be nice to have docs that put the pieces together, in greater detail and with examples.

For example, currently, there's not a good way to understand the exact sequence of actions for a simple write, how both the raft log and kv come into play and when, and when data is actually written to disk. The Life of a SQL query tech note is probably the best current source of information.

cc: @bdarnell, @robert-s-lee, @andreimatei.

@jseldess jseldess modified the milestones: 2.1, 2.2 Aug 10, 2018
@jseldess
Copy link
Contributor Author

jseldess commented Aug 10, 2018

Thanks to @andreimatei for finding this: For future reference, the Raft leader and its followers write new Raft log entries to disk in parallel (i.e., the leader's write isn't blocking): cockroachdb/cockroach@b67eb69

@robert-s-lee
Copy link
Contributor

#2300 has sequence diagram that may be helpful.

@jseldess
Copy link
Contributor Author

Ah, yes. Thank you, @robert-s-lee. I knew there was a related issue but couldn't find it.

@jseldess
Copy link
Contributor Author

Closing in favor of #3873.

@jseldess jseldess removed this from the 2.2 milestone Oct 29, 2018
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

2 participants