IMemTable (IoTDB Server 0.13.2 API)

所有已知实现类:

AbstractMemTable, NotifyFlushMemTable, PrimitiveMemTable
```
public interface IMemTable
```
IMemTable is designed to store data points which are not flushed into TsFile yet. An instance of IMemTable maintains all series belonging to one StorageGroup, corresponding to one StorageGroupProcessor.
The concurrent control of IMemTable is based on the concurrent control of StorageGroupProcessor, i.e., Writing and querying operations must already have gotten writeLock and readLock respectively.

方法概要

所有方法实例方法抽象方法
限定符和类型	方法和说明
`void`	`addTextDataSize(long textDataIncrement)` only used when mem control enabled
`void`	`addTVListRamCost(long cost)` only used when mem control enabled
`boolean`	`checkIfChunkDoesNotExist(IDeviceID deviceId, String measurement)` must guarantee the device exists in the work memtable only used when mem control enabled
`void`	`clear()` putBack all the memory resources.
`IMemTable`	`copy()` Make a copy of this MemTable.
`void`	`delete(PartialPath path, PartialPath devicePath, long startTimestamp, long endTimestamp)` Delete data in it whose timestamp <= 'timestamp' and belonging to timeseries path.
`long`	`getCreatedTime()`
`long`	`getCurrentTVListSize(IDeviceID deviceId, String measurement)` only used when mem control enabled
`long`	`getMaxPlanIndex()`
`Map<IDeviceID,IWritableMemChunkGroup>`	`getMemTableMap()`
`long`	`getMinPlanIndex()`
`int`	`getSeriesNumber()`
`long`	`getTotalPointsNum()`
`long`	`getTVListsRamCost()` only used when mem control enabled
`void`	`insert(InsertRowPlan insertRowPlan)` insert into this memtable
`void`	`insertAlignedRow(InsertRowPlan insertRowPlan)`
`void`	`insertAlignedTablet(InsertTabletPlan insertTabletPlan, int start, int end)`
`void`	`insertTablet(InsertTabletPlan insertTabletPlan, int start, int end)` insert tablet into this memtable.
`boolean`	`isEmpty()`
`boolean`	`isSignalMemTable()`
`long`	`memSize()`
`ReadOnlyMemChunk`	`query(PartialPath fullPath, long ttlLowerBound, List<Pair<Modification,IMemTable>> modsToMemtable)`
`boolean`	`reachTotalPointNumThreshold()` only used when mem control enabled
`void`	`release()` release resource of this memtable
`void`	`releaseTextDataSize(long textDataDecrement)` only used when mem control enabled
`void`	`releaseTVListRamCost(long cost)` only used when mem control enabled
`void`	`setShouldFlush()`
`boolean`	`shouldFlush()`
`long`	`size()`
`void`	`write(IDeviceID deviceId, List<Integer> failedIndices, List<IMeasurementSchema> schemaList, long insertTime, Object[] objectValue)`
`void`	`write(InsertTabletPlan insertTabletPlan, int start, int end)` write data in the range [start, end).
`void`	`writeAlignedRow(IDeviceID deviceId, List<Integer> failedIndices, List<IMeasurementSchema> schemaList, long insertTime, Object[] objectValue)`
`void`	`writeAlignedTablet(InsertTabletPlan insertTabletPlan, int start, int end)`

方法详细资料

getMemTableMap

Map<IDeviceID,IWritableMemChunkGroup> getMemTableMap()

write

void write(IDeviceID deviceId,
           List<Integer> failedIndices,
           List<IMeasurementSchema> schemaList,
           long insertTime,
           Object[] objectValue)

writeAlignedRow

void writeAlignedRow(IDeviceID deviceId,
                     List<Integer> failedIndices,
                     List<IMeasurementSchema> schemaList,
                     long insertTime,
                     Object[] objectValue)

write
```
void write(InsertTabletPlan insertTabletPlan,
           int start,
           int end)
```
write data in the range [start, end). Null value in each column values will be replaced by the subsequent non-null value, e.g., {1, null, 3, null, 5} will be {1, 3, 5, null, 5}

writeAlignedTablet

void writeAlignedTablet(InsertTabletPlan insertTabletPlan,
                        int start,
                        int end)

size
```
long size()
```
返回:

the number of points

memSize
```
long memSize()
```
返回:

memory usage

addTVListRamCost
```
void addTVListRamCost(long cost)
```
only used when mem control enabled

releaseTVListRamCost
```
void releaseTVListRamCost(long cost)
```
only used when mem control enabled

getTVListsRamCost
```
long getTVListsRamCost()
```
only used when mem control enabled

reachTotalPointNumThreshold
```
boolean reachTotalPointNumThreshold()
```
only used when mem control enabled

返回:

whether the average number of points in each WritableChunk reaches the threshold

getSeriesNumber
```
int getSeriesNumber()
```

getTotalPointsNum
```
long getTotalPointsNum()
```

insert
```
void insert(InsertRowPlan insertRowPlan)
```
insert into this memtable

参数:

insertRowPlan - insertRowPlan

insertAlignedRow

void insertAlignedRow(InsertRowPlan insertRowPlan)

insertTablet
```
void insertTablet(InsertTabletPlan insertTabletPlan,
                  int start,
                  int end)
           throws WriteProcessException
```
insert tablet into this memtable. The rows to be inserted are in the range [start, end). Null value in each column values will be replaced by the subsequent non-null value, e.g., {1, null, 3, null, 5} will be {1, 3, 5, null, 5}

参数:

insertTabletPlan - insertTabletPlan

start - included

end - excluded

抛出:

WriteProcessException

insertAlignedTablet

void insertAlignedTablet(InsertTabletPlan insertTabletPlan,
                         int start,
                         int end)
                  throws WriteProcessException

抛出:: WriteProcessException

query

ReadOnlyMemChunk query(PartialPath fullPath,
                       long ttlLowerBound,
                       List<Pair<Modification,IMemTable>> modsToMemtable)
                throws IOException,
                       QueryProcessException,
                       MetadataException

抛出:: IOException; QueryProcessException; MetadataException

clear
```
void clear()
```
putBack all the memory resources.

isEmpty
```
boolean isEmpty()
```

delete
```
void delete(PartialPath path,
            PartialPath devicePath,
            long startTimestamp,
            long endTimestamp)
```
Delete data in it whose timestamp <= 'timestamp' and belonging to timeseries path. Only called for non-flushing MemTable.

参数:

path - the PartialPath the timeseries to be deleted.

devicePath - the device path of the timeseries to be deleted.

startTimestamp - the lower-bound of deletion time.

endTimestamp - the upper-bound of deletion time

copy
```
IMemTable copy()
```
Make a copy of this MemTable.

返回:

a MemTable with the same data as this one.

isSignalMemTable
```
boolean isSignalMemTable()
```

setShouldFlush
```
void setShouldFlush()
```

shouldFlush
```
boolean shouldFlush()
```

release
```
void release()
```
release resource of this memtable

checkIfChunkDoesNotExist

boolean checkIfChunkDoesNotExist(IDeviceID deviceId,
                                 String measurement)

must guarantee the device exists in the work memtable only used when mem control enabled

getCurrentTVListSize

long getCurrentTVListSize(IDeviceID deviceId,
                          String measurement)

only used when mem control enabled

addTextDataSize
```
void addTextDataSize(long textDataIncrement)
```
only used when mem control enabled

releaseTextDataSize
```
void releaseTextDataSize(long textDataDecrement)
```
only used when mem control enabled

getMaxPlanIndex
```
long getMaxPlanIndex()
```

getMinPlanIndex
```
long getMinPlanIndex()
```

getCreatedTime
```
long getCreatedTime()
```

接口 IMemTable

方法概要

方法详细资料

getMemTableMap

write

writeAlignedRow

write

writeAlignedTablet

size

memSize

addTVListRamCost

releaseTVListRamCost

getTVListsRamCost

reachTotalPointNumThreshold

getSeriesNumber

getTotalPointsNum

insert

insertAlignedRow

insertTablet

insertAlignedTablet

query

clear

isEmpty

delete

copy

isSignalMemTable

setShouldFlush

shouldFlush

release

checkIfChunkDoesNotExist

getCurrentTVListSize

addTextDataSize

releaseTextDataSize

getMaxPlanIndex

getMinPlanIndex

getCreatedTime