com.aliyun.odps.tunnel

Class InstanceTunnel

java.lang.Object

com.aliyun.odps.tunnel.InstanceTunnel

public class InstanceTunnel
extends Object

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	InstanceTunnel.DownloadSession DownloadSession 表示从 ODPS Instance 中下载数据的会话，一般通过InstanceTunnel来创建。 Session ID 是 Session 的唯一标识符，可通过 InstanceTunnel.DownloadSession.getId() 获取。 Instance 中Record总数可通过 InstanceTunnel.DownloadSession.getRecordCount() 得到，用户可根据 Record 总数来启动并发下载。 DownloadSession 通过创建 RecordReader 来完成数据的读取,需指定读取记录的起始位置和数量 RecordReader 对应HTTP请求的超时时间为 300S，超时后 service 端会主动关闭。
static class	InstanceTunnel.DownloadStatus 下载会话的状态 UNKNOWN 未知 NORMAL 正常 CLOSED 关闭 EXPIRED 过期

Constructor Summary

Constructors

Constructor and Description
InstanceTunnel(Odps odps) 构造此类对象

Method Summary

Modifier and Type	Method and Description
InstanceTunnel.DownloadSession	createDownloadSession(String projectName, String instanceID) 在 Instance 上创建下载会话 非法情况: 1.
InstanceTunnel.DownloadSession	createDownloadSession(String projectName, String instanceID, boolean limitEnabled) 在 Instance 上创建下载会话 非法情况: 1.
InstanceTunnel.DownloadSession	getDownloadSession(String projectName, String id) 获得在Instance 上获取的下载会话
void	setEndpoint(String endpoint) 设置TunnelServer地址

Methods inherited from class java.lang.Object

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

Constructor Detail

InstanceTunnel

public InstanceTunnel(Odps odps)

构造此类对象

Parameters:

odps - Odps

Method Detail

createDownloadSession

public InstanceTunnel.DownloadSession createDownloadSession(String projectName,
                                                            String instanceID)
                                                     throws TunnelException

在 Instance 上创建下载会话 非法情况: 1. 非 SQlTask 2. 非 select sql 3. Task 非 Success 状态

Parameters:

projectName - Project名

instanceID - Instance ID

Returns:

InstanceTunnel.DownloadSession

Throws:

TunnelException

createDownloadSession

public InstanceTunnel.DownloadSession createDownloadSession(String projectName,
                                                            String instanceID,
                                                            boolean limitEnabled)
                                                     throws TunnelException

在 Instance 上创建下载会话 非法情况: 1. 非 SQlTask 2. 非 select sql 3. Task 非 Success 状态

Parameters:

projectName - Project名

instanceID - Instance ID

Returns:

InstanceTunnel.DownloadSession

Throws:

TunnelException

getDownloadSession

public InstanceTunnel.DownloadSession getDownloadSession(String projectName,
                                                         String id)
                                                  throws TunnelException

获得在Instance 上获取的下载会话

Parameters:

projectName - Project名

id - 下载会话ID InstanceTunnel.DownloadSession.getId()

Returns:

InstanceTunnel.DownloadSession

Throws:

TunnelException

setEndpoint

public void setEndpoint(String endpoint)

设置TunnelServer地址

没有设置TunnelServer地址的情况下, 自动选择

Parameters:

endpoint -