Mirror of Apache Cassandra
Switch branches/tags
cassandra-3.11.3 cassandra-3.11.2 cassandra-3.11.1 cassandra-3.11.0 cassandra-3.10 cassandra-3.9 cassandra-3.8 cassandra-3.7 cassandra-3.6 cassandra-3.5 cassandra-3.4 cassandra-3.3 cassandra-3.2.1 cassandra-3.2 cassandra-3.1.1 cassandra-3.1 cassandra-3.0.17 cassandra-3.0.16 cassandra-3.0.15 cassandra-3.0.14 cassandra-3.0.13 cassandra-3.0.12 cassandra-3.0.11 cassandra-3.0.10 cassandra-3.0.9 cassandra-3.0.8 cassandra-3.0.7 cassandra-3.0.6 cassandra-3.0.5 cassandra-3.0.4 cassandra-3.0.3 cassandra-3.0.2 cassandra-3.0.1 cassandra-3.0.0 cassandra-3.0.0-rc2 cassandra-3.0.0-rc1 cassandra-3.0.0-beta2 cassandra-3.0.0-beta1 cassandra-3.0.0-alpha1 cassandra-2.2.13 cassandra-2.2.12 cassandra-2.2.11 cassandra-2.2.10 cassandra-2.2.9 cassandra-2.2.8 cassandra-2.2.7 cassandra-2.2.6 cassandra-2.2.5 cassandra-2.2.4 cassandra-2.2.3 cassandra-2.2.2 cassandra-2.2.1 cassandra-2.2.0 cassandra-2.2.0-rc2 cassandra-2.2.0-rc1 cassandra-2.2.0-beta1 cassandra-2.1.20 cassandra-2.1.19 cassandra-2.1.18 cassandra-2.1.17 cassandra-2.1.16 cassandra-2.1.15 cassandra-2.1.14 cassandra-2.1.13 cassandra-2.1.12 cassandra-2.1.11 cassandra-2.1.10 cassandra-2.1.9 cassandra-2.1.8 cassandra-2.1.7 cassandra-2.1.6 cassandra-2.1.5 cassandra-2.1.4 cassandra-2.1.3 cassandra-2.1.2 cassandra-2.1.1 cassandra-2.1.0 cassandra-2.1.0-rc7 cassandra-2.1.0-rc6 cassandra-2.1.0-rc5 cassandra-2.1.0-rc4 cassandra-2.1.0-rc3 cassandra-2.1.0-rc2 cassandra-2.1.0-rc1 cassandra-2.1.0-deb cassandra-2.1.0-beta2 cassandra-2.1.0-beta1 cassandra-2.0.17 cassandra-2.0.16 cassandra-2.0.15 cassandra-2.0.14 cassandra-2.0.13 cassandra-2.0.12 cassandra-2.0.11 cassandra-2.0.10 cassandra-2.0.9 cassandra-2.0.8 cassandra-2.0.7 cassandra-2.0.6 cassandra-2.0.5
Nothing to show
Clone or download
krummas Remove audit from .gitignore
Patch by marcuse; reviewed by Jason Brown for CASSANDRA-14758
Latest commit 27c9374 Sep 18, 2018
Failed to load latest commit information.
.circleci Revert running dtests by default in circleci Jul 31, 2018
bin Add checksumming to the native protocol Sep 1, 2018
conf Detect inconsistencies in repaired data on the read path Sep 5, 2018
debian Switch Debian packaging to quilt patches Sep 8, 2018
doc Adding documentation for sstable tools Sep 13, 2018
examples/triggers Fix trigger example on 4.0 Aug 24, 2017
ide Add fqltool compare Sep 1, 2018
lib Ninja cleanup: remove obsoleted python drivers Sep 11, 2018
pylib Transient Replication and Cheap Quorums Sep 1, 2018
redhat Make C* compile and run on Java 11 and Java 8 Jul 26, 2018
src ReplicaPlan/Layout refactor follow-up/completion Sep 14, 2018
test ninja fix bad merges for unit test Sep 14, 2018
tools Add checksumming to the native protocol Sep 1, 2018
.gitignore Remove audit from .gitignore Sep 18, 2018
.rat-excludes Remove Pig support Oct 16, 2015
CASSANDRA-14092.txt Merge branch 'cassandra-2.2' into cassandra-3.0 Feb 10, 2018
CHANGES.txt Merge branch 'cassandra-3.11' into trunk Sep 14, 2018
CONTRIBUTING.md Update DTest GitHub URLs - Use ASF DTest location Aug 8, 2017
LICENSE.txt merge with 0.6 branch (post-850) Mar 26, 2010
NEWS.txt Transient Replication and Cheap Quorums Sep 1, 2018
NOTICE.txt Thrift removal Dec 13, 2016
README.asc Ninja: Update README with link to instructions for contributing Jun 15, 2017
TESTING.md Ninja trivial typo in TESTING Jun 21, 2018
build.properties.default Switch MAT to fetch jars from repo.maven.apache.org Jun 15, 2017
build.xml Add checksumming to the native protocol Sep 1, 2018
eclipse_compiler.properties Add Static Analysis to warn on unsafe use of Autocloseable instances May 27, 2015


Apache Cassandra

Apache Cassandra is a highly-scalable partitioned row store. Rows are organized into tables with a required primary key.

Partitioning means that Cassandra can distribute your data across multiple machines in an application-transparent matter. Cassandra will automatically repartition as machines are added and removed from the cluster.

Row store means that like relational databases, Cassandra organizes data by rows and columns. The Cassandra Query Language (CQL) is a close relative of SQL.

For more information, see the Apache Cassandra web site.


  1. Java >= 1.8 (OpenJDK and Oracle JVMS have been tested)

  2. Python 2.7 (for cqlsh)

Getting started

This short guide will walk you through getting a basic one node cluster up and running, and demonstrate some simple reads and writes. For a more-complete guide, please see the Apache Cassandra website’s Getting Started Guide.

First, we’ll unpack our archive:

$ tar -zxvf apache-cassandra-$VERSION.tar.gz
$ cd apache-cassandra-$VERSION

After that we start the server. Running the startup script with the -f argument will cause Cassandra to remain in the foreground and log to standard out; it can be stopped with ctrl-C.

$ bin/cassandra -f

Note for Windows users: to install Cassandra as a service, download Procrun, set the PRUNSRV environment variable to the full path of prunsrv (e.g., C:\procrun\prunsrv.exe), and run "bin\cassandra.bat install". Similarly, "uninstall" will remove the service.

Now let’s try to read and write some data using the Cassandra Query Language:

$ bin/cqlsh

The command line client is interactive so if everything worked you should be sitting in front of a prompt:

Connected to Test Cluster at localhost:9160.
[cqlsh 2.2.0 | Cassandra 1.2.0 | CQL spec 3.0.0 | Thrift protocol 19.35.0]
Use HELP for help.

As the banner says, you can use 'help;' or '?' to see what CQL has to offer, and 'quit;' or 'exit;' when you’ve had enough fun. But lets try something slightly more interesting:

cqlsh> CREATE SCHEMA schema1
       WITH replication = { 'class' : 'SimpleStrategy', 'replication_factor' : 1 };
cqlsh> USE schema1;
cqlsh:Schema1> CREATE TABLE users (
                 user_id varchar PRIMARY KEY,
                 first varchar,
                 last varchar,
                 age int
cqlsh:Schema1> INSERT INTO users (user_id, first, last, age)
               VALUES ('jsmith', 'John', 'Smith', 42);
cqlsh:Schema1> SELECT * FROM users;
 user_id | age | first | last
  jsmith |  42 |  john | smith

If your session looks similar to what’s above, congrats, your single node cluster is operational!

For more on what commands are supported by CQL, see the CQL reference. A reasonable way to think of it is as, "SQL minus joins and subqueries, plus collections."

Wondering where to go from here?