Skip to content
CockroachDB - the open source, cloud-native SQL database.
Branch: master
Clone or download
craig[bot] and lucy-zhang Merge #35972
35972: workload: make kv --max-block-bytes an inclusive upper bound r=lucy-zhang a=lucy-zhang

The `kv` workload takes arguments `--min-block-bytes` and `--max-block-bytes`
and was generating keys with a length chosen uniformly at random from the
interval that excludes `--max-block-bytes`. Also, since we were using
`Rand.Intn()`, using the same value for both args would cause a panic from
passing in 0. This change makes the upper bound inclusive, which seems to be
the intended behavior.

Release note: None

Co-authored-by: Lucy Zhang <>
Latest commit 6cac063 Mar 22, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github stats: add sql-opt-prs as code owner of /pkg/sql/stats Mar 14, 2019
build builder: upgrade to go1.11.6 Mar 18, 2019
c-deps rangefeed: fix handling of aborted transactions found by txnPushAttempt Mar 19, 2019
cloud cloud: bump Orchestrator configs to 2.1.6 Mar 11, 2019
docs Merge #35284 #35793 #35865 Mar 18, 2019
githooks githooks: make prepare-commit-msg resilient to `commit -v` Sep 10, 2018
licenses ui: regenerate fonts Nov 26, 2018
monitoring monitoring: add expiration alerts for optional certificates. Aug 13, 2018
scripts add extra team members Mar 11, 2019
vendor @ 2b619c3
.editorconfig editorconfig: Use tabs for Makefile indentation Mar 5, 2019
.gitattributes sql: clean up the `array` logic test Mar 13, 2019
.gitignore cmd/docgen: add grammar diagram generator Oct 4, 2017
.gitmodules Merge #35028 Mar 1, 2019
LICENSE *: clarify licensing Nov 10, 2017
Makefile README: remove links to gitter Mar 4, 2019


CockroachDB is a cloud-native SQL database for building global, scalable cloud services that survive disasters.

TeamCity CI GoDoc

What is CockroachDB?

CockroachDB is a distributed SQL database built on a transactional and strongly-consistent key-value store. It scales horizontally; survives disk, machine, rack, and even datacenter failures with minimal latency disruption and no manual intervention; supports strongly-consistent ACID transactions; and provides a familiar SQL API for structuring, manipulating, and querying data.

For more details, see our FAQ or architecture document.

Here’s a quick explainer video:


CockroachDB is production-ready. See our Roadmap for a list of features planned or in development.


For guidance on installation, development, deployment, and administration, see our User Documentation.


  1. Install CockroachDB.

  2. Start a local cluster and talk to it via the built-in SQL client.

  3. Learn more about CockroachDB SQL.

  4. Use a PostgreSQL-compatible driver or ORM to build an app with CockroachDB.

  5. Explore core features, such as data replication, automatic rebalancing, and fault tolerance and recovery.

Client Drivers

CockroachDB supports the PostgreSQL wire protocol, so you can use any available PostgreSQL client drivers to connect from various languages.


  • Test Deployment - Easiest way to test an insecure, multi-node CockroachDB cluster.
  • Production Deployments
    • Manual - Steps to deploy a CockroachDB cluster manually on multiple machines.
    • Cloud - Guides for deploying CockroachDB on various cloud platforms.
    • Orchestration - Guides for running CockroachDB with popular open-source orchestration systems.

Need Help?


We're an open source project and welcome contributions. See our Contributing Guide for more details.

Engineering discussion takes place on our public mailing list,


For an in-depth discussion of the CockroachDB architecture, see our Architecture Guide.

For the original design motivation, see our design doc.

Comparison with Other Databases

To see how key features of CockroachDB stack up against other databases, visit the CockroachDB in Comparison page on our website.

See Also

You can’t perform that action at this time.