com.aliyun.openservices.ots

类 DefaultOTSWriter

java.lang.Object

com.aliyun.openservices.ots.DefaultOTSWriter

所有已实现的接口:

OTSWriter

public class DefaultOTSWriter
extends Object
implements OTSWriter

构造器概要

构造器

构造器和说明
DefaultOTSWriter(OTSAsync ots, String tableName, com.aliyun.openservices.ots.internal.writer.WriterConfig config, com.aliyun.openservices.ots.internal.OTSCallback<RowChange,ConsumedCapacity> callback, Executor executor)

方法概要

限定符和类型	方法和说明
void	addRowChange(List<RowChange> rowChanges, List<RowChange> dirtyRows) 向本地缓冲区批量写入行。
void	addRowChange(RowChange rowChange) 向本地缓冲区增加一行数据。
void	close() 关闭OTSWriter，在关闭之前，会先flush掉缓冲区内的所有数据。
void	flush() 主动flush缓冲区中的数据，该函数会等待缓冲区中的所有数据被flush完毕。
com.aliyun.openservices.ots.internal.OTSCallback<RowChange,ConsumedCapacity>	getCallback() 获取设置的Callback。
long	getTotalRPCCount()
com.aliyun.openservices.ots.internal.writer.WriterConfig	getWriterConfig() 获取限制项配置。
void	setCallback(com.aliyun.openservices.ots.internal.OTSCallback<RowChange,ConsumedCapacity> callback) 设置Callback，数据写入成功或者失败均会通过Callback来反馈。
void	startFlushTimer(int flushInterval)

从类继承的方法 java.lang.Object

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

构造器详细资料

DefaultOTSWriter

public DefaultOTSWriter(OTSAsync ots,
                        String tableName,
                        com.aliyun.openservices.ots.internal.writer.WriterConfig config,
                        com.aliyun.openservices.ots.internal.OTSCallback<RowChange,ConsumedCapacity> callback,
                        Executor executor)

方法详细资料

getTotalRPCCount

public long getTotalRPCCount()

startFlushTimer

public void startFlushTimer(int flushInterval)

addRowChange

public void addRowChange(RowChange rowChange)

从接口复制的说明: OTSWriter

向本地缓冲区增加一行数据。 在写入缓冲区之前，会对该行数据做如下检查： - 该行的主键的Schema是否与表定义的相同。 - 该行的主键列或属性列的值大小是否超过限制，值的限制配置在WriterConfig.maxPKColumnSize和WriterConfig.maxAttrColumnSize。 - 该行的属性列的个数是否超过WriterConfig.maxColumnsCount。 - 该行的大小是否超过WriterConfig.maxBatchSize。 - 属性列中是否有列名与主键列相同。 若在写入缓冲区之前被判定为脏数据，该部分数据不会触发CallBack的调用。 以上检查会在SDK端带来额外的CPU消耗，但是这些检查是必要的，为了减少不必要的RPC开销，以及避免脏数据污染同一批次Batch写入的行。 注意：若缓冲区满，则该操作会被block。 若判断该行为脏数据，该接口会抛出ClientException。

指定者:

addRowChange 在接口中 OTSWriter

参数:

rowChange - 要写入的行

addRowChange

public void addRowChange(List<RowChange> rowChanges,
                         List<RowChange> dirtyRows)
                  throws ClientException

从接口复制的说明: OTSWriter

向本地缓冲区批量写入行。 批量写入的每一行会做与OTSWriter.addRowChange(RowChange)一样的检查，若批量写入的行中存在脏数据，则该函数会抛ClientException， 且所有的脏数据会写入dirtyRows。

指定者:

addRowChange 在接口中 OTSWriter

参数:

rowChanges - 批量写入的行

dirtyRows - 用于传出脏数据的列表

抛出:

ClientException - 若存在脏数据

setCallback

public void setCallback(com.aliyun.openservices.ots.internal.OTSCallback<RowChange,ConsumedCapacity> callback)

从接口复制的说明: OTSWriter

设置Callback，数据写入成功或者失败均会通过Callback来反馈。 注意：callback会被写入OTSWriter的所有行共享，会被并发的调用。 这与OTSAsync中每个接口的Callback不同，其callback会与每个请求一一对应，且可以是独立的。 但是这里的Callback是与RowChange对应，且所有RowChange都共享该callback。

指定者:

setCallback 在接口中 OTSWriter

getCallback

public com.aliyun.openservices.ots.internal.OTSCallback<RowChange,ConsumedCapacity> getCallback()

从接口复制的说明: OTSWriter

获取设置的Callback。

指定者:

getCallback 在接口中 OTSWriter

返回:

callback

getWriterConfig

public com.aliyun.openservices.ots.internal.writer.WriterConfig getWriterConfig()

从接口复制的说明: OTSWriter

获取限制项配置。

指定者:

getWriterConfig 在接口中 OTSWriter

返回:

限制项配置

flush

public void flush()
           throws ClientException

从接口复制的说明: OTSWriter

主动flush缓冲区中的数据，该函数会等待缓冲区中的所有数据被flush完毕。 注意：若在调用flush之后继续向缓冲区中写入数据，flush不会等待这部分新数据的写入，新数据的flush需要重新调用一次flush。

指定者:

flush 在接口中 OTSWriter

抛出:

ClientException

close

public void close()

从接口复制的说明: OTSWriter

关闭OTSWriter，在关闭之前，会先flush掉缓冲区内的所有数据。 注意：若在close过程中或者close之后仍然调用OTSWriter.addRowChange(com.aliyun.openservices.ots.model.RowChange)向缓冲区写入数据，则该部分数据不保证会写入OTS。

指定者:

close 在接口中 OTSWriter