全部產品
Search
文件中心

MaxCompute:InstanceTunnel

更新時間:Jun 19, 2024

您可以通過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許可權控制