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

查看实例信息

  • 命令格式
    SHOW INSTANCES [FROM startdate TO enddate] [number];
    SHOW P [FROM startdate TO enddate] [number];
    SHOW INSTANCES [-all];
    SHOW P [-all][-limit number];
    SHOW P -p <project_name>;
  • 功能说明
    返回由当前用户创建的实例信息。查询结果输出项包括:StartTime(时间精确到秒)、RunTime(s)、Status(实例状态)、InstanceID、实例所有者、Query(执行语句)。Instance有以下6种状态:
    • Running:正在运行。
    • Success:成功结束。
    • Waiting:等待中。
    • Failed:作业失败,但是尚未改写目标表数据。
    • Suspended:挂起。
    • Cancelled:被中止。
  • 参数说明
    • startdateenddate:返回指定时间段内提交的实例,即从起始时间startdate到结束时间enddate提交的实例信息,需满足格式yyyy-mm-dd,精度为天。可选参数,如果不指定,则返回您在三天内提交的实例。
    • number:指定返回实例的数量。依照时间排序,返回提交距离当前时间最近的number个实例信息。如果不指定number,则返回满足要求的所有实例信息。
    • -all:返回当前项目下所有执行过的实例,默认最大返回50条。注意执行该命令的用户需要有项目空间的List权限。如果需要返回更多条记录,请使用-limit number参数,例如show p -all -limit 100表示返回当前项目下100条执行过的实例记录。
    • project_name:项目空间名称,您使用的账号必须已经是项目成员。
InstanceID以及实例对应的SQL如下所示。
odps@ $project_name>SHOW P;
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;
...    ...    ...    ...    ...    ...
...    ...    ...    ...    ...    ...

查看实例状态

  • 命令格式
    STATUS instance_id;
  • 功能说明
    • 返回指定实例的状态,状态包括Success、Failed、Running和Cancelled。
    • 如果此实例并非当前用户创建,则返回报错。
  • 参数说明

    instance_id:实例的唯一标识符,指定查询哪个实例状态。

  • 示例
    --查看ID为20131225123xxxxxxxxxxxxxxx的实例状态。
    odps@ $project_name>STATUS 20131225123xxxxxxxxxxxxxxx;
    Success

查看正在执行的实例信息

执行此命令的用户需要为项目空间所有者(Project Owner)或项目管理员角色。

  • 命令格式
    TOP INSTANCE;
    TOP INSTANCE [-all][-limit number];
  • 功能说明
    • 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_id;
  • 功能说明
    停止指定的实例,此实例的状态必须为Running。
    说明 此命令是一个异步的过程,在系统接受此请求并返回后,并不意味着分布式的作业已经停止,而只代表系统已接收到请求,因此还要用STATUS命令查看此Instance的状态后才可以确定。
  • 参数说明

    instance_id:实例的唯一标识符。状态必须是Running的实例ID,否则返回异常。

  • 示例
    --停止ID为20131225123xxxxxxxxxxxxxxx的实例。
    odps@ $project_name>KILL 20131225123xxxxxxxxxxxxxxx;

获取实例对应的作业信息

  • 命令格式
    DESC INSTANCE instance_id;
  • 功能说明

    根据具体的实例ID获得作业信息,包括具体的SQL、Owner、StartTime、EndTime和Status等信息。

  • 参数说明

    instance_id:实例的唯一标识符。

  • 示例
    --查询ID为20150715xxxxxxxxxxxxxxx的实例对应的作业信息。
    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;

获取实例对应的作业运行日志信息

  • 命令格式
    WAIT instance_id;
  • 功能说明

    根据具体的实例ID获得作业的运行日志信息,包含Logview链接。您可以通过查看Logview获得作业的详细日志。

    说明 获取最近3天Instance对应的Logview可正常打开。超过3天的Instance对应Logview可获取,但因为过期被清除而无法打开。
  • 参数说明

    instance_id:实例的唯一标识符。

  • 示例
    --查看实例ID为20170925161122379gxxxxxx的作业运行日志信息。
    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)