Package org.apache.cassandra.io.sstable.indexsummary

Class IndexSummaryManager<T extends SSTableReader & IndexSummarySupport<T>>

java.lang.Object

org.apache.cassandra.io.sstable.indexsummary.IndexSummaryManager<T>

All Implemented Interfaces:

IndexSummaryManagerMBean

public class IndexSummaryManager<T extends SSTableReader & IndexSummarySupport<T>>
extends java.lang.Object
implements IndexSummaryManagerMBean

Manages the fixed-size memory pool for index summaries, periodically resizing them in order to give more memory to hot sstables and less memory to cold sstables.

Field Summary

Fields

Modifier and Type	Field	Description
static IndexSummaryManager<?>	instance
static java.lang.String	MBEAN_NAME

Method Summary

Modifier and Type	Method	Description
double	getAverageIndexInterval()
java.util.Map<java.lang.String,java.lang.Integer>	getIndexIntervals()	Returns a map of SSTable filenames to their current effective index interval.
long	getMemoryPoolCapacityInMB()
double	getMemoryPoolSizeInMB()	Returns the actual space consumed by index summaries for all sstables.
int	getResizeIntervalInMinutes()
void	redistributeSummaries()
static <T extends SSTableReader & IndexSummarySupport> java.util.List<T>	redistributeSummaries(IndexSummaryRedistribution redistribution)	Attempts to fairly distribute a fixed pool of memory for index summaries across a set of SSTables based on their recent read rates.
void	setMemoryPoolCapacityInMB(long memoryPoolCapacityInMB)
void	setResizeIntervalInMinutes(int resizeIntervalInMinutes)	Set resizeIntervalInMinutes = -1 for disabled; This is the equivalent of index_summary_resize_interval being set to null in cassandra.yaml
void	shutdownAndWait(long timeout, java.util.concurrent.TimeUnit unit)

Methods inherited from class java.lang.Object

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

Field Detail

MBEAN_NAME

public static final java.lang.String MBEAN_NAME

See Also:

Constant Field Values

instance

public static final IndexSummaryManager<?> instance

Method Detail

getResizeIntervalInMinutes

public int getResizeIntervalInMinutes()

Specified by:

getResizeIntervalInMinutes in interface IndexSummaryManagerMBean

setResizeIntervalInMinutes

public void setResizeIntervalInMinutes(int resizeIntervalInMinutes)

Description copied from interface: IndexSummaryManagerMBean

Set resizeIntervalInMinutes = -1 for disabled; This is the equivalent of index_summary_resize_interval being set to null in cassandra.yaml

Specified by:

setResizeIntervalInMinutes in interface IndexSummaryManagerMBean

getMemoryPoolCapacityInMB

public long getMemoryPoolCapacityInMB()

Specified by:

getMemoryPoolCapacityInMB in interface IndexSummaryManagerMBean

getIndexIntervals

public java.util.Map<java.lang.String,java.lang.Integer> getIndexIntervals()

Description copied from interface: IndexSummaryManagerMBean

Returns a map of SSTable filenames to their current effective index interval.

Specified by:

getIndexIntervals in interface IndexSummaryManagerMBean

getAverageIndexInterval

public double getAverageIndexInterval()

Specified by:

getAverageIndexInterval in interface IndexSummaryManagerMBean

setMemoryPoolCapacityInMB

public void setMemoryPoolCapacityInMB(long memoryPoolCapacityInMB)

Specified by:

setMemoryPoolCapacityInMB in interface IndexSummaryManagerMBean

getMemoryPoolSizeInMB

public double getMemoryPoolSizeInMB()

Returns the actual space consumed by index summaries for all sstables.

Specified by:

getMemoryPoolSizeInMB in interface IndexSummaryManagerMBean

Returns:

space currently used in MB

redistributeSummaries

public void redistributeSummaries()
                           throws java.io.IOException

Specified by:

redistributeSummaries in interface IndexSummaryManagerMBean

Throws:

java.io.IOException

redistributeSummaries

public static <T extends SSTableReader & IndexSummarySupport> java.util.List<T> redistributeSummaries(IndexSummaryRedistribution redistribution)
                                                                                               throws java.io.IOException

Attempts to fairly distribute a fixed pool of memory for index summaries across a set of SSTables based on their recent read rates.

Parameters:

redistribution - encapsulating the transactions containing the sstables we are to redistribute the memory pool across and a size (in bytes) that the total index summary space usage should stay close to or under, if possible

Returns:

a list of new SSTableReader instances

Throws:

java.io.IOException

shutdownAndWait

public void shutdownAndWait(long timeout,
                            java.util.concurrent.TimeUnit unit)
                     throws java.lang.InterruptedException,
                            java.util.concurrent.TimeoutException

Throws:

java.lang.InterruptedException

java.util.concurrent.TimeoutException