Hive Web Interface

What

...

Is the Hive Web Interface

The Hive web interface Web Interface is a an alternative to using the Hive command line interface. Using the web interface is a great way to get started with hive.

...

Hive.

The Hive Web Interface, abbreviated as HWI, is a simple graphical user interface (GUI).

WebHCat API

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:

• Using WebHCat in the WebHCat manual
• Using HCatalog in the HCatalog manual

Features of HWI

Schema Browsing

An alternative to running 'show tables' or 'show extended tables' from the CLI is to use the web-based schema browser. The Hive Meta Data 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 Hive queries simultaneously would have multiple CLI windows open. The hive web interface 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 Hadoop or hive Hive requires access to many ports. A remote or VPN user would only require access to the hive web interface 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 interfaceWeb Interface. HWI uses:

<property>
  <name>hive.hwi.listen.host</name>
  <value>0.0.0.0</value>
  <description>This is the host address the Hive Web Interface will listen on</description>
</property>

<property>
  <name>hive.hwi.listen.port</name>
  <value>9999</value>
  <description>This is the port the Hive Web Interface will listen on</description>
</property>

<property>
  <name>hive.hwi.war.file</name>
  <value>${HIVE_HOME}/lib/hive_hwi.war</value>
  <description>This is the WAR file with the jsp content for Hive Web Interface</description>
</property>

You probably want to setup set up HiveDerbyServerMode to allow multiple sessions at the same time.

Start

...

Up

When initializing Hive hive with no arguments that , the CLI is invoked. Hive has an extension architecture used to start other hive demons.
Jetty requires apache ant Apache Ant to start HWI. You should define ANT_LIB as an environment variable or add that to the hive invocation.

export ANT_LIB=/opt/ant/lib
bin/hive --service hwi

...

Hadoop currently uses environmental properties to determine user name and group vector. Thus Hive and Hive Web Interface can not cannot enforce more stringent security then Hadoop can. When you first connect to the Hive Web Interface the user is 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.

Accessing HWI

In order to access the Hive Web Interface, go to <Hive Server Address>:9999/hwi on your web browser.

Tips and

...

Tricks

Result

...

File

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

The debug Debug mode is used when the user is interested in having the result file contain not only contain the result of the hive Hive query but also the other messages.

Set Processor

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'.

Walk

...

Through

Authorize

Schema Browser

Diagnostics

Running a

...

Query