Hive Web Interface
- Hive Web Interface
What Is the Hive Web Interface
The Hive Web Interface is an alternative to using the Hive command line interface. Using the web interface is a great way to get started with Hive.
The Hive Web Interface, abbreviated as HWI, is a simple graphical user interface (GUI).
Another web interface that can be used for Hive commands is WebHCat, a REST API (not GUI). With WebHCat, applications can make HTTP requests to access the Hive metastore (HCatalog DDL) or to create and queue Hive queries and commands, Pig jobs, and MapReduce or YARN jobs (either standard or streaming). WebHCat was formerly named Templeton. See these documents for more information:
Features of HWI
An alternative to running 'show tables' or 'show extended tables' from the CLI is to use the web-based schema browser. The Hive metadata is presented in a hierarchical manner allowing you to start at the database level and click to get information about tables including the SerDe, column names, and column types.
Detached Query Execution
A power user issuing multiple Hive queries simultaneously would have multiple CLI windows open. The Hive Web Interface manages the session on the web server, not from inside the CLI window. This allows a user to start multiple queries and return to the web interface later to check the status.
No Local Installation
Any user with a web browser can work with Hive. This has the usual web interface benefits. In particular, a user wishing to interact with Hadoop or Hive requires access to many ports. A remote or VPN user would only require access to the Hive Web Interface running by default on 0.0.0.0 tcp/9999.
Hive Web Interface made its first appearance in the 0.2 branch. If you have Hive release 0.2 or later, or the SVN trunk, then you already have it.
You should not need to edit the defaults for the Hive Web Interface. HWI uses:
You probably want to set up HiveDerbyServerMode to allow multiple sessions at the same time.
hive with no arguments, the CLI is invoked. Hive has an extension architecture used to start other
Jetty requires Apache Ant to start HWI. You should define ANT_LIB as an environment variable or add that to the
Java has no direct way of demonizing. In a production environment you should create a wrapper script.
If you want help on the service invocation or list of parameters you can add
Hadoop currently uses environmental properties to determine user name and group vector. Thus Hive and Hive Web Interface cannot enforce more stringent security then Hadoop can. When you first connect to the Hive Web Interface you are prompted for a user name and groups. This feature was added to support installations using different schedulers.
If you want to tighten up security you are going to need to patch the source Hive Session Manager or you may be able to tweak the JSP to accomplish this.
In order to access the Hive Web Interface, go to <Hive Server Address>:9999/hwi on your web browser.
Tips and Tricks
The result file is local to the web server. A query that produces massive output should set the result file to /dev/null.
Debug mode is used when the user is interested in having the result file contain not only the result of the Hive query but also the other messages.
In the CLI a command like 'SET x=5' is not processed by the the Query Processor, it is processed by
the Set Processor. Use the form 'x=5', not 'set x=5'.
Running a Query