Rename Table — POST ddl/database/:db/table/:table
Description
Rename an HCatalog table.
URL
http://www.myserver.com/templeton/v1/ddl/database/:db/table/:table
Parameters
Name | Description | Required? | Default |
|---|---|---|---|
:db | The database name | Required | None |
:table | The existing (old) table name | Required | None |
rename | The new table name | Required | None |
group | The user group to use | Optional | None |
permissions | The permissions string to use. The format is " | Optional | None |
The standard parameters are also supported.
Results
Name | Description |
|---|---|
table | The new table name |
database | The database name |
Example
Curl Command
% curl -s -d rename=test_table_2 \
'http://localhost:50111/templeton/v1/ddl/database/default/table/test_table?user.name=ekoifman'
Version information
Prior to Hive 0.13.0, user.name was specified in POST requests as a form parameter: curl -d user.name=<user>.
In Hive 0.13.0 onward, user.name should be specified in the query string (as shown above): 'http://.../templeton/v1/ddl/...?user.name=<name>'. Specifying user.name as a form parameter is deprecated.
JSON Output
{
"table": "test_table_2",
"database": "default"
}
JSON Output (error)
{
"error": "Table test_table does not exist",
"errorCode": 404,
"database": "default",
"table": "test_table_2"
}
Previous: PUT ddl/database/:db/table/:table
Next: DELETE ddl/database/:db/table/:table
General: DDL Resources – WebHCat Reference – WebHCat Manual – HCatalog Manual – Hive Wiki Home – Hive Project Site