Mirror of Apache Cassandra (incubating)
Java Python Perl Shell
Switch branches/tags
pending/4627 pending/4594-1.2 pending/4594-1.2-rebase pending/4594-1.1 pending/4546 pending/4500 pending/4500-3 pending/4500-2 pending/4491 pending/4470 pending/4454 pending/4434 pending/4434-2 pending/4385 pending/4385-2 pending/4271 pending/4198 pending/4173 pending/4173-3 pending/4173-2 pending/4164 pending/4164-2 pending/4163 pending/4163-2 pending/4161 pending/4113 pending/4113-for-1.1 pending/4113-2 pending/4108 pending/4090 pending/4074 pending/4073 pending/4036 pending/4033 pending/4012 pending/4012-2 pending/4003 pending/4003-3 pending/4003-2 pending/3990 pending/3951 pending/3709 pending/3709-2 pending/3636 drivers done/3933-1.1 done/3933-1.0 done/3757 done/3718 done/3587 done/3586 done/3523 done/3507 done/3479 done/3458 discontinued/3726 cassandra-0.8.4 cassandra-0.8.3 cassandra-0.8.2 cassandra-0.8.1 cassandra-0.8.0 cassandra-0.8.0-rc1 cassandra-0.8.0-beta2 cassandra-0.8.0-beta1 cassandra-0.7.9 cassandra-0.7.8 cassandra-0.7.7 cassandra-0.7.6 cassandra-0.7.6-2 cassandra-0.7.5 cassandra-0.7.4 cassandra-0.7.3 cassandra-0.7.2 cassandra-0.7.1 cassandra-0.7.0 cassandra-0.7.0-rc4 cassandra-0.7.0-rc3 cassandra-0.7.0-rc2 cassandra-0.7.0-rc1 cassandra-0.7.0-beta3 cassandra-0.7.0-beta2 cassandra-0.7.0-beta1 cassandra-0.6.13 cassandra-0.6.12 cassandra-0.6.11 cassandra-0.6.10 cassandra-0.6.9 cassandra-0.6.8 cassandra-0.6.7 cassandra-0.6.6 cassandra-0.6.5 cassandra-0.6.4 cassandra-0.6.3 cassandra-0.6.2 cassandra-0.6.1 cassandra-0.6.0 cassandra-0.6.0-rc1 cassandra-0.6.0-beta3 cassandra-0.6.0-beta2 cassandra-0.6.0-beta1
Nothing to show
Clone or download
Pull request Compare This branch is 16586 commits behind apache:trunk.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Cassandra is a highly scalable, eventually consistent, distributed, structured 
key-value store. 

Project description

Cassandra brings together the distributed systems technologies from Dynamo 
and the data model from Google's BigTable. Like Dynamo, Cassandra is 
eventually consistent. Like BigTable, Cassandra provides a ColumnFamily-based
data model richer than typical key/value systems.

For more information see http://cassandra.apache.org/

  * Java >= 1.6 (OpenJDK and Sun have been tested)

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.

  * tar -zxvf apache-cassandra-$VERSION.tar.gz
  * cd apache-cassandra-$VERSION
  * sudo mkdir -p /var/log/cassandra
  * sudo chown -R `whoami` /var/log/cassandra
  * sudo mkdir -p /var/lib/cassandra
  * sudo chown -R `whoami` /var/lib/cassandra

Note: The sample configuration files in conf/ determine the file-system 
locations Cassandra uses for logging and data storage. You are free to
change these to suit your own environment and adjust the path names
used here accordingly.

Now that we're ready, let's start it up!

  * bin/cassandra -f

Unix: Running the startup script with the -f argument will cause
Cassandra to remain in the foreground and log to standard out.

Windows: bin\cassandra.bat runs in the foreground by default.  To
install Cassandra as a Windows service, download Procrun from
http://commons.apache.org/daemon/procrun.html, 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 --cql3

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.1.3 | CQL spec 3.0.0 | Thrift protocol 19.32.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 strategy_class = 'SimpleStrategy'
         AND strategy_options: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 
https://github.com/apache/cassandra/blob/trunk/doc/cql3/CQL.textile.  A
reasonable way to think of it is as, "SQL minus joins and subqueries."

Wondering where to go from here? 

  * Getting started: http://wiki.apache.org/cassandra/GettingStarted
  * Join us in #cassandra on irc.freenode.net and ask questions
  * Subscribe to the Users mailing list by sending a mail to
  * Planet Cassandra aggregates Cassandra articles and news: