Overview
Certain GQL operations, such as schema dropping, projection creation, and algorithm writeback, are designed to run as back-end jobs. The results of some jobs, such as files generated by algorithms, are stored in the graphs on which they are executed and can be retrieved later, unless cleared.
Showing Jobs
To retrieve all jobs in the current graph:
SHOW JOB
To retrieve the job with id 83 in the current graph:
SHOW JOB 83
It returns the following information for each job:
Field |
Description |
|---|---|
job_id |
Job ID. Some jobs have sub-jobs with ids <jobId>_1,<jobId>_2, and so on. |
graph_name |
The graph on which the job executes. |
type |
Job type, such as CREATE_INDEX, CACHE, COMPACT etc. |
query |
Query of the job. |
status |
Job status, which can be FINISHED, RUNNING, STOPPING, STOPPED or FAILED. |
err_msg |
Error message, if any, encountered during the job's execution. |
result |
Results generated by the job, such as output files or statistical summaries from an algorithm. |
start_time |
Start time of the job. |
end_time |
End time of the job. |
progress |
Progress updates for the job, such as indications that the write operation has been started. |
Stopping Jobs
To stop the running job with id 83 in the current graph:
STOP JOB 83
To stop all running jobs in the current graph:
STOP JOB *
Deleting Jobs
To delete all jobs in the current graph that are not running:
DELETE JOB *
To delete the job with ID 83 in the current graph, provided it is not running:
DELETE JOB 83