通過MaxCompute提交的SQL、Spark和MapReduce等作業(yè)會(huì)實(shí)例化，以MaxCompute實(shí)例（Instance）的形式存在。本文為您介紹如何查看指定的實(shí)例信息和實(shí)例狀態(tài)、停止實(shí)例以及獲得實(shí)例運(yùn)行日志信息等常用實(shí)例操作。
MaxCompute實(shí)例有對應(yīng)的實(shí)例ID，實(shí)例ID永久有效，且全局唯一。實(shí)例操作常用命令如下。
| 類型 | 功能 | 角色 | 操作入口 |
|---|---|---|---|
| 查看實(shí)例信息 | 查看實(shí)例信息。 | 具備查看實(shí)例權(quán)限（Read）的用戶或具備項(xiàng)目查看對象列表權(quán)限（List）的用戶。 | 本文中的命令您可以在如下工具平臺(tái)執(zhí)行： |
| 查看實(shí)例狀態(tài) | 查看指定實(shí)例的狀態(tài)。 | 具備查看實(shí)例權(quán)限（Read）的用戶。 | |
| 查看正在執(zhí)行的實(shí)例信息 | 查看項(xiàng)目中正在執(zhí)行的實(shí)例信息。 | 具備查看實(shí)例權(quán)限（Read）的用戶或具備項(xiàng)目查看對象列表權(quán)限（List）的用戶。 | |
| 停止實(shí)例 | 停止指定的處于Running狀態(tài)的實(shí)例。 | 具備更新實(shí)例權(quán)限（Write）的用戶。 | |
| 獲取實(shí)例對應(yīng)的作業(yè)信息 | 根據(jù)具體的實(shí)例ID獲取作業(yè)信息。 | 具備查看實(shí)例權(quán)限（Read）的用戶。 | |
| 獲取實(shí)例對應(yīng)的作業(yè)運(yùn)行日志信息 | 根據(jù)具體的實(shí)例ID獲取作業(yè)的運(yùn)行日志信息。 |
查看實(shí)例信息
查看實(shí)例信息，包括StartTime（時(shí)間精確到秒）、RunTime（s）、Status（實(shí)例狀態(tài)）、InstanceID、實(shí)例所有者、Query（執(zhí)行語句）。
- 命令格式
show p|proc|processlist|instances [from <startdate>] [to <enddate>] [-p <project_name>] [-limit <number> | <number>] [-all]; ls|list instances [from <startdate>] [to <enddate>] [-p <project_name>] [-limit <number> | <number>] [-all];show p、show proc、show processlist、show instances、ls instances和list instances命令等效。 - 參數(shù)說明
- startdate、enddate：可選。返回從起始時(shí)間startdate到結(jié)束時(shí)間enddate期間用戶提交的實(shí)例信息，startdate要小于enddate。不包含enddate當(dāng)天提交的實(shí)例信息。格式必須為
yyyy-mm-dd，精度為天。如果不指定，則返回用戶當(dāng)天提交的實(shí)例。 - project_name：可選。待查詢實(shí)例所屬的MaxCompute項(xiàng)目名稱，需要具備目標(biāo)MaxCompute項(xiàng)目的查看實(shí)例權(quán)限。如果不指定，則表示查詢當(dāng)前所處的MaxCompute項(xiàng)目。
- number：可選。指定返回實(shí)例的數(shù)量。
- 依照時(shí)間排序，返回提交時(shí)間距離當(dāng)前時(shí)間最近的number個(gè)實(shí)例信息。如果不指定number，則返回滿足要求的所有實(shí)例信息。
-limit <number>與number二者等效。 - -all：可選。返回MaxCompute項(xiàng)目中所有成員執(zhí)行過的實(shí)例。如果不指定，則表示返回MaxCompute項(xiàng)目中當(dāng)前用戶執(zhí)行過的實(shí)例。
不配置number時(shí)，默認(rèn)最大返回50條；如果配置了number，返回number個(gè)實(shí)例信息。
- startdate、enddate：可選。返回從起始時(shí)間startdate到結(jié)束時(shí)間enddate期間用戶提交的實(shí)例信息，startdate要小于enddate。不包含enddate當(dāng)天提交的實(shí)例信息。格式必須為
- 使用示例
- 示例1：查看當(dāng)前MaxCompute項(xiàng)目下當(dāng)前用戶當(dāng)天執(zhí)行的所有實(shí)例信息。命令示例如下。
返回結(jié)果如下。show p;StartTime RunTime Status InstanceID Owner Query 2021-09-14 11:43:04 0s Success 20210914**************3rw2 ALIYUN$****@test.aliyunid.com 2021-09-14 11:43:05 1s Success 20210914**************5t32 ALIYUN$****@test.aliyunid.com select date_sub(datetime '2005-03-01 00:00:00', 1); 2021-09-14 11:58:13 0s Success 20210914**************5pr2 ALIYUN$****@test.aliyunid.com 2021-09-14 11:58:15 1s Success 20210914**************5qgr ALIYUN$****@test.aliyunid.com select date_sub(date '2005-02-28', -1); 2021-09-14 12:02:15 1s Success 20210914**************h8o7 ALIYUN$****@test.aliyunid.com select date_sub('2008-03-01 00:00:00', 2); 2021-09-14 12:02:15 0s Success 20210914**************5t32 ALIYUN$****@test.aliyunid.com 2021-09-14 12:02:31 0s Success 20210914**************5pr2 ALIYUN$****@test.aliyunid.com 2021-09-14 12:02:32 0s Success 20210914**************euq2 ALIYUN$****@test.aliyunid.com select date_sub('2005-03-01 00:00:00', 2); 2021-09-14 13:35:42 0s Success 20210914**************1ms2 ALIYUN$****@test.aliyunid.com 2021-09-14 13:35:43 0s Success 20210914**************j8o7 ALIYUN$****@test.aliyunid.com select date_sub(getdate(),1); 2021-09-14 13:40:40 1s Success 20210914**************h3wz ALIYUN$****@test.aliyunid.com select date_sub(getdate(),0); 2021-09-14 13:40:40 0s Success 20210914**************9nm7 ALIYUN$****@test.aliyunid.com 12 instances - 示例2：查看當(dāng)前MaxCompute項(xiàng)目下當(dāng)前用戶在指定時(shí)間段內(nèi)執(zhí)行的實(shí)例，并指定返回實(shí)例數(shù)量。命令示例如下。
返回結(jié)果如下。show instances from 2021-09-14 to 2021-09-15 -limit 10;StartTime RunTime Status InstanceID Owner Query 2021-09-14 11:58:13 0s Success 20210914**************5pr2 ALIYUN$****@test.aliyunid.com 2021-09-14 11:58:15 1s Success 20210914**************5qgr ALIYUN$****@test.aliyunid.com select date_sub(date '2005-02-28', -1); 2021-09-14 12:02:15 1s Success 20210914**************h8o7 ALIYUN$****@test.aliyunid.com select date_sub('2008-03-01 00:00:00', 2); 2021-09-14 12:02:15 0s Success 20210914**************5t32 ALIYUN$****@test.aliyunid.com 2021-09-14 12:02:31 0s Success 20210914**************5pr2 ALIYUN$****@test.aliyunid.com 2021-09-14 12:02:32 0s Success 20210914**************euq2 ALIYUN$****@test.aliyunid.com select date_sub('2005-03-01 00:00:00', 2); 2021-09-14 13:35:42 0s Success 20210914**************1ms2 ALIYUN$****@test.aliyunid.com 2021-09-14 13:35:43 0s Success 20210914**************j8o7 ALIYUN$****@test.aliyunid.com select date_sub(getdate(),1); 2021-09-14 13:40:40 1s Success 20210914**************h3wz ALIYUN$****@test.aliyunid.com select date_sub(getdate(),0); 2021-09-14 13:40:40 0s Success 20210914**************9nm7 ALIYUN$****@test.aliyunid.com 10 instances - 示例3：查看另一MaxCompute項(xiàng)目下所有用戶在指定時(shí)間段內(nèi)執(zhí)行的實(shí)例，并指定返回實(shí)例數(shù)量。命令示例如下。
返回結(jié)果如下。ls instances from 2021-09-14 to 2021-09-15 -p doc_test_dev -all -limit 10;StartTime RunTime Status InstanceID Owner Query 2021-09-14 11:59:16 0s Success 20210914**************6pr3 ALIYUN$****@test.aliyunid.com 2021-09-14 11:59:20 1s Success 20210914**************6qgr ALIYUN$****@test.aliyunid.com select date_sub(date '2007-02-26', -1); 2021-09-14 12:02:19 1s Success 20210914**************h8o7 ALIYUN$****@test.aliyunid.com select date_sub('2009-03-01 00:00:00', 2); 2021-09-14 12:02:25 0s Success 20210914**************7t42 ALIYUN$****@test.aliyunid.com 2021-09-14 12:02:37 0s Success 20210914**************7pr2 ALIYUN$****@test.aliyunid.com 2021-09-14 12:02:40 0s Success 20210914**************emq2 ALIYUN$****@test.aliyunid.com select date_sub('2015-03-01 00:00:00', 2); 2021-09-14 13:35:42 0s Success 20210914**************1ms2 ALIYUN$****@test.aliyunid.com 2021-09-14 13:35:43 0s Success 20210914**************68o7 ALIYUN$kiki select date_sub(getdate(),1); 2021-09-14 13:45:40 1s Success 20210914**************73wz ALIYUN$kiki select date_sub(getdate(),0); 2021-09-14 13:45:45 0s Success 20210914**************9nm7 ALIYUN$dreak 10 instances - 示例4：查看另一MaxCompute項(xiàng)目下所有用戶在當(dāng)天執(zhí)行的實(shí)例，并指定返回實(shí)例數(shù)量。命令示例如下。
返回結(jié)果如下。show p -p doc_test_dev -all 5;StartTime RunTime Status InstanceID Owner Query 2021-09-14 12:02:40 0s Success 20210914**************emq2 ALIYUN$****@test.aliyunid.com select date_sub('2015-03-01 00:00:00', 2); 2021-09-14 13:35:42 0s Success 20210914**************1ms2 ALIYUN$****@test.aliyunid.com 2021-09-14 13:35:43 0s Success 20210914**************68o7 ALIYUN$kiki select date_sub(getdate(),1); 2021-09-14 13:45:40 1s Success 20210914**************73wz ALIYUN$kiki select date_sub(getdate(),0); 2021-09-14 13:45:45 0s Success 20210914**************9nm7 ALIYUN$dreak 5 instances
- 示例1：查看當(dāng)前MaxCompute項(xiàng)目下當(dāng)前用戶當(dāng)天執(zhí)行的所有實(shí)例信息。命令示例如下。
查看實(shí)例狀態(tài)
查看指定實(shí)例的狀態(tài)。如果此實(shí)例并非當(dāng)前用戶創(chuàng)建，則返回報(bào)錯(cuò)。
- 命令格式
status <instance_id>; - 參數(shù)說明
instance_id：必填。實(shí)例的唯一標(biāo)識符，指定查詢哪個(gè)實(shí)例狀態(tài)。
- 返回結(jié)果
實(shí)例有以下6種狀態(tài)：
- Running：正在運(yùn)行。
- Success：成功結(jié)束。
- Waiting：等待中。
- Failed：作業(yè)失敗，但是尚未改寫目標(biāo)表數(shù)據(jù)。
- Cancelled：被取消。
- Terminated：作業(yè)已執(zhí)行結(jié)束。
- 使用示例
返回結(jié)果如下。--查看ID為20131225123xxxxxxxxxxxxxxx的實(shí)例狀態(tài)。 status 20131225123xxxxxxxxxxxxxxx;Success
查看正在執(zhí)行的實(shí)例信息
查看項(xiàng)目中正在執(zhí)行的實(shí)例信息，包括InstanceID、Owner、Type、StartTime、Progress、Status、Priority、RuntimeUsage（CPU/MEM）、totalUsage（CPU/MEM）、QueueingInfo（POS/LEN）等。
- 命令格式
--查看當(dāng)前項(xiàng)目中當(dāng)前賬號所提交的正在執(zhí)行的實(shí)例信息。 top instance; --返回當(dāng)前項(xiàng)目下所有或指定數(shù)量的正在執(zhí)行的實(shí)例信息。 top instance [-all][-limit <number>]; - 參數(shù)說明
- -all：可選。返回當(dāng)前項(xiàng)目下所有正在執(zhí)行的作業(yè)，默認(rèn)最大返回50條。
- -limit number：可選。返回當(dāng)前項(xiàng)目下指定數(shù)量的正在執(zhí)行的作業(yè)。
- 使用示例
返回結(jié)果如下。--返回當(dāng)前項(xiàng)目下前5條正在執(zhí)行的實(shí)例信息。 top instance -limit 5;QueueingInstances: 0 total.
停止實(shí)例
停止指定的實(shí)例，實(shí)例的狀態(tài)必須為Running。
說明 此命令是一個(gè)異步的過程，在系統(tǒng)接受此請求并返回結(jié)果后，并不意味著分布式的作業(yè)已經(jīng)停止，只能代表系統(tǒng)已接收到請求，因此還要執(zhí)行
STATUS命令，查看此Instance的狀態(tài)后才可以確定是否已停止實(shí)例。
- 命令格式
kill <instance_id>; - 參數(shù)說明
instance_id：實(shí)例的唯一標(biāo)識符。狀態(tài)必須是Running的實(shí)例，否則返回異常。
- 使用示例
--停止ID為20131225123xxxxxxxxxxxxxxx的實(shí)例。 kill 20131225123xxxxxxxxxxxxxxx;
獲取實(shí)例對應(yīng)的作業(yè)信息
根據(jù)具體的實(shí)例ID獲取作業(yè)信息，包括具體的SQL、Owner、StartTime、EndTime和Status等信息。
- 命令格式
desc instance <instance_id>; - 參數(shù)說明
instance_id：實(shí)例的唯一標(biāo)識符。
- 使用示例
返回結(jié)果如下。--查詢ID為20150715xxxxxxxxxxxxxxx的實(shí)例對應(yīng)的作業(yè)信息。 desc instance 20150715xxxxxxxxxxxxxxx;ID 20150715xxxxxxxxxxxxxxx Owner ALIYUN$XXXXXX@alibaba-inc.com StartTime 2015-07-15 18:34:41 EndTime 2015-07-15 18:34:42 Status Terminated console_select_query_task_1436956481295 Success Query select * from mj_test;
獲取實(shí)例對應(yīng)的作業(yè)運(yùn)行日志信息
根據(jù)具體的實(shí)例ID獲取作業(yè)的運(yùn)行日志信息，包含Logview鏈接。您可以通過查看Logview獲得作業(yè)的詳細(xì)日志。
說明 獲取最近3天Instance對應(yīng)的Logview可正常打開。超過3天的Instance對應(yīng)Logview可獲取，但因?yàn)檫^期被清除而無法打開。
- 命令格式
wait <instance_id>; - 參數(shù)說明
instance_id：實(shí)例的唯一標(biāo)識符。
- 使用示例
返回結(jié)果如下。--查看實(shí)例ID為20170925161122379gxxxxxx的作業(yè)運(yùn)行日志信息。 wait 20170925161122379gxxxxxx;ID = 20170925161122379g3xxxxxx Log view: http://logview.odps.aliyun.com/logview/?h=http://service.odps.aliyun.com/api&p=alian&i=201709251611223xxxxxxdqp&token=XXXXXXvbiI6IjEifQ== Job Queueing... Summary: resource cost: cpu 0.05 Core * Min, memory 0.05 GB * Min inputs: alian.bank_data: 41187 (588232 bytes) outputs: alian.result_table: 8 (640 bytes) Job run time: 2.000 Job run mode: service job Job run engine: execution engine M1: instance count: 1 run time: 1.000 instance time: min: 1.000, max: 1.000, avg: 1.000 input records: TableScan_REL5213301: 41187 (min: 41187, max: 41187, avg: 41187 ) output records: StreamLineWrite_REL5213305: 8 (min: 8, max: 8, avg: 8) R2_1: instance count: 1 run time: 2.000 instance time: min: 2.000, max: 2.000, avg: 2.000 input records: StreamLineRead_REL5213306: 8 (min: 8, max: 8, avg: 8) output records: TableSink_REL5213309: 8 (min: 8, max: 8, avg: 8)