rcrowley / node_cassandra

node.js addon for cassandra

About

node_cassandra is node.js addon for Apache Cassandra(http://cassandra.apache.org). node_cassandra originally used C++ thrift client, but thanks to node.js support in Thrift ver 0.6, current version uses only javascript. Currently, only cassandra 0.7.x is supported.

Requirement

node-thrift, but if you install node_cassandra with npm, it should be installed as well.

Installation

$ npm install cassandra

of

$ git clone https://github.com/yukim/node_cassandra.git

$ npm install .

Usage

Example usage:

var cassandra = require("cassandra");
var client = new cassandra.Client("host:port");
var CL = cassandra.ConsistencyLevel;

client.consistencyLevel({
  write: CL.ONE,
  read: CL.ONE
});

client.connect("SomeKeySpace");
var cf = client.getColumnFamily("SomeColumnFamily");

var data = cf.get("key", function(err, data) {
  // play with data
  console.log(data.columnName);
});

For more detailed example, see test/test.js.

Test

If you have expresso installed, you can run tests with:

$ expresso -I lib

Limitation

Following APIs are not yet supported.

• get_range_slice
• get_index_slice
• system_* (schema modification APIs)

License

Apache 2.0 License

node_cassandra's Issues

UTF-8 wrongly rejected

The schema includes the following:

and comparator = 'BytesType'
and default_validation_class = 'UTF8Type'
and key_validation_class = 'UTF8Type'

The error:

Sep  2 10:06:55 prod02 betable-id: HPB3hXmFtPfOeI-b9wqZXo   { why: '(String didn\'t validate.) [betable_id][users][6c6173745f6e616d65] failed validation',
Sep  2 10:06:55 prod02 betable-id: HPB3hXmFtPfOeI-b9wqZXo     name: 'InvalidRequestException' }

The offending string:

Jiménez Díaz

As hex, showing that it's valid UTF-8:

█ $ echo "Jiménez Díaz" | hd
00000000  4a 69 6d c3 a9 6e 65 7a  20 44 c3 ad 61 7a 0a     |Jim..nez D..az.|
0000000f
█ $