org.apache.cassandra.schema

Class MigrationManager

java.lang.Object

org.apache.cassandra.schema.MigrationManager

public class MigrationManager
extends java.lang.Object

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	MigrationManager.MigrationsSerializer

Field Summary

Fields

Modifier and Type	Field and Description
static MigrationManager	instance

Method Summary

Modifier and Type	Method and Description
static void	announce(java.util.Collection<Mutation> schema)
static void	announce(Mutation change)
static Keyspaces.KeyspacesDiff	announce(SchemaTransformation transformation, boolean locally)
static void	announceNewKeyspace(KeyspaceMetadata ksm)
static void	announceNewKeyspace(KeyspaceMetadata ksm, boolean announceLocally)
static void	announceNewKeyspace(KeyspaceMetadata ksm, long timestamp, boolean announceLocally)
static void	announceNewTable(TableMetadata cfm)
static void	announceTableDrop(java.lang.String ksName, java.lang.String cfName, boolean announceLocally)
static void	announceTableUpdate(TableMetadata tm)
static void	announceTableUpdate(TableMetadata updated, boolean announceLocally)
static java.util.Optional<Mutation>	evolveSystemKeyspace(KeyspaceMetadata keyspace, long generation) We have a set of non-local, distributed system keyspaces, e.g.
static void	forceAnnounceNewTable(TableMetadata cfm) Announces the table even if the definition is already know locally.
static boolean	isReadyForBootstrap()
static void	resetLocalSchema() Clear all locally stored schema information and reset schema to initial state.
static void	scheduleSchemaPull(InetAddressAndPort endpoint, EndpointState state)
static void	setUptimeFn(java.util.function.LongSupplier supplier)
static void	waitUntilReadyForBootstrap()

Methods inherited from class java.lang.Object

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

Field Detail

instance

public static final MigrationManager instance

Method Detail

setUptimeFn

public static void setUptimeFn(java.util.function.LongSupplier supplier)

scheduleSchemaPull

public static void scheduleSchemaPull(InetAddressAndPort endpoint,
                                      EndpointState state)

isReadyForBootstrap

public static boolean isReadyForBootstrap()

waitUntilReadyForBootstrap

public static void waitUntilReadyForBootstrap()

announceNewKeyspace

public static void announceNewKeyspace(KeyspaceMetadata ksm)
                                throws ConfigurationException

Throws:

ConfigurationException

announceNewKeyspace

public static void announceNewKeyspace(KeyspaceMetadata ksm,
                                       boolean announceLocally)
                                throws ConfigurationException

Throws:

ConfigurationException

announceNewKeyspace

public static void announceNewKeyspace(KeyspaceMetadata ksm,
                                       long timestamp,
                                       boolean announceLocally)
                                throws ConfigurationException

Throws:

ConfigurationException

announceNewTable

public static void announceNewTable(TableMetadata cfm)

forceAnnounceNewTable

public static void forceAnnounceNewTable(TableMetadata cfm)

Announces the table even if the definition is already know locally. This should generally be avoided but is used internally when we want to force the most up to date version of a system table schema (Note that we don't know if the schema we force _is_ the most recent version or not, we just rely on idempotency to basically ignore that announce if it's not. That's why we can't use announceTableUpdate it would for instance delete new columns if this is not called with the most up-to-date version) Note that this is only safe for system tables where we know the id is fixed and will be the same whatever version of the definition is used.

announceTableUpdate

public static void announceTableUpdate(TableMetadata tm)

announceTableUpdate

public static void announceTableUpdate(TableMetadata updated,
                                       boolean announceLocally)

announceTableDrop

public static void announceTableDrop(java.lang.String ksName,
                                     java.lang.String cfName,
                                     boolean announceLocally)

announce

public static void announce(Mutation change)

announce

public static void announce(java.util.Collection<Mutation> schema)

announce

public static Keyspaces.KeyspacesDiff announce(SchemaTransformation transformation,
                                               boolean locally)

resetLocalSchema

public static void resetLocalSchema()

Clear all locally stored schema information and reset schema to initial state. Called by user (via JMX) who wants to get rid of schema disagreement.

evolveSystemKeyspace

public static java.util.Optional<Mutation> evolveSystemKeyspace(KeyspaceMetadata keyspace,
                                                                long generation)

We have a set of non-local, distributed system keyspaces, e.g. system_traces, system_auth, etc. (see SchemaConstants.REPLICATED_SYSTEM_KEYSPACE_NAMES), that need to be created on cluster initialisation, and later evolved on major upgrades (sometimes minor too). This method compares the current known definitions of the tables (if the keyspace exists) to the expected, most modern ones expected by the running version of C*; if any changes have been detected, a schema Mutation will be created which, when applied, should make cluster's view of that keyspace aligned with the expected modern definition.

Parameters:

keyspace - the expected modern definition of the keyspace

generation - timestamp to use for the table changes in the schema mutation

Returns:

empty Optional if the current definition is up to date, or an Optional with the Mutation that would bring the schema in line with the expected definition.