Instance operations - MaxCompute - Centro de documentación de Alibaba Cloud

Cuando usted envía un trabajo de SQL, Spark o MapReduce en MaxCompute, el sistema lo convierte en una instancia de MaxCompute. Cada instancia cuenta con un ID de instancia único y permanente. Utilice los comandos de este tema para listar instancias, consultar su estado, detener un trabajo en ejecución y obtener detalles y registros del trabajo.

Requisitos previos

Antes de empezar, asegúrese de contar con:

Permisos de lectura o escritura sobre las instancias (varían según la operación; consulte la tabla a continuación)
Acceso a una de estas plataformas:

Descripción general de operaciones

Operación	Comando	Permiso obligatorio
List instances	`show instances` / `ls instances`	Permiso de lectura sobre instancias o permiso LIST sobre objetos del proyecto
Query instance status	`status`	Permiso de lectura sobre instancias
View running instances	`top instance`	Permiso de lectura sobre instancias o permiso LIST sobre objetos del proyecto
Stop an instance	`kill`	Permiso de escritura sobre instancias
Obtener detalles del trabajo	`desc instance`	Permiso de lectura sobre instancias
Obtener registros del trabajo	`wait`

Listar instancias

Lista las instancias enviadas por usted o por todos los usuarios de un proyecto, con opciones para filtrar por rango de fechas, proyecto y cantidad.

Sintaxis

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];

Estas sentencias son equivalentes: show p, show proc, show processlist, show instances, ls instances y list instances.

Parámetros

Parámetro	Obligatorio	Descripción
`startdate`	No	Inicio del rango de fechas (inclusivo). Formato: `yyyy-mm-dd`. Debe ser anterior a `enddate`. El valor predeterminado es el día actual.
`enddate`	No	Fin del rango de fechas (exclusivo; no se incluyen las instancias enviadas ese día). Formato: `yyyy-mm-dd`. El valor predeterminado es el día actual.
`-p project_name`	No	Proyecto que se va a consultar. Debe tener permiso para consultar instancias en dicho proyecto. El valor predeterminado es el proyecto actual.
`-limit number`	No	Cantidad de instancias más recientes que se devolverán. `-limit <number>` y `<number>` son equivalentes.
`-all`	No	Devuelve instancias de todos los usuarios del proyecto. Sin esta opción, solo se devuelven sus propias instancias.

Comportamiento predeterminado: Si no se especifica -limit, se devuelven hasta 50 instancias.

Campos de salida

Campo	Descripción
StartTime	Hora en que se envió la instancia (precisión de segundos).
RunTime	Duración de la ejecución (en segundos).
Status	Estado actual de la instancia.
InstanceID	ID único de la instancia. Siempre está presente.
Owner	Cuenta de Alibaba Cloud que envió la instancia.
Query	Sentencia SQL asociada a la instancia. Aparece en blanco para instancias que no son SQL (como algunos trabajos internos del sistema).

Ejemplos

Liste todas las instancias que envió hoy:

show p;

Salida de ejemplo:

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

Liste sus instancias dentro de un rango de fechas específico, limitado a 10 resultados:

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

Salida de ejemplo:

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

Liste instancias de todos los usuarios en otro proyecto, filtradas por rango de fechas y limitadas a 10 resultados:

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

Salida de ejemplo:

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

Liste todas las instancias de usuarios en otro proyecto correspondientes al día de hoy, limitadas a 5 resultados:

show p -p doc_test_dev -all 5;

Salida de ejemplo:

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

Consultar el estado de una instancia

Devuelve el estado actual de una instancia específica.

Sintaxis

status <instance_id>;

Parámetros

Parámetro	Obligatorio	Descripción
`instance_id`	Sí	ID único de la instancia que se va a consultar.

Estados de la instancia

Estado	Significado
`Running`	La instancia se está ejecutando actualmente.
`Waiting`	La instancia está en cola y espera su ejecución.
`Success`	La instancia finalizó correctamente.
`Failed`	El trabajo falló. No se realizaron cambios en la tabla de destino.
`Cancelled`	La instancia se detuvo (por ejemplo, mediante un comando `kill`).
`Terminated`	El trabajo ha terminado (incluye `Success` y algunos estados de detención).

Si la instancia pertenece a otro usuario, este comando devuelve un error.

Ejemplo

-- Query the status of instance 20131225123xxxxxxxxxxxxxxx.
status 20131225123xxxxxxxxxxxxxxx;

Salida:

Success

Consultar instancias en ejecución

Lista las instancias que se ejecutan actualmente en un proyecto, incluido el uso de recursos y la posición en la cola.

Sintaxis

-- List running instances submitted by you in the current project.
top instance;

-- List all or a limited number of running instances in the current project.
top instance [-all] [-limit <number>];

Parámetros

Parámetro	Obligatorio	Descripción
`-all`	No	Devuelve las instancias en ejecución de todos los usuarios del proyecto. Valor predeterminado: hasta 50 instancias.
`-limit number`	No	Devuelve la cantidad especificada de instancias en ejecución.

Campos de salida: InstanceID, Owner, Type, StartTime, Progress, Status, Priority, RuntimeUsage (CPU/MEM), totalUsage (CPU/MEM), QueueingInfo (POS/LEN).

Ejemplo

-- Return the first five running instances in the current project.
top instance -limit 5;

Salida:

QueueingInstances: 0 total.

Detener una instancia

Detiene una instancia específica que se encuentra en estado Running.

Sintaxis

kill <instance_id>;

Parámetros

Parámetro	Obligatorio	Descripción
`instance_id`	Sí	ID único de la instancia que se va a detener. La instancia debe estar en estado `Running`; de lo contrario, se devuelve un error.

Importante

El comando kill es asíncrono. El comando responde inmediatamente después de que el sistema acepta la solicitud, pero es posible que el trabajo distribuido siga ejecutándose. Ejecute status <instance_id> para confirmar que la instancia se detuvo antes de continuar.

Ejemplo

-- Stop instance 20131225123xxxxxxxxxxxxxxx.
kill 20131225123xxxxxxxxxxxxxxx;

Obtener detalles del trabajo

Devuelve los detalles de un trabajo para una instancia específica, incluida la consulta SQL, el propietario, las horas de inicio y fin, y el estado.

Sintaxis

desc instance <instance_id>;

Parámetros

Parámetro	Obligatorio	Descripción
`instance_id`	Sí	ID único de la instancia.

Ejemplo

-- Get job details for instance 20150715xxxxxxxxxxxxxxx.
desc instance 20150715xxxxxxxxxxxxxxx;

Salida:

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;

Obtener registros del trabajo

Devuelve el registro operativo de una instancia específica, incluida la URL de Logview, el costo de recursos, los recuentos de registros de entrada y salida, y los detalles de las etapas Map/Reduce.

Sintaxis

wait <instance_id>;

Parámetros

Parámetro	Obligatorio	Descripción
`instance_id`	Sí	ID único de la instancia.

Logview solo está disponible para instancias creadas en los últimos tres días. Para instancias más antiguas, obtenga la URL de Logview desde sus registros.

Ejemplo

-- Get the operational log for instance 20170925161122379gxxxxxx.
wait 20170925161122379gxxxxxx;

Salida:

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)