com.thinkaurelius.titan.diskstorage.cassandra.thrift

Class CassandraThriftStoreManager

java.lang.Object

com.thinkaurelius.titan.diskstorage.common.AbstractStoreManager

com.thinkaurelius.titan.diskstorage.common.DistributedStoreManager

com.thinkaurelius.titan.diskstorage.cassandra.AbstractCassandraStoreManager

com.thinkaurelius.titan.diskstorage.cassandra.thrift.CassandraThriftStoreManager

All Implemented Interfaces:

KeyColumnValueStoreManager, StoreManager

public class CassandraThriftStoreManager
extends AbstractCassandraStoreManager

This class creates CassandraThriftKeyColumnValueStores and handles Cassandra-backed allocation of vertex IDs for Titan (when so configured).

Author:

Dan LaRocque

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	CassandraThriftStoreManager.PoolExhaustedAction

Nested classes/interfaces inherited from class com.thinkaurelius.titan.diskstorage.cassandra.AbstractCassandraStoreManager

AbstractCassandraStoreManager.Partitioner

Nested classes/interfaces inherited from class com.thinkaurelius.titan.diskstorage.common.DistributedStoreManager

DistributedStoreManager.Deployment, DistributedStoreManager.MaskedTimestamp

Field Summary

Fields

Modifier and Type	Field and Description
static ConfigOption<Long>	CPOOL_EVICTOR_PERIOD
static ConfigOption<Boolean>	CPOOL_IDLE_TESTS
static ConfigOption<Integer>	CPOOL_IDLE_TESTS_PER_EVICTION_RUN
static ConfigOption<Integer>	CPOOL_MAX_ACTIVE
static ConfigOption<Integer>	CPOOL_MAX_IDLE
static ConfigOption<Integer>	CPOOL_MAX_TOTAL
static ConfigOption<Long>	CPOOL_MAX_WAIT
static ConfigOption<Long>	CPOOL_MIN_EVICTABLE_IDLE_TIME
static ConfigOption<Integer>	CPOOL_MIN_IDLE
static ConfigNamespace	CPOOL_NS
static ConfigOption<CassandraThriftStoreManager.PoolExhaustedAction>	CPOOL_WHEN_EXHAUSTED
static ConfigOption<Integer>	THRIFT_FRAME_SIZE THRIFT_FRAME_SIZE_IN_MB should be appropriately set when server-side Thrift counterpart was changed, because otherwise client wouldn't be able to accept read/write frames from server as incorrectly sized.
static ConfigNamespace	THRIFT_NS

Fields inherited from class com.thinkaurelius.titan.diskstorage.cassandra.AbstractCassandraStoreManager

ATOMIC_BATCH_MUTATE, atomicBatch, CASSANDRA_KEYSPACE, CASSANDRA_NS, CASSANDRA_READ_CONSISTENCY, CASSANDRA_WRITE_CONSISTENCY, CF_COMPRESSION, CF_COMPRESSION_BLOCK_SIZE, CF_COMPRESSION_TYPE, compressionChunkSizeKB, compressionClass, compressionEnabled, keySpaceName, PORT_DEFAULT, REPLICATION_FACTOR, REPLICATION_OPTIONS, REPLICATION_STRATEGY, SSL_ENABLED, SSL_NS, SSL_TRUSTSTORE_LOCATION, SSL_TRUSTSTORE_NS, SSL_TRUSTSTORE_PASSWORD, strategyOptions, SYSTEM_KS

Fields inherited from class com.thinkaurelius.titan.diskstorage.common.DistributedStoreManager

connectionTimeoutMS, hostnames, pageSize, password, port, times, username

Fields inherited from class com.thinkaurelius.titan.diskstorage.common.AbstractStoreManager

batchLoading, isReadOnly, storageConfig, transactional

Constructor Summary

Constructors

Constructor and Description
CassandraThriftStoreManager(Configuration config)

Method Summary

Modifier and Type	Method and Description
void	clearStorage() Connect to Cassandra via Thrift on the specified host and port and attempt to truncate the named keyspace.
void	close()
org.apache.cassandra.dht.IPartitioner<? extends org.apache.cassandra.dht.Token<?>>	getCassandraPartitioner()
Map<String,String>	getCompressionOptions(String cf) Returns a map of compression options for the column family cf.
DistributedStoreManager.Deployment	getDeployment()
List<KeyRange>	getLocalKeyPartition()
void	mutateMany(Map<String,Map<StaticBuffer,KCVMutation>> mutations, StoreTransaction txh)
CassandraThriftKeyColumnValueStore	openDatabase(String name)
String	toString()

Methods inherited from class com.thinkaurelius.titan.diskstorage.cassandra.AbstractCassandraStoreManager

beginTransaction, getFeatures, getName, getPartitioner

Methods inherited from class com.thinkaurelius.titan.diskstorage.common.DistributedStoreManager

getPageSize, getSingleHostname, getTimestampProvider, hasAuthentication, sleepAfterWrite

Methods inherited from class com.thinkaurelius.titan.diskstorage.common.AbstractStoreManager

getMetaDataSchema, getStorageConfig

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

THRIFT_NS

public static final ConfigNamespace THRIFT_NS

THRIFT_FRAME_SIZE

public static final ConfigOption<Integer> THRIFT_FRAME_SIZE

THRIFT_FRAME_SIZE_IN_MB should be appropriately set when server-side Thrift counterpart was changed, because otherwise client wouldn't be able to accept read/write frames from server as incorrectly sized.

HEADS UP: setting max message size proved itself hazardous to be set on the client, only server needs that kind of protection.

Note: property is sized in megabytes for user convenience (defaults are 15MB by cassandra.yaml).

CPOOL_NS

public static final ConfigNamespace CPOOL_NS

CPOOL_WHEN_EXHAUSTED

public static final ConfigOption<CassandraThriftStoreManager.PoolExhaustedAction> CPOOL_WHEN_EXHAUSTED

CPOOL_MAX_TOTAL

public static final ConfigOption<Integer> CPOOL_MAX_TOTAL

CPOOL_MAX_ACTIVE

public static final ConfigOption<Integer> CPOOL_MAX_ACTIVE

CPOOL_MAX_IDLE

public static final ConfigOption<Integer> CPOOL_MAX_IDLE

CPOOL_MIN_IDLE

public static final ConfigOption<Integer> CPOOL_MIN_IDLE

CPOOL_MAX_WAIT

public static final ConfigOption<Long> CPOOL_MAX_WAIT

CPOOL_EVICTOR_PERIOD

public static final ConfigOption<Long> CPOOL_EVICTOR_PERIOD

CPOOL_MIN_EVICTABLE_IDLE_TIME

public static final ConfigOption<Long> CPOOL_MIN_EVICTABLE_IDLE_TIME

CPOOL_IDLE_TESTS

public static final ConfigOption<Boolean> CPOOL_IDLE_TESTS

CPOOL_IDLE_TESTS_PER_EVICTION_RUN

public static final ConfigOption<Integer> CPOOL_IDLE_TESTS_PER_EVICTION_RUN

Constructor Detail

CassandraThriftStoreManager

public CassandraThriftStoreManager(Configuration config)
                            throws BackendException

Throws:

BackendException

Method Detail

getDeployment

public DistributedStoreManager.Deployment getDeployment()

Specified by:

getDeployment in class DistributedStoreManager

getCassandraPartitioner

public org.apache.cassandra.dht.IPartitioner<? extends org.apache.cassandra.dht.Token<?>> getCassandraPartitioner()
                                                                                                           throws BackendException

Specified by:

getCassandraPartitioner in class AbstractCassandraStoreManager

Throws:

BackendException

toString

public String toString()

Overrides:

toString in class AbstractCassandraStoreManager

close

public void close()
           throws BackendException

Throws:

BackendException

mutateMany

public void mutateMany(Map<String,Map<StaticBuffer,KCVMutation>> mutations,
                       StoreTransaction txh)
                throws BackendException

Throws:

BackendException

openDatabase

public CassandraThriftKeyColumnValueStore openDatabase(String name)
                                                throws BackendException

Throws:

BackendException

getLocalKeyPartition

public List<KeyRange> getLocalKeyPartition()
                                    throws BackendException

Throws:

BackendException

clearStorage

public void clearStorage()
                  throws BackendException

Connect to Cassandra via Thrift on the specified host and port and attempt to truncate the named keyspace.

This is a utility method intended mainly for testing. It is equivalent to issuing 'truncate ' for each of the column families in keyspace using the cassandra-cli tool.

Using truncate is better for a number of reasons, most significantly because it doesn't involve any schema modifications which can take time to propagate across the cluster such leaves nodes in the inconsistent state and could result in read/write failures. Any schema modifications are discouraged until there is no traffic to Keyspace or ColumnFamilies.

Throws:

BackendException - if any checked Thrift or UnknownHostException is thrown in the body of this method

getCompressionOptions

public Map<String,String> getCompressionOptions(String cf)
                                         throws BackendException

Description copied from class: AbstractCassandraStoreManager

Returns a map of compression options for the column family cf. The contents of the returned map must be identical to the contents of the map returned by CfDef.getCompression_options(), even for implementations of this method that don't use Thrift.

Specified by:

getCompressionOptions in class AbstractCassandraStoreManager

Parameters:

cf - the name of the column family for which to return compression options

Returns:

map of compression option names to compression option values

Throws:

BackendException - if reading from Cassandra fails