Maxcompute instance related operations

adopt MaxCompute The submitted SQL、Spark and MapReduce Wait for the job to instantiate , With MaxCompute example （Instance） There is a form of

MaxCompute Instances have corresponding instances ID, example ID Permanent validity , And globally unique .

View instance information

View instance information , Include StartTime（ Time to the second ）、RunTime（s）、Status（ Instance status ）、InstanceID、 Instance owner 、Query（ Execute statement ）.

command

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 and list instances Command is equivalent to .

Parameter description

• startdate、enddate： Optional . Return from start time startdate By the end of the day enddate Instance information submitted by users during ,startdate To be less than enddate. It doesn't contain enddate Instance information submitted on the same day . Format must be yyyy-mm-dd, Precision is days . If you don't specify , Then return the instance submitted by the user on the same day .

• project_name： Optional . The instance to be queried belongs to MaxCompute Project name , Need to have goals MaxCompute View instance permission of the project . If you don't specify , Then it indicates the current MaxCompute project .

• number： Optional . Specify the number of returned instances .

• Sort by time , Returns the closest submission time to the current time number Instance information . If you don't specify number, Then return all instance information that meets the requirements .-limit <number> And number The two are equivalent .

• -all： Optional . return MaxCompute Instances executed by all members of the project . If you don't specify , It means to return to MaxCompute Instances executed by the current user in the project .

  Not configured number when , Default max return 50 strip ; If the number, return number Instance information .

Examples of use

Example 1： View the current MaxCompute All instance information executed by the current user on the current day under the project . An example command is as follows .

show p;

Example 2： View the current MaxCompute The instance executed by the current user within the specified time period under the project , And specify the number of returned instances . An example command is as follows .

show instances from 2021-09-14 to 2021-09-15 -limit 10;

Example 3： See another MaxCompute Instances executed by all users in the specified time period under the project , And specify the number of returned instances . An example command is as follows .

ls instances from 2021-09-14 to 2021-09-15 -p doc_test_dev -all -limit 10;

Example 4： See another MaxCompute Instances executed by all users under the project on the same day , And specify the number of returned instances . An example command is as follows .

show p -p doc_test_dev -all 5;

View instance status

Set the end time of maintenance mode . If this instance is not created by the current user , An error is returned .

command

status <instance_id>;

Parameter description

instance_id： Required . Unique identifier of the instance , Specify which instance status to query .

Return results

Examples are as follows 6 States ：

• Running： Running .
• Success： A successful ending .
• Waiting： Waiting for the .
• Failed： Homework failed , But the target table data has not been overwritten .
• Cancelled： Be cancelled .
• Terminated： The job has been executed and ended .

Examples of use

-- see ID by 20131225123xxxxxxxxxxxxxxx Instance status of .
status 20131225123xxxxxxxxxxxxxxx;

View the instance information being executed

View the instance information being executed in the project , Include InstanceID、Owner、Type、StartTime、Progress、Status、Priority、RuntimeUsage（CPU/MEM）、totalUsage（CPU/MEM）、QueueingInfo（POS/LEN） etc. .

command

-- View the information of the instance being executed submitted by the current account in the current project .
top instance;
-- Returns the information of all or a specified number of instances being executed under the current project .
top instance [-all][-limit <number>];

Parameter description

• -all： Optional . Return all the executing jobs under the current project , Default max return 50 strip .
• -limit number： Optional . Returns the specified number of executing jobs under the current project .

Examples of use

-- Return to the previous 5 Information about the instance being executed .
top instance -limit 5;

Stop instance

Stop the specified instance , The status of the instance must be Running.

This command is an asynchronous process , After the system accepts the request and returns the result , It does not mean that distributed jobs have stopped , It can only represent that the system has received the request , Therefore, it is necessary to implement STATUS command , Check out this Instance Before you can determine whether the instance has been stopped .

command

kill <instance_id>;

Parameter description

instance_id： Unique identifier of the instance . The status must be Running Example , Otherwise, an exception is returned .

Examples of use

-- stop it ID by 20131225123xxxxxxxxxxxxxxx Example .
kill 20131225123xxxxxxxxxxxxxxx;

Get the job information corresponding to the instance

According to specific examples ID Get job information , Including specific SQL、Owner、StartTime、EndTime and Status Etc .

command

desc instance <instance_id>;

Parameter description

instance_id： Unique identifier of the instance .

Examples of use

-- Inquire about ID by 20150715xxxxxxxxxxxxxxx The job information corresponding to the instance of .
desc instance 20150715xxxxxxxxxxxxxxx;

Get the job running log information corresponding to the instance

According to specific examples ID Get the running log information of the job , contain Logview link . You can check it out Logview Get the detailed log of the job .

Get the latest 3 God Instance Corresponding Logview It can be opened normally . exceed 3 Days of Instance Corresponding Logview Available , But it cannot be opened because it is cleared after expiration .

command

wait <instance_id>;

Parameter description

instance_id： Unique identifier of the instance .

Examples of use

-- Check out the examples ID by 20170925161122379gxxxxxx Job run log information .
wait 20170925161122379gxxxxxx;

Reference link ：https://help.aliyun.com/document_detail/27830.htm