This Confluence has been LDAP enabled, if you are an ASF Committer, please use your LDAP Credentials to login. Any problems file an INFRA jira ticket please.

Child pages
  • WebHCat UsingWebHCat

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: fix link to Hive Logging (formerly Error Logs)

Using the HCatalog REST API (WebHCat)

Table of Contents

titleVersion information

The HCatalog project graduated from the Apache incubator and merged with the Hive project on March 26, 2013.
Hive version 0.11.0 is the first release that includes HCatalog and its REST API, WebHCat.


For example, to specify in a GET :table command:

No Format

% curl -s 'http://localhost:50111/templeton/v1/ddl/database/default/table/my_table?'

And to specify in a POST :table command:

No Format

% curl -s -d \
       -d rename=test_table_2 \


If the parameter is not supplied when required, the following error will be returned:

No Format

  "error": "No user found.  Missing parameter."


Hive log files are described in the Error Logs Hive Logging section of Getting Started.


The original work to add REST APIs to HCatalog was called Templeton. For backward compatibility the name still appears in URLs, log file names, etc. The Templeton name is taken from a character in the award-winning children's novel Charlotte's Web, by E. B. White. The novel's protagonist is a pig named Wilbur. Templeton is a rat who helps Wilbur by running errands and making deliveries as requested by Charlotte while spinning her web.


titleNavigation Links

Next: WebHCat Installation

General: WebHCat ManualHCatalog ManualHive Wiki HomeHive Project Site
Old version of this document (HCatalog 0.5.0): HCatalog REST API