Apache Hive : WebHCat Reference PostTable

Rename Table — POST ddl/database/:db/table/:table

• Rename Table — POST ddl/database/:db/table/:table
  • Description
  • URL
  • Parameters
  • Results
  • Example
    • Curl Command
    • JSON Output
    • JSON Output (error)

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 “rwxrw-r-x”.	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"
}

Navigation Links 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