WebHCat Reference: GET queue/:jobid

WebHCat Reference: GET queue/:jobid (작업 정보)

설명 (Description)

작업 ID를 기준으로 작업의 상태와 관련 정보를 확인해요. :jobid를 작업 생성 시 받은 작업 ID로 바꿔서 호출하면 됩니다.

버전: 0.12.0에서 폐기(deprecated)

GET queue/:jobid는 Hive 릴리스 0.12.0부터 폐기되었어요. 대신 GET jobs/:jobid를 사용하는 것이 권장됩니다. (HIVE-4443 참조) GET queue/:jobid는 GET jobs/:jobid와 동일합니다.

버전: 0.14.0에서 구식(obsolete)

GET queue/:jobid는 Hive 릴리스 0.14.0에서 제거될 예정이에요. (HIVE-6432 참조) 대신 GET jobs/:jobid를 사용하세요.

출처: 문서

본문

URL

http://www.myserver.com/templeton/v1/queue/:jobid

파라미터 (Parameters)

Name Description Required? Default
:jobid The job ID to check. This is the ID received when the job was created. Required None

표준 파라미터도 지원돼요.

결과 (Results)

Name Description
status A JSON object containing the job status information. See the Hadoop documentation (Class JobStatus) for more information.
profile A JSON object containing the job profile information. WebHCat passes along the information in the JobProfile object, which is subject to change from one Hadoop version to another. See the Hadoop documentation (API docs) for org.apache.hadoop.mapred.JobProfile for more information.
id The job ID.
parentId The parent job ID.
percentComplete The job completion percentage, for example "75% complete".
exitValue The job's exit value.
user User name of the job creator.
callback The callback URL, if any.
completed A string representing completed status, for example "done".

예제 (Example)

Curl 명령 (Curl Command)

% curl -s 'http://localhost:50111/templeton/v1/queue/job_201112212038_0004?user.name=ctdean'

JSON 출력 (JSON Output)

{
 "status": {
            "startTime": 1324529476131,
            "username": "ctdean",
            "jobID": {
                      "jtIdentifier": "201112212038",
                      "id": 4
                     },
            "jobACLs": {
                       },
            "schedulingInfo": "NA",
            "failureInfo": "NA",
            "jobId": "job_201112212038_0004",
            "jobPriority": "NORMAL",
            "runState": 2,
            "jobComplete": true
           },
 "profile": {
             "url": "http://localhost:50030/jobdetails.jsp?jobid=job_201112212038_0004",
             "jobID": {
                       "jtIdentifier": "201112212038",
                        "id": 4
                      },
             "user": "ctdean",
             "queueName": "default",
             "jobFile": "hdfs://localhost:9000/tmp/hadoop-ctdean/mapred/staging/ctdean/.staging/job_201112212038_0004/job.xml",
             "jobName": "PigLatin:DefaultJobName",
             "jobId": "job_201112212038_0004"
            },
 "id": "job_201112212038_0004",
 "parentId": "job_201112212038_0003",
 "percentComplete": "100% complete",
 "exitValue": 0,
 "user": "ctdean",
 "callback": null,
 "completed": "done"
}

JSON 출력 (Hive 0.12.0 이상)

버전: Hive 0.12.0 이상

Hive 릴리스 0.12.0부터 GET queue/:jobid는 상태 정보뿐 아니라 사용자 인자(user arguments)도 반환해요 (HIVE-5031).

{
 "status": {
            "startTime": 1324529476131,
            ...
           },
 "profile": { ... },
 "id": "job_201112212038_0004",
 "parentId": "job_201112212038_0003",
 "percentComplete": "100% complete",
 "exitValue": 0,
 "user": "ctdean",
 "callback": null,
 "completed": "done",
 "userargs" => {
                "callback"  => null,
                "define"    => [],
                "enablelog" => "false",
                "execute"   => "select a,rand(b) from mynums",
                "file"      => null,
                "files"     => [],
                "statusdir" => null,
                "user.name" => "hadoopqa",
               },
}

Hive 0.12.0에서 GET jobs/:jobid로 대체되었어요.

더 알아보기 (Learn more)

GET queue/:jobid(작업 정보 조회)는 폐기된 리소스예요. 현재는 GET jobs/:jobid를 사용하는 것이 권장됩니다. 참고로 응답에는 작업 상태, 프로파일, 완료율 등이 JSON으로 포함돼요.