MaxCompute Java SDK介紹

MaxCompute Java SDK介紹

MaxCompute提供了Java SDK，可以對實例、資源、表、函數等幾個方面進行操作。使用SDK調用MaxCompute產生的計算、存儲等費用與直接使用MaxCompute產生的費用一致。較爲常用的MaxCompute核心接口詳情請參見SDK Java Doc。

使用Maven管理配置新SDK的版本，Maven的配置示例如下：

<dependency>
  <groupId>com.aliyun.odps</groupId>
  <artifactId>odps-sdk-core</artifactId>
  <version>xxxx-public</version>
</dependency>

MaxCompute提供的SDK包整體信息，如下表所示：

包名	描述
odps-sdk-core	MaxCompute的基礎功能，例如對錶、Project的操作，以及Tunnel均在此包中。
odps-sdk-commons	一些Util封裝。
odps-sdk-udf	UDF功能的主體接口。
odps-sdk-mapred	MapReduce功能。
odps-sdk-graph	Graph Java SDK，搜索關鍵詞odps-sdk-graph。

MaxCompute Java SDK的一些使用示例爲：Java SDK使用示例。 

AliyunAccount

阿里雲認證賬號。輸入參數爲AccessKey ID及AccessKey Secret，是阿里雲用戶的身份標識和認證密鑰。此類用來初始化MaxCompute。

MaxCompute

MaxCompute SDK的入口，通過此類來獲取項目空間下的所有對象集合，包括：

• projects
• tables
• resources
• functions
• instances

通過傳入AliyunAccount實例來構造MaxCompute對象：

Account account = new AliyunAccount("my_access_id", "my_access_key");
Odps odps = new Odps(account);
String odpsUrl = "<your odps endpoint>";
odps.setEndpoint(odpsUrl);
odps.setDefaultProject("my_project");
for (Table t : odps.tables()) {
    ....
}              

Projects

Projects是MaxCompute中所有項目空間的集合。集合中的元素爲Project。Project是對項目空間信息的描述。您可以通過Projects獲取相應的項目空間。程序示例如下。

Account account = new AliyunAccount("my_access_id", "my_access_key");
Odps odps = new Odps(account);
String odpsUrl = "<your odps endpoint>";
odps.setEndpoint(odpsUrl);
Project p = odps.projects().get("my_exists");
p.reload();
Map<String, String> properties = prj.getProperties();
...

SQLTask

SQLTask是用於運行、處理SQL任務的接口。可以通過運行接口直接運行SQL（注意：每次只能提交運行一個SQL語句）。運行接口返回Instance實例，通過Instance獲取SQL的運行狀態及運行結果。程序示例如下。

import java.util.List;
import com.aliyun.odps.Instance;
import com.aliyun.odps.Odps;
import com.aliyun.odps.OdpsException;
import com.aliyun.odps.account.Account;
import com.aliyun.odps.account.AliyunAccount;
import com.aliyun.odps.data.Record;
import com.aliyun.odps.task.SQLTask;
public class testSql {
    private static final String accessId = "";
    private static final String accessKey = "";       
    private static final String endPoint = "http://service.odps.aliyun.com/api";
    private static final String project = "";
    private static final String sql = "select category from iris;";

    public static void main(String[] args) {
        Account account = new AliyunAccount(accessId, accessKey);
        Odps odps = new Odps(account);
        odps.setEndpoint(endPoint);
        odps.setDefaultProject(project);
        Instance i;
        try {
            i = SQLTask.run(odps, sql);
            i.waitForSuccess();
            List<Record> records = SQLTask.getResult(i);
            for(Record r:records){
                System.out.println(r.get(0).toString());
            }
        } catch (OdpsException e) {
            e.printStackTrace();
        }
    }
}

說明 創建表，需要通過SQLTask接口，而不是Table接口，將建表的語句傳入SQLTask。

Instances

Instances是MaxCompute中所有實例（Instance）的集合。集合中的元素爲Instance。程序示例如下。

Account account = new AliyunAccount("my_access_id", "my_access_key");
Odps odps = new Odps(account);
String odpsUrl = "<your odps endpoint>";
odps.setEndpoint(odpsUrl);
odps.setDefaultProject("my_project");
for (Instance i : odps.instances()) {
    ....
}

Instance是對實例信息的描述。可以通過Instances獲取相應的實例。程序示例如下。

Account account = new AliyunAccount("my_access_id", "my_access_key");
Odps odps = new Odps(account);
String odpsUrl = "<your odps endpoint>";
odps.setEndpoint(odpsUrl);
Instance instance= odps.instances().get("instance id");
Date startTime = instance.getStartTime();
Date endTime = instance.getEndTime();
...
Status instanceStatus = instance.getStatus();
String instanceStatusStr = null;

if (instanceStatus == Status.TERMINATED) {
    instanceStatusStr = TaskStatus.Status.SUCCESS.toString();
    Map<String, TaskStatus> taskStatus = instance.getTaskStatus();
    for (Entry<String, TaskStatus> status : taskStatus.entrySet()) {
        if (status.getValue().getStatus() != TaskStatus.Status.SUCCESS) {
            instanceStatusStr = status.getValue().getStatus().toString();
            break;
        }
    }
} else {
    instanceStatusStr = instanceStatus.toString();
}
...
TaskSummary summary = instance.getTaskSummary("task name");
String s = summary.getSummaryText();

Tables

Tables是MaxCompute中所有表的集合。集合中的元素爲Table。程序示例如下。

Account account = new AliyunAccount("my_access_id", "my_access_key");
Odps odps = new Odps(account);
String odpsUrl = "<your odps endpoint>";
odps.setEndpoint(odpsUrl);
odps.setDefaultProject("my_project");
for (Table t : odps.tables()) {
    ....
}

Table是對錶信息的描述。可以通過Tables獲取相應的表。程序示例如下。

Account account = new AliyunAccount("my_access_id", "my_access_key");
Odps odps = new Odps(account);
String odpsUrl = "<your odps endpoint>";
odps.setEndpoint(odpsUrl);
Table t = odps.tables().get("table name");
t.reload();
Partition part = t.getPartition(new PartitionSpec(tableSpec[1]));
part.reload();
...

Resources

Resources是MaxCompute中所有資源的集合。集合中的元素爲Resource。程序示例如下。

Account account = new AliyunAccount("my_access_id", "my_access_key");
Odps odps = new Odps(account);
String odpsUrl = "<your odps endpoint>";
odps.setEndpoint(odpsUrl);
odps.setDefaultProject("my_project");
for (Resource r : odps.resources()) {
    ....
}

Resource是對資源信息的描述。可以通過Resources獲取相應的資源。程序示例如下。

Account account = new AliyunAccount("my_access_id", "my_access_key");
Odps odps = new Odps(account);
String odpsUrl = "<your odps endpoint>";
odps.setEndpoint(odpsUrl);
Resource r = odps.resources().get("resource name");
r.reload();

if (r.getType() == Resource.Type.TABLE) {
    TableResource tr = new TableResource(r);
    String tableSource = tr.getSourceTable().getProject() + "."
        + tr.getSourceTable().getName();
    if (tr.getSourceTablePartition() != null) {
        tableSource += " partition(" + tr.getSourceTablePartition().toString()
            + ")";
    }
    ....
}

創建文件資源的示例，如下所示：

String projectName = "my_porject";
String source = "my_local_file.txt";
File file = new File(source);
InputStream is = new FileInputStream(file);
FileResource resource = new FileResource();
String name = file.getName();
resource.setName(name);
odps.resources().create(projectName, resource, is);

創建表資源的示例，如下所示：

TableResource resource = new TableResource(tableName, tablePrj, partitionSpec);
//resource.setName(INVALID_USER_TABLE);
resource.setName("table_resource_name");
odps.resources().update(projectName, resource);

Functions

Functions是MaxCompute中所有函數的集合。集合中的元素爲Function。程序示例如下。

Account account = new AliyunAccount("my_access_id", "my_access_key");
Odps odps = new Odps(account);
String odpsUrl = "<your odps endpoint>";
odps.setEndpoint(odpsUrl);
odps.setDefaultProject("my_project");
for (Function f : odps.functions()) {
    ....
}                

Function是對函數信息的描述。您可以通過Functions獲取相應的函數。程序示例如下。

Account account = new AliyunAccount("my_access_id", "my_access_key");
Odps odps = new Odps(account);
String odpsUrl = "<your odps endpoint>";
odps.setEndpoint(odpsUrl);
Function f = odps.functions().get("function name");
List<Resource> resources = f.getResources();               

創建函數的示例，如下所示：

String resources = "xxx:xxx";
String classType = "com.aliyun.odps.mapred.open.example.WordCount";
ArrayList<String> resourceList = new ArrayList<String>();
for (String r : resources.split(":")) {
    resourceList.add(r);
}
Function func = new Function();
func.setName(name);
func.setClassType(classType);
func.setResources(resourceList);
odps.functions().create(projectName, func);              

批量數據通道

MaxCompute Tunnel數據通道是基於Tunnel SDK編寫的。可以通過Tunnel向MaxCompute中上傳或者下載數據，詳細內容請參見批量數據通道。目前Tunnel僅支持表（不包括視圖View）和數據的上傳和下載。

MapReduce

MapReduce支持的MapReduce SDK請參見原生SDK概述。