Need help with cassandra?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

6.9K Stars 3.0K Forks Apache License 2.0 27.0K Commits 493 Opened issues


Mirror of Apache Cassandra

Services available


Need anything else?

Contributors list

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].


. Java >= 1.8 (OpenJDK and Oracle JVMS have been tested) . Python 3.6+ (for cqlsh; 2.7 works but is deprecated)

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

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 KEYSPACE schema1 WITH replication = { 'class' : 'SimpleStrategy', 'replicationfactor' : 1 }; cqlsh> USE schema1; cqlsh:Schema1> CREATE TABLE users ( userid varchar PRIMARY KEY, first varchar, last varchar, age int ); cqlsh:Schema1> INSERT INTO users (userid, first, last, age) VALUES ('jsmith', 'John', 'Smith', 42); cqlsh:Schema1> SELECT * FROM users; userid | 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?

  • Join us in #cassandra on the[ASF Slack] and ask questions
  • Subscribe to the Users mailing list by sending a mail to [email protected]
  • Visit the[community section] of the Cassandra website for more information on getting involved.
  • Visit the[development section] of the Cassandra website for more information on how to contribute.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.