apache-hive / 3.1.1 / reference / WebHCat_Reference_Jobs.html

列出工作 ID — GET 工作

Description

返回所有作业 ID 的列表。

Version: Hive 0.12.0 and later

Hive 版本 0.12.0 中引入了GET jobs。它等效于以前的版本中的GET queue
GET queue现在已弃用(HIVE-4443),并将在 Hive 0.14.0(HIVE-6432)中删除。

URL

http:// * www.myserver.com * /templeton/v1/jobs

Parameters

Name Description Required? Default
fields 如果 fields 设置为“ *”,则请求将返回作业的完整详细信息。如果缺少 fields ,将仅返回作业 ID。当前该值只能是“ *”,不允许使用其他值,并且会引发异常。 Optional None
showall 如果 showall 设置为“ true”,则请求将返回用户有权查看的所有作业,而不仅是属于该用户的作业。 Optional false
jobid 如果存在 jobid ,则仅返回其词典 ID 在字典上大于 jobid 的记录。例如,如果 jobid =“ job_201312091733_0001”,则返回其作业 ID 大于“ job_201312091733_0001”的作业。返回的记录数取决于 numrecords 的值。

在 Hive 0.13.0 之前的版本中,此参数不可用。 (请参见HIVE-5519。)
Hive 0.13.0 中的可选
numrecords 如果存在 jobidnumrecords 参数,则按字典 Sequences 对作业 ID 列表进行排序后,将返回出现在 jobid 之后的顶部* numrecords 记录。如果缺少 jobid 参数,并且存在 numrecords ,则按字典 Sequences 对作业 ID 列表进行排序后,将返回顶部的 numrecords *。如果存在 jobid 参数,并且缺少 numrecords ,则返回其作业 ID 大于 jobid 的所有记录。
在 Hive 0.13.0 之前的版本中,此参数不可用。 (请参阅HIVE-5519。)
Hive 0.13.0 中的可选 全部

standard parameters也被接受。

Results

根据用户指定的过滤条件,返回属于用户或用户有权查看的作业数组( showall =“ true”)。

数组中的每个元素都包括:

Name Description
id Job ID.
detail showall 设置为“ true”时的作业详细信息;否则为“ null”。有关其包含的详细信息的更多信息,请检查GET jobs/:jobid

Examples

Curl Command

% curl -s 'http://localhost:50111/templeton/v1/jobs?user.name=daijy'

JSON Output

[
{"id":"job_201304291205_0015","detail":null}
]

卷曲命令(显示全部)

% curl -s 'http://localhost:50111/templeton/v1/jobs?user.name=daijy&showall=true'

JSON 输出(显示全部)

[
{"id":"job_201304291205_0014","detail":null},
{"id":"job_201111111311_0015","detail":null},
]

卷曲命令(字段)

% curl -s 'http://localhost:50111/templeton/v1/jobs?user.name=daijy&fields=*'

JSON 输出(字段)

Hive 0.12.0 bug

在版本 0.12.0 中,fields 参数的 JSON 输出的第一行给出了父 jobid,而不是实际的 jobid(HIVE-5510)。下面的示例显示了正确的 Jobid,如版本 0.13.0 和更高版本中所示。

[{"id":"job_201304291205_0016",
  "detail":{
    "status":{
      "jobACLs":{
        "MODIFY_JOB":{"allAllowed":false,"aclstring":" "},
        "VIEW_JOB":{"allAllowed":false,"aclstring":" "}},
      "runState":2,
      "startTime":1367264912274,
      "schedulingInfo":"NA",
      "failureInfo":"NA",
      "jobPriority":"NORMAL",
      "username":"daijy",
      "jobID":{"id":16,"jtIdentifier":"201304291205"},
      "jobId":"job_201304291205_0016",
      "jobComplete":true},
    "profile":{
      "user":"daijy",
      "jobFile":"hdfs://localhost:8020/Users/daijy/hadoop-1.0.3/tmp/mapred/staging/
          daijy/.staging/job_201304291205_0016/job.xml",
      "url":"http://localhost:50030/jobdetails.jsp?jobid=job_201304291205_0016",
      "queueName":"default",
      "jobName":"word count",
      "jobID":{"id":16,"jtIdentifier":"201304291205"},
      "jobId":"job_201304291205_0016"},
      "id":"job_201304291205_0016",
      "parentId":"job_201304291205_0015",
      "percentComplete":"map 100% reduce 100%",
      "exitValue":0,
      "user":"daijy",
      "callback":"http://daijymacpro.local:57815/templeton/$jobId",
      "completed": "done",
      "userargs" => {
        "callback"  => null,
        "define"    => [],
        "enablelog" => "false",
        "execute"   => "select a,rand(b) from mynums",
        "file"      => null,
        "files"     => [],
        "statusdir" => null,
        "user.name" => "hadoopqa",
      },
    }]

Navigation Links

Previous: DELETE queue/:jobid
Next: GET jobs/:jobid

常规:WebHCat ReferenceWebHCat ManualHCatalog ManualHive Wiki 主页Hive 项目 site

替换已弃用的资源:GET queue