com.thinkaurelius.titan.diskstorage.cassandra.astyanax

Class AstyanaxStoreManager

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.astyanax.AstyanaxStoreManager

All Implemented Interfaces:

KeyColumnValueStoreManager, StoreManager

public class AstyanaxStoreManager
extends AbstractCassandraStoreManager

Nested Class Summary

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 ConfigNamespace	ASTYANAX_NS
static ConfigOption<String>	CLUSTER_NAME Default name for the Cassandra cluster
static ConfigOption<String>	CONNECTION_POOL_TYPE Astyanax's connection pooler implementation.
static ConfigOption<String>	HOST_SUPPLIER Astyanax specific host supplier useful only when discovery type set to DISCOVERY_SERVICE or TOKEN_AWARE.
static ConfigOption<String>	LOCAL_DATACENTER
static ConfigOption<Integer>	MAX_CLUSTER_CONNECTIONS_PER_HOST Maximum pooled "cluster" connections per host.
static ConfigOption<Integer>	MAX_CONNECTIONS Maximum open connections allowed in the pool (counting all hosts).
static ConfigOption<Integer>	MAX_CONNECTIONS_PER_HOST Maximum pooled connections per host.
static ConfigOption<Integer>	MAX_OPERATIONS_PER_CONNECTION Maximum number of operations allowed per connection before the connection is closed.
static ConfigOption<String>	NODE_DISCOVERY_TYPE How Astyanax discovers Cassandra cluster nodes.
static ConfigOption<String>	RETRY_BACKOFF_STRATEGY If non-null, this must be the fully-qualified classname (i.e.
static ConfigOption<Integer>	RETRY_DELAY_SLICE Controls the retryDelaySlice parameter on Astyanax ConnectionPoolConfigurationImpl objects, which is in turn used by ExponentialRetryBackoffStrategy.
static ConfigOption<Integer>	RETRY_MAX_DELAY_SLICE Controls the retryMaxDelaySlice parameter on Astyanax ConnectionPoolConfigurationImpl objects, which is in turn used by ExponentialRetryBackoffStrategy.
static ConfigOption<String>	RETRY_POLICY In Astyanax, RetryPolicy and RetryBackoffStrategy sound and look similar but are used for distinct purposes.
static ConfigOption<Integer>	RETRY_SUSPEND_WINDOW Controls the retrySuspendWindow parameter on Astyanax ConnectionPoolConfigurationImpl objects, which is in turn used by ExponentialRetryBackoffStrategy.

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
AstyanaxStoreManager(Configuration config)

Method Summary

Modifier and Type	Method and Description
void	clearStorage()
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>> batch, StoreTransaction txh)
AstyanaxKeyColumnValueStore	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

ASTYANAX_NS

public static final ConfigNamespace ASTYANAX_NS

CLUSTER_NAME

public static final ConfigOption<String> CLUSTER_NAME

Default name for the Cassandra cluster

MAX_CONNECTIONS_PER_HOST

public static final ConfigOption<Integer> MAX_CONNECTIONS_PER_HOST

Maximum pooled connections per host.

MAX_CONNECTIONS

public static final ConfigOption<Integer> MAX_CONNECTIONS

Maximum open connections allowed in the pool (counting all hosts).

MAX_OPERATIONS_PER_CONNECTION

public static final ConfigOption<Integer> MAX_OPERATIONS_PER_CONNECTION

Maximum number of operations allowed per connection before the connection is closed.

MAX_CLUSTER_CONNECTIONS_PER_HOST

public static final ConfigOption<Integer> MAX_CLUSTER_CONNECTIONS_PER_HOST

Maximum pooled "cluster" connections per host.

These connections are mostly idle and only used for DDL operations (like creating keyspaces). Titan doesn't need many of these connections in ordinary operation.

NODE_DISCOVERY_TYPE

public static final ConfigOption<String> NODE_DISCOVERY_TYPE

How Astyanax discovers Cassandra cluster nodes. This must be one of the values of the Astyanax NodeDiscoveryType enum.

HOST_SUPPLIER

public static final ConfigOption<String> HOST_SUPPLIER

Astyanax specific host supplier useful only when discovery type set to DISCOVERY_SERVICE or TOKEN_AWARE. Excepts fully qualified class name which extends google.common.base.Supplier>.

CONNECTION_POOL_TYPE

public static final ConfigOption<String> CONNECTION_POOL_TYPE

Astyanax's connection pooler implementation. This must be one of the values of the Astyanax ConnectionPoolType enum.

RETRY_POLICY

public static final ConfigOption<String> RETRY_POLICY

In Astyanax, RetryPolicy and RetryBackoffStrategy sound and look similar but are used for distinct purposes. RetryPolicy is for retrying failed operations. RetryBackoffStrategy is for retrying attempts to talk to uncommunicative hosts. This config option controls RetryPolicy.

RETRY_BACKOFF_STRATEGY

public static final ConfigOption<String> RETRY_BACKOFF_STRATEGY

If non-null, this must be the fully-qualified classname (i.e. the complete package name, a dot, and then the class name) of an implementation of Astyanax's RetryBackoffStrategy interface. This string may be followed by a sequence of integers, separated from the full classname and from each other by commas; in this case, the integers are cast to native Java ints and passed to the class constructor as arguments. Here's an example setting that would instantiate an Astyanax FixedRetryBackoffStrategy with an delay interval of 1s and suspend time of 5s:

com.netflix.astyanax.connectionpool.impl.FixedRetryBackoffStrategy,1000,5000

If null, then Astyanax uses its default strategy, which is an ExponentialRetryBackoffStrategy instance. The instance parameters take Astyanax's built-in default values, which can be overridden via the following config keys:

• RETRY_DELAY_SLICE
• RETRY_MAX_DELAY_SLICE
• RETRY_SUSPEND_WINDOW

In Astyanax, RetryPolicy and RetryBackoffStrategy sound and look similar but are used for distinct purposes. RetryPolicy is for retrying failed operations. RetryBackoffStrategy is for retrying attempts to talk to uncommunicative hosts. This config option controls RetryBackoffStrategy.

RETRY_DELAY_SLICE

public static final ConfigOption<Integer> RETRY_DELAY_SLICE

Controls the retryDelaySlice parameter on Astyanax ConnectionPoolConfigurationImpl objects, which is in turn used by ExponentialRetryBackoffStrategy. See the code for ConnectionPoolConfigurationImpl, ExponentialRetryBackoffStrategy, and the javadoc for RETRY_BACKOFF_STRATEGY for more information.

This parameter is not meaningful for and has no effect on FixedRetryBackoffStrategy.

RETRY_MAX_DELAY_SLICE

public static final ConfigOption<Integer> RETRY_MAX_DELAY_SLICE

Controls the retryMaxDelaySlice parameter on Astyanax ConnectionPoolConfigurationImpl objects, which is in turn used by ExponentialRetryBackoffStrategy. See the code for ConnectionPoolConfigurationImpl, ExponentialRetryBackoffStrategy, and the javadoc for RETRY_BACKOFF_STRATEGY for more information.

This parameter is not meaningful for and has no effect on FixedRetryBackoffStrategy.

RETRY_SUSPEND_WINDOW

public static final ConfigOption<Integer> RETRY_SUSPEND_WINDOW

Controls the retrySuspendWindow parameter on Astyanax ConnectionPoolConfigurationImpl objects, which is in turn used by ExponentialRetryBackoffStrategy. See the code for ConnectionPoolConfigurationImpl, ExponentialRetryBackoffStrategy, and the javadoc for RETRY_BACKOFF_STRATEGY for more information.

This parameter is not meaningful for and has no effect on FixedRetryBackoffStrategy.

LOCAL_DATACENTER

public static final ConfigOption<String> LOCAL_DATACENTER

Constructor Detail

AstyanaxStoreManager

public AstyanaxStoreManager(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()

openDatabase

public AstyanaxKeyColumnValueStore openDatabase(String name)
                                         throws BackendException

Throws:

BackendException

mutateMany

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

Throws:

BackendException

getLocalKeyPartition

public List<KeyRange> getLocalKeyPartition()
                                    throws BackendException

Throws:

BackendException

clearStorage

public void clearStorage()
                  throws BackendException

Throws:

BackendException

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