com.aliyun.odps

Class Streams

java.lang.Object

com.aliyun.odps.Streams

All Implemented Interfaces:

Iterable<Stream>

public class Streams
extends Object
implements Iterable<Stream>

Stream 对象是ODPS中用于管理增量数据的对象，用户可以通过Stream对象对增量数据进行管理 Streams 对Stream对象进行管理

Method Summary

Modifier and Type	Method and Description
com.aliyun.odps.Streams.Builder	builder(StreamIdentifier identifier, TableIdentifier refTable)
void	create(StreamIdentifier identifier, TableIdentifier refTable) 创建一个stream，默认使用表的初始版本
void	create(StreamIdentifier identifier, TableIdentifier refTable, boolean ifNotExists, String timestamp, Long version, com.aliyun.odps.Streams.ReadMode readMode, String comment)
void	delete(String streamName)
void	delete(String streamName, boolean ifExists)
void	delete(String projectName, String streamName, boolean ifExists)
boolean	exists(StreamIdentifier identifier)
boolean	exists(String streamName) 判断指定表是否存在
boolean	exists(String projectName, String streamName) 判断指定表是否存在
Stream	get(StreamIdentifier identifier)
Stream	get(String streamName)
Stream	get(String projectName, String streamName)
Iterator<Stream>	iterator()
Iterator<Stream>	iterator(String projectName)

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Method Detail

get

public Stream get(String streamName)

get

public Stream get(StreamIdentifier identifier)

get

public Stream get(String projectName,
                  String streamName)

exists

public boolean exists(String streamName)
               throws OdpsException

判断指定表是否存在

Parameters:

streamName - 表名

Returns:

存在返回true, 否则返回false

Throws:

OdpsException

exists

public boolean exists(StreamIdentifier identifier)
               throws OdpsException

Throws:

OdpsException

exists

public boolean exists(String projectName,
                      String streamName)
               throws OdpsException

判断指定表是否存在

Parameters:

projectName - 所在Project名称

streamName - 表名

Returns:

存在返回true, 否则返回false

Throws:

OdpsException

create

public void create(StreamIdentifier identifier,
                   TableIdentifier refTable)
            throws OdpsException

创建一个stream，默认使用表的初始版本

Parameters:

identifier - stream信息StreamIdentifier

refTable - stream关联的ACID源表TableIdentifier

Throws:

OdpsException

create

public void create(StreamIdentifier identifier,
                   TableIdentifier refTable,
                   boolean ifNotExists,
                   String timestamp,
                   Long version,
                   com.aliyun.odps.Streams.ReadMode readMode,
                   String comment)
            throws OdpsException

Parameters:

identifier - stream信息StreamIdentifier

refTable - stream关联的ACID源表TableIdentifier

ifNotExists - true表示如果表已经存在，则不抛出异常，否则抛出异常

timestamp - 内部LSN序号, 代表Stream对象创建时VersionOffset初始化数据版本为t，查询范围为(t, 最新增量数据版本]

version - MC标准的TIMESTAMP/DATETIME/DATE类型格式, 代表Stream对象创建时VersionOffset初始化数据版本为v，查询范围为(v, 最新增量数据版本]

readMode - CDC模式或Append模式，目前仅支持Append模式

comment - 注释

Throws:

OdpsException - if sql task run failed

delete

public void delete(String streamName)
            throws OdpsException

Throws:

OdpsException

delete

public void delete(String streamName,
                   boolean ifExists)
            throws OdpsException

Throws:

OdpsException

delete

public void delete(String projectName,
                   String streamName,
                   boolean ifExists)
            throws OdpsException

Throws:

OdpsException

builder

public com.aliyun.odps.Streams.Builder builder(StreamIdentifier identifier,
                                               TableIdentifier refTable)

iterator

public Iterator<Stream> iterator()

Specified by:

iterator in interface Iterable<Stream>

iterator

public Iterator<Stream> iterator(String projectName)