org.apache.cassandra.db

Class SystemKeyspace

java.lang.Object

org.apache.cassandra.db.SystemKeyspace

public class SystemKeyspace
extends java.lang.Object

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SystemKeyspace.BootstrapState

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	BATCHLOG_CF
static java.lang.String	COMPACTION_LOG
static java.lang.String	COUNTER_ID_CF
static java.lang.String	HINTS_CF
static java.lang.String	INDEX_CF
static java.lang.String	LOCAL_CF
static java.lang.String	PAXOS_CF
static java.lang.String	PEER_EVENTS_CF
static java.lang.String	PEERS_CF
static java.lang.String	RANGE_XFERS_CF
static java.lang.String	SCHEMA_COLUMNFAMILIES_CF
static java.lang.String	SCHEMA_COLUMNS_CF
static java.lang.String	SCHEMA_KEYSPACES_CF
static java.lang.String	SCHEMA_TRIGGERS_CF

Constructor Summary

Constructors

Constructor and Description
SystemKeyspace()

Method Summary

Methods

Modifier and Type	Method and Description
static boolean	bootstrapComplete()
static boolean	bootstrapInProgress()
static void	checkHealth() One of three things will happen if you try to read the system keyspace: 1.
static void	discardCompactionsInProgress()
static void	finishCompaction(java.util.UUID taskId)
static void	finishStartup()
static void	forceBlockingFlush(java.lang.String cfname)
static SystemKeyspace.BootstrapState	getBootstrapState()
static CounterId	getCurrentLocalCounterId() Read the current local node id from the system keyspace or null if no such node id is recorded.
static java.util.UUID	getLocalHostId() Read the host ID from the system keyspace, creating (and storing) one if none exists.
static java.util.List<CounterId.CounterIdRecord>	getOldLocalCounterIds()
static java.net.InetAddress	getPreferredIP(java.net.InetAddress ep)
static java.util.Collection<Token>	getSavedTokens()
static java.util.Map<DecoratedKey,ColumnFamily>	getSchema(java.lang.String cfName)
static java.nio.ByteBuffer	getSchemaKSKey(java.lang.String ksName)
static java.util.Map<java.util.UUID,Pair<ReplayPosition,java.lang.Long>>	getTruncationRecords()
static com.google.common.collect.SetMultimap<Pair<java.lang.String,java.lang.String>,java.lang.Integer>	getUnfinishedCompactions()
static int	incrementAndGetGeneration()
static boolean	isIndexBuilt(java.lang.String keyspaceName, java.lang.String indexName)
static java.util.Map<java.net.InetAddress,java.util.Map<java.lang.String,java.lang.String>>	loadDcRackInfo() Return a map of IP addresses containing a map of dc and rack info
static java.util.Map<java.net.InetAddress,java.util.UUID>	loadHostIds() Return a map of store host_ids to IP addresses
static PaxosState	loadPaxosState(java.nio.ByteBuffer key, CFMetaData metadata)
static com.google.common.collect.SetMultimap<java.net.InetAddress,Token>	loadTokens() Return a map of stored tokens to IP addresses
static Row	readSchemaRow(java.lang.String ksName)
static Row	readSchemaRow(java.lang.String schemaCfName, java.lang.String ksName, java.lang.String cfName) Fetches a subset of schema (table data, columns metadata or triggers) for the keyspace+table pair.
static void	removeEndpoint(java.net.InetAddress ep) Remove stored tokens being used by another node
static void	removeTruncationRecord(java.util.UUID cfId) This method is used to remove information about truncation time for specified column family
static void	savePaxosCommit(Commit commit, java.util.UUID inProgressBallot)
static void	savePaxosPromise(Commit promise)
static void	savePaxosProposal(Commit commit)
static void	saveTruncationRecord(ColumnFamilyStore cfs, long truncatedAt, ReplayPosition position)
static ColumnFamilyStore	schemaCFS(java.lang.String cfName)
static java.util.List<Row>	serializedSchema()
static java.util.List<Row>	serializedSchema(java.lang.String schemaCfName)
static java.util.Collection<RowMutation>	serializeSchema()
static void	setBootstrapState(SystemKeyspace.BootstrapState state)
static void	setIndexBuilt(java.lang.String keyspaceName, java.lang.String indexName)
static void	setIndexRemoved(java.lang.String keyspaceName, java.lang.String indexName)
static java.util.UUID	startCompaction(ColumnFamilyStore cfs, java.lang.Iterable<SSTableReader> toCompact) Write compaction log, except columfamilies under system keyspace.
static void	updateHintsDropped(java.net.InetAddress ep, java.util.UUID timePeriod, int value)
static java.util.Collection<Token>	updateLocalTokens(java.util.Collection<Token> addTokens, java.util.Collection<Token> rmTokens) Convenience method to update the list of tokens in the local system keyspace.
static void	updatePeerInfo(java.net.InetAddress ep, java.lang.String columnName, java.lang.String value)
static void	updatePreferredIP(java.net.InetAddress ep, java.net.InetAddress preferred_ip)
static void	updateSchemaVersion(java.util.UUID version)
static void	updateTokens(java.util.Collection<Token> tokens) This method is used to update the System Keyspace with the new tokens for this node
static void	updateTokens(java.net.InetAddress ep, java.util.Collection<Token> tokens) Record tokens being used by another node
static void	writeCurrentLocalCounterId(CounterId newCounterId, long now) Write a new current local node id to the system keyspace.

Methods inherited from class java.lang.Object

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

Field Detail

PEERS_CF

public static final java.lang.String PEERS_CF

See Also:

Constant Field Values

PEER_EVENTS_CF

public static final java.lang.String PEER_EVENTS_CF

See Also:

Constant Field Values

LOCAL_CF

public static final java.lang.String LOCAL_CF

See Also:

Constant Field Values

INDEX_CF

public static final java.lang.String INDEX_CF

See Also:

Constant Field Values

COUNTER_ID_CF

public static final java.lang.String COUNTER_ID_CF

See Also:

Constant Field Values

HINTS_CF

public static final java.lang.String HINTS_CF

See Also:

Constant Field Values

RANGE_XFERS_CF

public static final java.lang.String RANGE_XFERS_CF

See Also:

Constant Field Values

BATCHLOG_CF

public static final java.lang.String BATCHLOG_CF

See Also:

Constant Field Values

SCHEMA_KEYSPACES_CF

public static final java.lang.String SCHEMA_KEYSPACES_CF

See Also:

Constant Field Values

SCHEMA_COLUMNFAMILIES_CF

public static final java.lang.String SCHEMA_COLUMNFAMILIES_CF

See Also:

Constant Field Values

SCHEMA_COLUMNS_CF

public static final java.lang.String SCHEMA_COLUMNS_CF

See Also:

Constant Field Values

SCHEMA_TRIGGERS_CF

public static final java.lang.String SCHEMA_TRIGGERS_CF

See Also:

Constant Field Values

COMPACTION_LOG

public static final java.lang.String COMPACTION_LOG

See Also:

Constant Field Values

PAXOS_CF

public static final java.lang.String PAXOS_CF

See Also:

Constant Field Values

Constructor Detail

SystemKeyspace

public SystemKeyspace()

Method Detail

finishStartup

public static void finishStartup()

startCompaction

public static java.util.UUID startCompaction(ColumnFamilyStore cfs,
                             java.lang.Iterable<SSTableReader> toCompact)

Write compaction log, except columfamilies under system keyspace.

Parameters:

cfs -

toCompact - sstables to compact

Returns:

compaction task id or null if cfs is under system keyspace

finishCompaction

public static void finishCompaction(java.util.UUID taskId)

getUnfinishedCompactions

public static com.google.common.collect.SetMultimap<Pair<java.lang.String,java.lang.String>,java.lang.Integer> getUnfinishedCompactions()

Returns:

unfinished compactions, grouped by keyspace/columnfamily pair.

discardCompactionsInProgress

public static void discardCompactionsInProgress()

saveTruncationRecord

public static void saveTruncationRecord(ColumnFamilyStore cfs,
                        long truncatedAt,
                        ReplayPosition position)

removeTruncationRecord

public static void removeTruncationRecord(java.util.UUID cfId)

This method is used to remove information about truncation time for specified column family

getTruncationRecords

public static java.util.Map<java.util.UUID,Pair<ReplayPosition,java.lang.Long>> getTruncationRecords()

updateTokens

public static void updateTokens(java.net.InetAddress ep,
                java.util.Collection<Token> tokens)

Record tokens being used by another node

updatePreferredIP

public static void updatePreferredIP(java.net.InetAddress ep,
                     java.net.InetAddress preferred_ip)

updatePeerInfo

public static void updatePeerInfo(java.net.InetAddress ep,
                  java.lang.String columnName,
                  java.lang.String value)

updateHintsDropped

public static void updateHintsDropped(java.net.InetAddress ep,
                      java.util.UUID timePeriod,
                      int value)

updateSchemaVersion

public static void updateSchemaVersion(java.util.UUID version)

removeEndpoint

public static void removeEndpoint(java.net.InetAddress ep)

Remove stored tokens being used by another node

updateTokens

public static void updateTokens(java.util.Collection<Token> tokens)

This method is used to update the System Keyspace with the new tokens for this node

updateLocalTokens

public static java.util.Collection<Token> updateLocalTokens(java.util.Collection<Token> addTokens,
                                            java.util.Collection<Token> rmTokens)

Convenience method to update the list of tokens in the local system keyspace.

Parameters:

addTokens - tokens to add

rmTokens - tokens to remove

Returns:

the collection of persisted tokens

forceBlockingFlush

public static void forceBlockingFlush(java.lang.String cfname)

loadTokens

public static com.google.common.collect.SetMultimap<java.net.InetAddress,Token> loadTokens()

Return a map of stored tokens to IP addresses

loadHostIds

public static java.util.Map<java.net.InetAddress,java.util.UUID> loadHostIds()

Return a map of store host_ids to IP addresses

getPreferredIP

public static java.net.InetAddress getPreferredIP(java.net.InetAddress ep)

loadDcRackInfo

public static java.util.Map<java.net.InetAddress,java.util.Map<java.lang.String,java.lang.String>> loadDcRackInfo()

Return a map of IP addresses containing a map of dc and rack info

checkHealth

public static void checkHealth()
                        throws ConfigurationException

One of three things will happen if you try to read the system keyspace: 1. files are present and you can read them: great 2. no files are there: great (new node is assumed) 3. files are present but you can't read them: bad

Throws:

ConfigurationException

getSavedTokens

public static java.util.Collection<Token> getSavedTokens()

incrementAndGetGeneration

public static int incrementAndGetGeneration()

getBootstrapState

public static SystemKeyspace.BootstrapState getBootstrapState()

bootstrapComplete

public static boolean bootstrapComplete()

bootstrapInProgress

public static boolean bootstrapInProgress()

setBootstrapState

public static void setBootstrapState(SystemKeyspace.BootstrapState state)

isIndexBuilt

public static boolean isIndexBuilt(java.lang.String keyspaceName,
                   java.lang.String indexName)

setIndexBuilt

public static void setIndexBuilt(java.lang.String keyspaceName,
                 java.lang.String indexName)

setIndexRemoved

public static void setIndexRemoved(java.lang.String keyspaceName,
                   java.lang.String indexName)

getLocalHostId

public static java.util.UUID getLocalHostId()

Read the host ID from the system keyspace, creating (and storing) one if none exists.

getCurrentLocalCounterId

public static CounterId getCurrentLocalCounterId()

Read the current local node id from the system keyspace or null if no such node id is recorded.

writeCurrentLocalCounterId

public static void writeCurrentLocalCounterId(CounterId newCounterId,
                              long now)

Write a new current local node id to the system keyspace.

Parameters:

newCounterId - the new current local node id to record

now - microsecond time stamp.

getOldLocalCounterIds

public static java.util.List<CounterId.CounterIdRecord> getOldLocalCounterIds()

schemaCFS

public static ColumnFamilyStore schemaCFS(java.lang.String cfName)

Parameters:

cfName - The name of the ColumnFamily responsible for part of the schema (keyspace, ColumnFamily, columns)

Returns:

CFS responsible to hold low-level serialized schema

serializedSchema

public static java.util.List<Row> serializedSchema()

serializedSchema

public static java.util.List<Row> serializedSchema(java.lang.String schemaCfName)

Parameters:

schemaCfName - The name of the ColumnFamily responsible for part of the schema (keyspace, ColumnFamily, columns)

Returns:

low-level schema representation (each row represents individual Keyspace or ColumnFamily)

serializeSchema

public static java.util.Collection<RowMutation> serializeSchema()

getSchema

public static java.util.Map<DecoratedKey,ColumnFamily> getSchema(java.lang.String cfName)

getSchemaKSKey

public static java.nio.ByteBuffer getSchemaKSKey(java.lang.String ksName)

readSchemaRow

public static Row readSchemaRow(java.lang.String ksName)

readSchemaRow

public static Row readSchemaRow(java.lang.String schemaCfName,
                java.lang.String ksName,
                java.lang.String cfName)

Fetches a subset of schema (table data, columns metadata or triggers) for the keyspace+table pair.

Parameters:

schemaCfName - the schema table to get the data from (schema_columnfamilies, schema_columns or schema_triggers)

ksName - the keyspace of the table we are interested in

cfName - the table we are interested in

Returns:

a Row containing the schema data of a particular type for the table

loadPaxosState

public static PaxosState loadPaxosState(java.nio.ByteBuffer key,
                        CFMetaData metadata)

savePaxosPromise

public static void savePaxosPromise(Commit promise)

savePaxosProposal

public static void savePaxosProposal(Commit commit)

savePaxosCommit

public static void savePaxosCommit(Commit commit,
                   java.util.UUID inProgressBallot)