全部产品
Search
文档中心

云原生大数据计算服务 MaxCompute:InstanceTunnel

更新时间:Nov 01, 2023

您可以通过InstanceTunnel下载SELECT语句的SQL Instance的执行结果。

InstanceTunnel接口定义和说明

InstanceTunnel接口定义如下,详情请参见Java-sdk-doc

public class InstanceTunnel{
 public DownloadSession createDownloadSession(String projectName, String instanceID);
 public DownloadSession createDownloadSession(String projectName, String instanceID, boolean limitEnabled);
 public DownloadSession getDownloadSession(String projectName, String id);
 }

参数说明:

  • projectName:项目空间名称。

  • instanceID:Instance ID。关于Instance ID的查看方式,详情请参见查看实例信息

InstanceTunnel约束与限制

虽然InstanceTunnel提供了非常方便地获取Instance执行结果的方式,但是为了保护您的数据安全,此功能也受到了权限约束。

  • 使用InstanceTunnel下载数据时,如果数据条数不超过10000,则只要对该Instance有Read权限的用户即可使用。此行为与使用Restful API获取查询数据的行为一致。

  • 使用InstanceTunnel下载数据时,如果数据条数超过10000,则需要对Instance上的SQL查询语句中涉及到的所有源表进行权限检查,用户需要具有所有源表的Read权限才可使用。

  • 如果用户访问的Endpoint是公网对应的地址,具体公网Endpoint地址请参见Endpoint,会产生下载费用。

  • 用户使用公网Endpoint下载数据,如果已经开启下载权限检查,需要有Download数据对应的权限。具体授权明细请参见Download权限控制