通过客户端命令操作您可以查看指定的实例信息、实例状态,停止实例以及获得实例任务运行日志信息等。

Show Instances/Show P

命令格式如下:
SHOW INSTANCES [FROM startdate TO enddate] [number];
SHOW P [FROM startdate TO enddate] [number];
SHOW INSTANCES [-all];
SHOW P [-all];
SHOW P -p <project name>;

行为说明如下:

返回由当前用户创建的实例信息。

参数说明如下:
  • startdateenddate:返回指定时间段内的实例,即从起始时间startdate到结束时间enddate的实例信息,需满足如下格式:yyyy-mm-dd,精度到天。可选参数,若不指定,返回您在三天内提交的实例。
  • number:指定返回实例的数量。依照时间排序,返回距离当前时间最近的number个实例信息。若不指定number,返回满足要求的所有实例信息。
  • -all:返回当前项目下所有执行过的实例,默认最大返回50条。注意执行该命令的用户需要有project的list权限。如需返回更多条记录,请使用-limit number参数,例如show p -all -limit 100表示返回当前项目下100条执行过的实例记录。
  • project name:项目名称,您使用的账号必须已经是项目成员。
  • 输出项包括:StartTime(时间精确到秒),RunTime(s),Status(实例状态),包括Waiting、Success、Failed、Running、Cancelled和Suspended。
InstanceID以及实例对应的SQL如下所示:
StartTime             RunTime  Status   InstanceID                    Owner       Query
2015-04-28 13:57:55   1s       Success  20150428xxxxxxxxxxxxxxxxxx   ALIYUN$xxxxx@aliyun-inner.com       select * from tab_pack_priv limit 20;
...    ...    ...    ...    ...    ...
...    ...    ...    ...    ...    ......
Instance 有以下 6 种状态:
  • Running:正在运行。
  • Success:成功结束。
  • Waiting:等待中。
  • Failed:作业失败,但是尚未改写目标表数据。
  • Suspended:挂起。
  • Cancelled:被中止。
说明 上述示例的命令在客户端运行。

Status Instance

命令格式如下:
status instance_id; -- instance_id: 实例的唯一标识符,指定查询哪个实例状态。
行为说明如下:
  • 返回指定实例的状态,状态包括Success、Failed、Running和Cancelled。
  • 如果此实例并非当前用户创建,则报异常返回。
示例如下:
odps@ $project_name>status 20131225123xxxxxxxxxxxxxxx;
Success
查看ID为20131225123xxxxxxxxxxxxxxx的实例状态,查询结果为Success。
说明 上述示例的命令在客户端运行。

Top Instance

命令格式如下:
top instance;或top instance -all;

行为说明如下:

权限要求:用户为项目Owner或管理员角色

top instance返回项目中当前云账号所提交的正在执行的作业信息,包括INSTANCEID | Owner | Type | StartTime | Progress | Status | Priority | RuntimeUsage(CPU/MEM)| TotalUsage(CPU/MEM)| QueueingInfo(POS/LEN)等。

top instance -all返回当前项目下所有正在执行的作业,默认最大返回50条。如需返回更多条记录,请使用-limit number参数。

示例如下:
odps@ $project_name>top instance;
说明 上述示例的命令在客户端运行。

Kill Instance

命令格式如下:
kill instance_id; --instance_id:实例的唯一标识符。必须是状态为Running的实例的ID,否则抛异常

行为说明如下:

停止您指定的实例,此实例的状态必须为Running。

示例如下:
odps@ $project_name>kill 20131225123xxxxxxxxxxxxxxx;
停止ID为20131225123xxxxxxxxxxxxxxx的实例。
说明
  • 上述示例的命令在客户端运行。
  • 此示例是一个异步的过程,在系统接受此请求并返回后,并不意味着分布式的作业已经停止,而只代表系统已接收到请求,因此还要用status命令查看此instance的状态后才可以确定。

Desc Instance

命令格式如下:
desc instance instance_id ; --instance_id:实例的唯一标识符

行为说明如下:

根据具体的实例ID获得作业信息,包括具体的SQL、owner、startime、endtime和status等信息。

示例如下:
odps@ $project_name> 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;
查询ID为20150715xxxxxxxxxxxxxxx的实例对应的作业信息。
说明 上述示例的命令在客户端运行。

Wait Instance

命令格式如下:
wait instance_id; --instance_id:实例的唯一标识符

行为说明如下:

根据具体的实例ID获得任务运行日志信息,包含logview链接,再通过查看logview可以获得任务的详细日志。

示例如下:
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)