WebHCat 레퍼런스 – DDL

WebHCat(Templeton)의 DDL 리소스는 HCatalog DDL 명령을 실행해요. 요청 즉시 명령이 실행되고 응답은 1MB로 제한돼요. 더 긴 결과가 필요하면 Hive 리소스를 대안으로 써요.

출처: 문서

본문

설명

HCatalog DDL 명령을 수행합니다. 명령은 요청 즉시 실행됩니다. 응답은 1MB로 제한됩니다. 더 긴 결과를 반환할 수 있는 요청은 대안으로 Hive 리소스를 고려하세요.

URL

http://www.myserver.com/templeton/ddl

매개변수

이름	설명	필수?	기본값
exec	실행할 HCatalog ddl 문자열	필수	없음
group	테이블 생성 시 사용할 사용자 그룹	선택	없음
permissions	테이블 생성 시 사용할 권한 문자열. 형식은 "`rwxrw-r-x`".	선택	없음

표준 매개변수도 지원됩니다.

결과

이름	설명
stdout	HCatalog가 표준 출력으로 보낸 결과를 포함하는 문자열(비어 있을 수 있음)
stderr	HCatalog가 표준 오류로 보낸 결과를 포함하는 문자열(비어 있을 수 있음)
exitcode	HCatalog가 반환한 종료 코드

예제

Curl 명령

% curl -s -d 'exec=show tables;' \
       'http://localhost:50111/templeton/v1/ddl?user.name=ekoifman'

버전 정보: Hive 0.13.0 이전에는 user.name이 POST 요청에서 폼 매개변수로 지정되었습니다: curl -d user.name=<user>.

Hive 0.13.0 이후로는 user.name을 쿼리 문자열에 지정해야 합니다(위와 같이): 'http://.../templeton/v1/ddl?user.name=<name>'. user.name을 폼 매개변수로 지정하는 것은 deprecated 입니다.

JSON 출력

{
 "stdout": "important_table
            my_other_table
            my_table
            my_table_2
            pokes
            ",
 "stderr": "WARNING: org.apache.hadoop.metrics.jvm.EventCounter is deprecated...
            Hive history file=/tmp/ctdean/hive_job_log_ctdean_201111111258_2117356679.txt
            OK
            Time taken: 1.202 seconds
            ",
 "exitcode": 0
}

JSON 출력 (오류)

{
  "stdout": "",
  "stderr": "WARNING: org.apache.hadoop.metrics.jvm.EventCounter is deprecated...
            Hive history file=/tmp/ctdean/hive_job_log_ctdean_201204051246_689834593.txt
            FAILED: Parse Error: line 1:5 Failed to recognize predicate 'tab'...

            ",
  "exitcode": 11
}

탐색 링크 이전: GET version/hadoop / 다음: GET ddl/database

더 알아보기 (Learn more)

DDL 요청 외에 데이터베이스를 조회하는 GET ddl/database도 있어요. WebHCat의 다른 리소스들은 Hive·Pig 작업 실행을 담당해요.