WebHCat Reference GetTable

WebHCat Reference GetTable

HCatalog 테이블을 설명(describe)하는 WebHCat 리소스예요. 보통은 간단한 컬럼 목록("desc table")을 반환하지만, 확장 형식(format=extended)으로는 더 많은 정보("show table extended like")를 보여줍니다.

출처: 문서

본문

설명(Description)

HCatalog 테이블을 설명해요. 보통은 간단한 컬럼 목록("desc table")을 반환하지만, 확장 형식은 더 많은 정보("show table extended like")를 보여줍니다.

URL

http://www.myserver.com/templeton/v1/ddl/database/:db/table/:table

http://www.myserver.com/templeton/v1/ddl/database/:db/table/:table?format=extended

매개변수(Parameters)

Name Description Required? Default
:db 데이터베이스 이름 Required None
:table 테이블 이름 Required None
format 추가 정보를 보려면 "format=extended" 지정 ("show table extended like" 사용) Optional Not extended

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

결과(Results)

Name Description
columns 컬럼 이름과 타입 목록
database 데이터베이스 이름
table 테이블 이름
partitioned (extended only) 테이블이 파티셔닝되었으면 true
location (extended only) 테이블 위치
outputFormat (extended only) 출력 형식
owner (extended only) 소유자 사용자 이름
partitionColumns (extended only) 파티션 컬럼 목록
inputFormat (extended only) 입력 형식

예제(Example)

Curl 명령 (simple)

% curl -s 'http://localhost:50111/templeton/v1/ddl/database/default/table/my_table?user.name=ctdean'

JSON 출력 (simple)

{
 "columns": [
   {
     "name": "id",
     "type": "bigint"
   },
   {
     "name": "user",
     "comment": "The user name",
     "type": "string"
   },
   {
     "name": "my_p",
     "type": "string"
   },
   {
     "name": "my_q",
     "type": "string"
   }
 ],
 "database": "default",
 "table": "my_table"
}

Curl 명령 (extended)

% curl -s 'http://localhost:50111/templeton/v1/ddl/database/default/table/test_table?user.name=ctdean&format=extended'

JSON 출력 (extended)

{
  "partitioned": true,
  "location": "hdfs://ip-10-77-6-151.ec2.internal:8020/apps/hive/warehouse/test_table",
  "outputFormat": "org.apache.hadoop.hive.ql.io.RCFileOutputFormat",
  "columns": [
    {
      "name": "id",
      "type": "bigint"
    },
    {
      "name": "price",
      "comment": "The unit price",
      "type": "float"
    }
  ],
  "owner": "ctdean",
  "partitionColumns": [
    {
      "name": "country",
      "type": "string"
    }
  ],
  "inputFormat": "org.apache.hadoop.hive.ql.io.RCFileInputFormat",
  "database": "default",
  "table": "test_table"
}

JSON 출력 (error)

{
  "error": "Table xtest_table does not exist",
  "errorCode": 404,
  "database": "default",
  "table": "xtest_table"
}

테이블이 없으면 error와 errorCode(404)가 포함된 오류 응답을 돌려줘요.

더 알아보기 (Learn more)

format=extended를 붙이면 파티션 여부, 위치, input/output format, owner까지 볼 수 있어요. WebHCat DDL 리소스의 전체 목록은 WebHCat Reference를 참고하세요.