io.debezium.relational.history

Class AbstractDatabaseHistory

java.lang.Object

io.debezium.relational.history.AbstractDatabaseHistory

All Implemented Interfaces:

DatabaseHistory

Direct Known Subclasses:

FileDatabaseHistory, KafkaDatabaseHistory, MemoryDatabaseHistory

public abstract class AbstractDatabaseHistory
extends Object
implements DatabaseHistory

Author:

Randall Hauch

Field Summary

Fields

Modifier and Type	Field and Description
private HistoryRecordComparator	comparator
protected Configuration	config
protected org.slf4j.Logger	logger

Fields inherited from interface io.debezium.relational.history.DatabaseHistory

CONFIGURATION_FIELD_PREFIX_STRING

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractDatabaseHistory()

Method Summary

Modifier and Type	Method and Description
void	configure(Configuration config, HistoryRecordComparator comparator) Configure this instance.
void	record(Map<String,?> source, Map<String,?> position, String databaseName, Tables schema, String ddl) Record a change to the schema of the named database, and store it in the schema storage.
void	recover(Map<String,?> source, Map<String,?> position, Tables schema, DdlParser ddlParser) Recover the database schema to a known point in its history.
protected abstract void	recoverRecords(Tables schema, DdlParser ddlParser, Consumer<HistoryRecord> records)
void	start() Start the history.
void	stop() Stop recording history and release any resources acquired since DatabaseHistory.configure(Configuration, HistoryRecordComparator).
protected abstract void	storeRecord(HistoryRecord record)

Methods inherited from class java.lang.Object

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

Field Detail

logger

protected final org.slf4j.Logger logger

config

protected Configuration config

comparator

private HistoryRecordComparator comparator

Constructor Detail

AbstractDatabaseHistory

protected AbstractDatabaseHistory()

Method Detail

configure

public void configure(Configuration config,
                      HistoryRecordComparator comparator)

Description copied from interface: DatabaseHistory

Configure this instance.

Specified by:

configure in interface DatabaseHistory

Parameters:

config - the configuration for this history store

comparator - the function that should be used to compare history records during recovery; may be null if the default comparator is to be used

start

public void start()

Description copied from interface: DatabaseHistory

Start the history.

Specified by:

start in interface DatabaseHistory

record

public final void record(Map<String,?> source,
                         Map<String,?> position,
                         String databaseName,
                         Tables schema,
                         String ddl)

Description copied from interface: DatabaseHistory

Record a change to the schema of the named database, and store it in the schema storage.

Specified by:

record in interface DatabaseHistory

Parameters:

source - the information about the source database; may not be null

position - the point in history where these DDL changes were made, which may be used when recovering the schema to some point in history; may not be null

databaseName - the name of the database whose schema is being changed; may be null

schema - the current definition of the database schema; may not be null

ddl - the DDL statements that describe the changes to the database schema; may not be null

recover

public final void recover(Map<String,?> source,
                          Map<String,?> position,
                          Tables schema,
                          DdlParser ddlParser)

Description copied from interface: DatabaseHistory

Recover the database schema to a known point in its history. Note that it is possible to recover the database schema to a point in history that is earlier than what has been recorded. Likewise, when recovering to a point in history later than what was recorded, the database schema will reflect the latest state known to the history.

Specified by:

recover in interface DatabaseHistory

Parameters:

source - the information about the source database; may not be null

position - the point in history at which the database schema should be recovered; may not be null

schema - the table definitions that should be changed to reflect the database schema at the desired point in history; may not be null

ddlParser - the DDL parser that can be used to apply DDL statements to the given schema; may not be null

storeRecord

protected abstract void storeRecord(HistoryRecord record)

recoverRecords

protected abstract void recoverRecords(Tables schema,
                                       DdlParser ddlParser,
                                       Consumer<HistoryRecord> records)

stop

public void stop()

Description copied from interface: DatabaseHistory

Stop recording history and release any resources acquired since DatabaseHistory.configure(Configuration, HistoryRecordComparator).

Specified by:

stop in interface DatabaseHistory