创建表— PUT ddl/database /：db/table /：table
Description
创建一个新的 HCatalog 表。有关更多信息，请参阅 Hive 文档CREATE TABLE。
URL
http:// * www.myserver.com * /templeton/v1/ddl/database/ *：db * /table/ *：table *
Parameters
| Name | Description | Required? | Default |
|---|---|---|---|
| :db | 数据库名称。 | Required | None |
| :table | 新表名称。 | Required | None |
| group | 创建表时要使用的用户组。 | Optional | None |
| permissions | 创建表时使用的权限字符串。 | Optional | None |
| external | 允许您指定一个位置，以便 Hive 不使用此表的默认位置。 | Optional | false |
| ifNotExists | 如果为 true，则该表已经存在，则不会收到错误消息。 | Optional | false |
| comment | Comments 表。 | Optional | None |
| columns | 列描述列表，包括名称，类型和可选 Comments。 | Optional | None |
| partitionedBy | 用于分区表的列描述列表。像 columns 参数一样，这是名称，类型和 Comments 字段的列表。 | Optional | None |
| clusteredBy | 一个对象，描述如何对表进行聚类，包括参数 columnNames，sortedBy 和 numberOfBuckets。 sortedBy 参数包括参数 columnName 和 order(升序为 ASC 或降序为 DESC)。有关更多信息，请参考下面的示例或Hive documentation。 | Optional | None |
| format | 存储格式描述，包括 rowFormat，storedAs 和 storedBy 的参数。有关更多信息，请参考下面的示例或Hive documentation。 | Optional | None |
| location | HDFS 路径。 | Optional | None |
| tableProperties | 表属性名称和值(键/值对)的列表。 | Optional | None |
standard parameters也受支持。
Results
| Name | Description |
|---|---|
| table | 新表名称。 |
| database | 数据库名称。 |
Example
Curl Command
% curl -s -X PUT -HContent-type:application/json -d '{
"comment": "Best table made today",
"columns": [
{ "name": "id", "type": "bigint" },
{ "name": "price", "type": "float", "comment": "The unit price" } ],
"partitionedBy": [
{ "name": "country", "type": "string" } ],
"format": { "storedAs": "rcfile" } }' \
'http://localhost:50111/templeton/v1/ddl/database/default/table/test_table?user.name=ctdean'
Curl 命令(使用 clusteredBy)
% curl -s -X PUT -HContent-type:application/json -d '{
"comment": "Best table made today",
"columns": [
{ "name": "id", "type": "bigint"},
{ "name": "price", "type": "float", "comment": "The unit price" } ],
"partitionedBy": [
{ "name": "country", "type": "string" } ],
"clusteredBy": {
"columnNames": ["id"],
"sortedBy": [
{ "columnName": "id", "order": "ASC" } ],
"numberOfBuckets": 10 },
"format": {
"storedAs": "rcfile",
"rowFormat": {
"fieldsTerminatedBy": "\u0001",
"serde": {
"name": "org.apache.hadoop.hive.serde2.columnar.ColumnarSerDe",
"properties": {
"key": "value" } } } }
} ' \
'http://localhost:50111/templeton/v1/ddl/database/default/table/test_table_c?user.name=ctdean'
JSON Output
{
"table": "test_table",
"database": "default"
}
JSON 输出(错误)
{
"statement": "use default; create table test_table_c(id bigint, price float comment ...",
"error": "unable to create table: test_table_c",
"exec": {
"stdout": "",
"stderr": "WARNING: org.apache.hadoop.metrics.jvm.EventCounter is deprecated...
Hive history file=/tmp/ctdean/hive_job_log_ctdean_201204051335_2016086186.txt
SLF4J: Class path contains multiple SLF4J bindings.
SLF4J: Found binding in ...
SLF4J: See http://www.slf4j.org/codes.html#multiple_bindings for an explanation.
OK
Time taken: 0.448 seconds
FAILED: Error in semantic analysis: Operation not supported. HCatalog doesn't allow Clustered By in create table.
",
"exitcode": 10
}
}
Navigation Links
上一个：GET ddl/database/:db/table/:table下一个：POST ddl/database/:db/table/:table
一般：DDL Resources – WebHCat Reference – WebHCat Manual – HCatalog Manual – Hive Wiki 主页 – Hive 项目 site