Classes

Constants

consistencies

Consistency levels

Properties:
Name Type Description
any Number

Writing: A write must be written to at least one node. If all replica nodes for the given row key are down, the write can still succeed after a hinted handoff has been written. If all replica nodes are down at write time, an ANY write is not readable until the replica nodes for that row have recovered.

one Number

Returns a response from the closest replica, as determined by the snitch.

two Number

Returns the most recent data from two of the closest replicas.

three Number

Returns the most recent data from three of the closest replicas.

quorum Number

Reading: Returns the record with the most recent timestamp after a quorum of replicas has responded regardless of data center. Writing: A write must be written to the commit log and memory table on a quorum of replica nodes.

all Number

Reading: Returns the record with the most recent timestamp after all replicas have responded. The read operation will fail if a replica does not respond. Writing: A write must be written to the commit log and memory table on all replica nodes in the cluster for that row.

localQuorum Number

Reading: Returns the record with the most recent timestamp once a quorum of replicas in the current data center as the coordinator node has reported. Writing: A write must be written to the commit log and memory table on a quorum of replica nodes in the same data center as the coordinator node. Avoids latency of inter-data center communication.

eachQuorum Number

Reading: Returns the record once a quorum of replicas in each data center of the cluster has responded. Writing: Strong consistency. A write must be written to the commit log and memtable on a quorum of replica nodes in all data centers.

serial Number

Achieves linearizable consistency for lightweight transactions by preventing unconditional updates.

localSerial Number

Same as serial but confined to the data center. A write must be written conditionally to the commit log and memtable on a quorum of replica nodes in the same data center.

localOne Number

Similar to One but only within the DC the coordinator is in.

consistencyToString

Mapping of consistency level codes to their string representation.

dataTypes

CQL data types

Properties:
Name Type Description
custom Number

A custom type.

ascii Number

ASCII character string.

bigint Number

64-bit signed long.

blob Number

Arbitrary bytes (no validation).

boolean Number

true or false.

counter Number

Counter column (64-bit signed value).

decimal Number

Variable-precision decimal.

double Number

64-bit IEEE-754 floating point.

float Number

32-bit IEEE-754 floating point.

int Number

32-bit signed integer.

text Number

UTF8 encoded string.

timestamp Number

A timestamp.

uuid Number

Type 1 or type 4 UUID.

varchar Number

UTF8 encoded string.

varint Number

Arbitrary-precision integer.

timeuuid Number

Type 1 UUID.

inet Number

An IP address. It can be either 4 bytes long (IPv4) or 16 bytes long (IPv6).

date Number

A date without a time-zone in the ISO-8601 calendar system.

time Number

A value representing the time portion of the day.

smallint Number

16-bit two’s complement integer.

tinyint Number

8-bit two’s complement integer.

list Number

A collection of elements.

map Number

Key/value pairs.

set Number

A collection that contains no duplicate elements.

udt Number

User-defined type.

tuple Number

A sequence of values.

distance

Represents the distance of Cassandra node as assigned by a LoadBalancingPolicy relatively to the driver instance.

Properties:
Name Type Description
local Number

A local node.

remote Number

A remote node.

ignored Number

A node that is meant to be ignored.

protocolVersion

Contains information for the different protocol versions supported by the driver.

Properties:
Name Type Description
v1 Number

Cassandra protocol v1, supported in Apache Cassandra 1.2–>2.2.

v2 Number

Cassandra protocol v2, supported in Apache Cassandra 2.0–>2.2.

v3 Number

Cassandra protocol v3, supported in Apache Cassandra 2.1–>3.x.

v4 Number

Cassandra protocol v4, supported in Apache Cassandra 2.2–>3.x.

v5 Number

Cassandra protocol v5, in beta from Apache Cassandra 3.x+. Currently not supported by the driver.

maxSupported Number

Returns the higher protocol version that is supported by this driver.

minSupported Number

Returns the lower protocol version that is supported by this driver.

isSupported function

A function that returns a boolean determining whether a given protocol version is supported.

responseErrorCodes

Server error codes returned by Cassandra

Properties:
Name Type Description
serverError Number

Something unexpected happened.

protocolError Number

Some client message triggered a protocol violation.

badCredentials Number

Authentication was required and failed.

unavailableException Number

Raised when coordinator knows there is not enough replicas alive to perform a query with the requested consistency level.

overloaded Number

The request cannot be processed because the coordinator is overloaded.

isBootstrapping Number

The request was a read request but the coordinator node is bootstrapping.

truncateError Number

Error encountered during a truncate request.

writeTimeout Number

Timeout encountered on write query on coordinator waiting for response(s) from replicas.

readTimeout Number

Timeout encountered on read query on coordinator waitign for response(s) from replicas.

readFailure Number

A non-timeout error encountered during a read request.

functionFailure Number

A (user defined) function encountered during execution.

writeFailure Number

A non-timeout error encountered during a write request.

syntaxError Number

The submitted query has a syntax error.

unauthorized Number

The logged user doesn’t have the right to perform the query.

invalid Number

The query is syntactically correct but invalid.

configError Number

The query is invalid because of some configuration issue.

alreadyExists Number

The query attempted to create a schema element (i.e. keyspace, table) that already exists.

unprepared Number

Can be thrown while a prepared statement tries to be executed if the provided statement is not known by the coordinator.

unset

Unset representation.

Use this field if you want to set a parameter to unset. Valid for Cassandra 2.2 and above.

Functions

generateTimestamp

([Date date], [Number microseconds])

Generates a value representing the timestamp for the query in microseconds based on the date and the microseconds provided

Parameters:
Name Type Description
date optional Date

The date to generate the value, if not provided it will use the current date.

microseconds optional Number

A number from 0 to 999 used to build the microseconds part of the date.

Returns:
Type Description
Long

timeuuid

([Object options], [Buffer buffer], [Number offset])

Backward compatibility only, use TimeUuid instead.

Generates and returns a RFC4122 v1 (timestamp based) UUID in a string representation.

Parameters:
Name Type Description
options optional Object
buffer optional Buffer
offset optional Number

uuid

()

Backward compatibility only, use Uuid class instead.

Generate and return a RFC4122 v4 UUID in a string representation.