List Tables — GET ddl/database/:db/table
Description
List the tables in an HCatalog database.
URL
http://
www.myserver.com/templeton/v1/ddl/database/
:db/table
Parameters
Name |
Description |
Required? |
Default |
---|---|---|---|
:db |
The database name |
Required |
None |
like |
List only tables whose names match the specified pattern |
Optional |
"*" (List all tables) |
The standard parameters are also supported.
Results
Name |
Description |
---|---|
tables |
A list of table names |
database |
The database name |
Example
Curl Command
% curl -s 'http://localhost:50111/templeton/v1/ddl/database/default/table?user.name=ctdean&like=m*'
JSON Output
{ "tables": [ "my_table", "my_table_2", "my_table_3" ], "database": "default" }
JSON Output (error)
{ "errorDetail": " org.apache.hadoop.hive.ql.metadata.HiveException: ERROR: The database defaultsd does not exist. at org.apache.hadoop.hive.ql.exec.DDLTask.switchDatabase(DDLTask.java:3122) at org.apache.hadoop.hive.ql.exec.DDLTask.execute(DDLTask.java:224) at org.apache.hadoop.hive.ql.exec.Task.executeTask(Task.java:134) at org.apache.hadoop.hive.ql.exec.TaskRunner.runSequential(TaskRunner.java:57) at org.apache.hadoop.hive.ql.Driver.launchTask(Driver.java:1332) at org.apache.hadoop.hive.ql.Driver.execute(Driver.java:1123) at org.apache.hadoop.hive.ql.Driver.run(Driver.java:931) at org.apache.hcatalog.cli.HCatDriver.run(HCatDriver.java:42) at org.apache.hcatalog.cli.HCatCli.processCmd(HCatCli.java:247) at org.apache.hcatalog.cli.HCatCli.processLine(HCatCli.java:203) at org.apache.hcatalog.cli.HCatCli.main(HCatCli.java:162) at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method) at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:39) at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:25) at java.lang.reflect.Method.invoke(Method.java:597) at org.apache.hadoop.util.RunJar.main(RunJar.java:156) ", "error": "FAILED: Error in metadata: ERROR: The database defaultsd does not exist.", "errorCode": 500, "database": "defaultsd" }
Previous: DELETE ddl/database/:db
Next: GET ddl/database/:db/table/:table
General: DDL Resources – WebHCat Reference – WebHCat Manual – HCatalog Manual – Hive Wiki Home – Hive Project Site
Old version of this document (HCatalog 0.5.0): GET ddl/database/:db/table