Cassandra-CLI utility (deprecated)

Deprecated configuration attributes. Will be removed in Cassandra 3.0.

Important: The CLI utility is deprecated and will be removed in Cassandra 3.0. For ease of use and performance, switch from Thrift and CLI to CQL and cqlsh.

Keyspace attributes

Cassandra stores storage configuration attributes in the system keyspace. You can set storage engine configuration attributes on a per-keyspace or per-table basis on the command line using the Cassandra-CLI utility. A keyspace must have a user-defined name, a replica placement strategy, and options that specify the number of copies per datacenter or node.

name
Required. The name for the keyspace.
placement_strategy
Required. Determines how Cassandra distributes replicas for a keyspace among nodes in the ring. Values are:
  • SimpleStrategy or org.apache.cassandra.locator.SimpleStrategy
  • NetworkTopologyStrategy or org.apache.cassandra.locator.NetworkTopologyStrategy

NetworkTopologyStrategy requires a snitch to be able to determine rack and datacenter locations of a node. For more information about replication placement strategy, see Data replication.

strategy_options
Specifies configuration options for the chosen replication strategy class. The replication factor option is the total number of replicas across the cluster. A replication factor of 1 means that there is only one copy of each row on one node. A replication factor of 2 means there are two copies of each row, where each copy is on a different node. All replicas are equally important; there is no primary or master replica. As a general rule, the replication factor should not exceed the number of nodes in the cluster. However, you can increase the replication factor and then add the desired number of nodes.

When the replication factor exceeds the number of nodes, writes are rejected, but reads are served as long as the desired consistency level can be met.

For more information about configuring the replication placement strategy for a cluster and datacenters, see Choosing keyspace replication options.

durable_writes
(Default: true) When set to false, data written to the keyspace bypasses the commit log. Be careful using this option because you risk losing data.