Hive 作业-POSTHive

Description

运行Hive查询或命令集。

Version: Hive 0.13.0 and later

从 Hive 0.13.0 开始，GET version/hive显示用于查询或命令的 Hive 版本。

URL

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

Parameters

Name	Description	Required?	Default
execute	包含要运行的整个简短 Hive 程序的字符串。	需要“执行”或“文件”之一。	None
file	要运行的 Hive 程序的 HDFS 文件名。	需要“执行”或“文件”之一。	None
define	使用语法`define=NAME=VALUE`设置 Hive 配置变量。查看note CURL 和“ =”。	Optional	None
arg	设置程序参数。此参数是在 Hive 0.12.0 中引入的。 (请参阅HIVE-4444。)	Hive 0.12.0 中的可选	None
files	以逗号分隔的文件将被复制到 map reduce 集群。此参数是在 Hive 0.12.0 中引入的。 (请参阅HIVE-4444。)	Hive 0.12.0 中的可选	None
statusdir	WebHCat 将在其中写入 Hive 作业状态的目录。如果提供了此目录，则调用者有责任在完成后删除此目录。	Optional	None
enablelog	如果设置 statusdir 且 enablelog 为“ true”，请收集 Hadoop 作业配置并在作业完成后登录名为`$statusdir/logs`的目录。完成和失败的尝试都将被记录。 `$statusdir/logs`中子目录的布局为：
`logs/$job_id` ($ job_id 的目录) `logs/$job_id/job.xml.html` `logs/$job_id/$attempt_id` ($ attempt_id 的目录) `logs/$job_id/$attempt_id/stderr` `logs/$job_id/$attempt_id/stdout` `logs/$job_id/$attempt_id/syslog` 此参数是在 Hive 0.12.0 中引入的。 (请参见HIVE-4531。)	Hive 0.12.0 中的可选	无
callback	定义在作业完成时要调用的 URL。您可以使用`$jobId`将特定的工作 ID 嵌入此 URL。	可选	无	将在回调 URL 中用此作业的作业 ID 替换该标签。

standard parameters也受支持。

Results

Name	Description
id	包含类似于“ job_201110132141_0001”的作业 ID 的字符串。
info	一个 JSON 对象，其中包含作业排队时返回的信息。有关更多信息，请参见 Hadoop 文档(Class TaskController)。

Example

Curl Command

% curl -s -d execute="select+*+from+pokes;" \
       -d statusdir="pokes.output" \
       'http://localhost:50111/templeton/v1/hive?user.name=ekoifman'

Version information

在 Hive 0.13.0 之前，在 POST 请求中将 user.name 指定为表单参数curl -d user.name=<user>。

从Hive 0.13.0开始，应在查询字符串中指定 user.name(如上所示)：'http://.../templeton/v1/hive?user.name=<name>'。不建议将 user.name 指定为表单参数。

JSON Output

{
 "id": "job_201111111311_0005",
 "info": {
          "stdout": "templeton-job-id:job_201111111311_0005
                    ",
          "stderr": "",
          "exitcode": 0
         }
}

Example Results

% hadoop fs -ls pokes.output
Found 2 items
-rw-r--r--   1 ctdean supergroup        610 2011-11-11 13:22 /user/ctdean/pokes.output/stderr
-rw-r--r--   1 ctdean supergroup         15 2011-11-11 13:22 /user/ctdean/pokes.output/stdout

% hadoop fs -cat pokes.output/stdout
1       a
2       bb
3       ccc

Navigation Links

Previous: POST pig
Next: GET queue

常规：WebHCat Reference – WebHCat Manual – HCatalog Manual – Hive Wiki 主页 – Hive 项目 site

Docs

Docs4dev

Title here