WebHCat 레퍼런스 - DELETE job

WebHCat REST API에서 작업 ID를 지정해 해당 작업을 종료(kill)하는 엔드포인트를 설명해요. DELETE queue/:jobid는 Hive 0.12.0에서 폐기(deprecated)되고 0.14.0에서 제거된 레거시 경로입니다.

출처: 문서

본문

설명 (Description)

작업 ID를 주어 작업을 종료합니다. ":jobid"를 작업 생성 시 받은 작업 ID로 바꿉니다.

버전: 0.12.0에서 폐기됨

DELETE queue/:jobid는 Hive 0.12.0 릴리스부터 폐기되었습니다. 사용자는 대신 DELETE jobs/:jobid를 사용하길 권장합니다. (HIVE-4443 참고.)

DELETE queue/:jobid는 DELETE jobs/:jobid와 동등합니다 – 문서는 DELETE jobs/:jobid를 확인하세요.

버전: 0.14.0에서 중복됨(Obsolete)

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

URL

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

파라미터 (Parameters)

Name	Description	Required?	Default
:jobid	삭제할 작업 ID. 작업 생성 시 받은 ID입니다.	Required	None

표준 파라미터(standard parameters)도 지원됩니다.

결과 (Results)

Name	Description
status	작업 상태 정보를 담은 JSON 객체. 자세한 내용은 Hadoop 문서(`Class JobStatus`)를 참고하세요.
profile	작업 프로파일 정보를 담은 JSON 객체. WebHCat은 JobProfile 객체의 정보를 그대로 전달하며, 이는 Hadoop 버전에 따라 달라질 수 있습니다. 자세한 내용은 org.apache.hadoop.mapred.JobProfile의 Hadoop 문서(API docs)를 참고하세요.
id	작업 ID.
parentId	부모 작업 ID.
percentComplete	작업 완료 백분율, 예: "75% complete".
exitValue	작업의 종료 값.
user	작업 생성자의 사용자 이름.
callback	콜백 URL(있는 경우).
completed	"done" 같은 완료 상태를 나타내는 문자열.

예제 (Example)

Curl 커맨드 (Curl Command)

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

JSON 출력 (JSON Output)

{
 "status": {
            "startTime": 1321047216471,
            "username": "ctdean",
            "jobID": {
                      "jtIdentifier": "201111111311",
                      "id": 9
                     },
            "jobACLs": {
                       },
            "schedulingInfo": "NA",
            "failureInfo": "NA",
            "jobId": "job_201111111311_0009",
            "jobPriority": "NORMAL",
            "runState": 1,
            "jobComplete": false
           },
 "profile": {
             "url": "http://localhost:50030/jobdetails.jsp?jobid=job_201111111311_0009",
             "user": "ctdean",
             "jobID": {
                       "jtIdentifier": "201111111311",
                       "id": 9
                      },
             "queueName": "default",
             "jobFile": "hdfs://localhost:9000/tmp/hadoop-ctdean/mapred/staging/ctdean/.staging/job_201111111311_0009/job.xml",
             "jobName": "streamjob3322518350676530377.jar",
             "jobId": "job_201111111311_0009"
            }
 "id": "job_201111111311_0009",
 "parentId": "job_201111111311_0008",
 "percentComplete": "10% complete",
 "exitValue": 0,
 "user": "ctdean",
 "callback": null,
 "completed": "false"
}

참고 (Note)

작업이 즉시 삭제되는 것은 아니므로, 이 예시처럼 반환된 정보가 삭제를 반영하지 않을 수 있습니다. GET queue/:jobid를 사용해 작업을 모니터링하고 결국 삭제되었는지 확인하세요.

네비게이션 링크 이전: GET queue/:jobid 다음: GET jobs

Hive 0.12.0에서 DELETE jobs/:jobid로 대체됨.

더 알아보기 (Learn more)

DELETE queue/:jobid는 WebHCat에서 작업을 종료하는 레거시 엔드포인트예요. 신규 코드에서는 DELETE jobs/:jobid를 쓰길 권장합니다. 응답에는 status·profile·id·percentComplete 같은 작업 정보가 JSON으로 담깁니다.