org.rocksdb

接口 WalFilter

所有已知实现类:

AbstractWalFilter

public interface WalFilter

WALFilter allows an application to inspect write-ahead-log (WAL) records or modify their processing on recovery.

嵌套类概要

嵌套类

限定符和类型	接口和说明
static class	WalFilter.LogRecordFoundResult

方法概要

限定符和类型	方法和说明
void	columnFamilyLogNumberMap(java.util.Map<java.lang.Integer,java.lang.Long> cfLognumber, java.util.Map<java.lang.String,java.lang.Integer> cfNameId) Provide ColumnFamily->LogNumber map to filter so that filter can determine whether a log number applies to a given column family (i.e. that log hasn't been flushed to SST already for the column family).
WalFilter.LogRecordFoundResult	logRecordFound(long logNumber, java.lang.String logFileName, WriteBatch batch, WriteBatch newBatch) LogRecord is invoked for each log record encountered for all the logs during replay on logs on recovery.
java.lang.String	name() Returns a name that identifies this WAL filter.

方法详细资料

columnFamilyLogNumberMap

void columnFamilyLogNumberMap(java.util.Map<java.lang.Integer,java.lang.Long> cfLognumber,
                              java.util.Map<java.lang.String,java.lang.Integer> cfNameId)

Provide ColumnFamily->LogNumber map to filter so that filter can determine whether a log number applies to a given column family (i.e. that log hasn't been flushed to SST already for the column family).

We also pass in name>id map as only name is known during recovery (as handles are opened post-recovery). while write batch callbacks happen in terms of column family id.

参数:

cfLognumber - column_family_id to lognumber map

cfNameId - column_family_name to column_family_id map

logRecordFound

WalFilter.LogRecordFoundResult logRecordFound(long logNumber,
                                              java.lang.String logFileName,
                                              WriteBatch batch,
                                              WriteBatch newBatch)

LogRecord is invoked for each log record encountered for all the logs during replay on logs on recovery. This method can be used to: * inspect the record (using the batch parameter) * ignoring current record (by returning WalProcessingOption::kIgnoreCurrentRecord) * reporting corrupted record (by returning WalProcessingOption::kCorruptedRecord) * stop log replay (by returning kStop replay) - please note that this implies discarding the logs from current record onwards.

参数:

logNumber - log number of the current log. Filter might use this to determine if the log record is applicable to a certain column family.

logFileName - log file name - only for informational purposes

batch - batch encountered in the log during recovery

newBatch - new batch to populate if filter wants to change the batch (for example to filter some records out, or alter some records). Please note that the new batch MUST NOT contain more records than original, else recovery would be failed.

返回:

Processing option for the current record.

name

java.lang.String name()

Returns a name that identifies this WAL filter. The name will be printed to LOG file on start up for diagnosis.

返回:

the name