You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
craig[bot] 1c267f3b89 Merge #42406 #42451 18 hours ago
.github CODEOWNERS: (re-)register cli-prs for pkg/cli 2 months ago
build build: require patch level 10+ for go1.12 5 days ago
c-deps libroach: Fix memory leak in row_counter 1 day ago
cloud kubernetes: add required selector 1 month ago
docs Add partition index diagram 3 days ago
githooks githooks: invite the release note author to hint a bug's age 1 week ago
licenses licenses: Update BSL change date for master/20.1 1 week ago
monitoring monitoring: add expiration alerts for optional certificates. 1 year ago
pkg Merge #42406 #42451 18 hours ago
scripts sql/sem/builtins: Add bit_and and bit_or. 1 month ago
vendor @ 7ccc95f4bb vendor: bump pebble to 454f97154cd5bcb3d2a938189eefd8229beda93c 5 days ago
.editorconfig editorconfig: Use tabs for Makefile indentation 8 months ago
.gitattributes sql: clean up the `array` logic test 8 months ago
.gitignore cmd/fuzz: add new fuzz command 3 months ago
.gitmodules Revert "Revert "deps: configure and build patched libedit"" 4 months ago
AUTHORS Merge #40970 #41724 #41926 #41975 2 weeks ago
CONTRIBUTING.md githooks: enhance the commit message recommendations 1 month ago
Gopkg.lock vendor: bump pebble to 454f97154cd5bcb3d2a938189eefd8229beda93c 5 days ago
Gopkg.toml roachprod: Add support for Microsoft Azure cloud 3 weeks ago
LICENSE licenses: Add BSL.txt 5 months ago
Makefile Makefile: make bin/prereqs depend on submodules 1 week ago
README.md docs: move the contribution guide to the external wiki 1 month ago

README.md

CockroachDB

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

TeamCity CI/statusIcon.svg) 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:

Docs

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

Quickstart

  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.

Deployment

  • 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?

Contributing

We’re an open source project and welcome contributions. See our Contributor Wiki for more details.

Engineering discussion takes place on our public mailing list, cockroach-db@googlegroups.com.

Design

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