You are currently viewing How to Connect to Hive Using Beeline

Hive comes with HiveServer2 which is a server interface and has its own Command Line Interface(CLI) called Beeline which is used to connect to Hive running on Local or Remove server and run HiveQL queries. Beeline is a JDBC client that is based on the SQLLine CLI. In this article, you will learn how to connect to Hive using Beeline with several examples.


Using Beeline we can connect to Hive running on Local or Remote server using IP address and port.

Start Beeline to Connect to Hive

To start Beeline, run beeline shell which is located at $HIVE_HOME/bin directory.

Hive connect beeline
Beeline Shell to Connect to Hive

This prompts you to an interactive Hive Beeline CLI Shell where you can run HiveQL commands.

You can enter !help on CLI to get all commands that are supported.

Hive Beeline Help
Hive Beeline Help

Beeline can be run in Embedded mode and Remote mode, in Embedded mode it also runs HiveServer2 embedded internally similar to Hive CLI, and in Remote mode, it connects to remote HiveServer2 service over Thrift.

Now let’s connect to HiveServer2 using !connect and learn how to use embedded and remote modes with examples.

Using Beeline in Embedded Mode

Running in embedded mode is a quick way to connect to Hive using Beeline and run some HiveQL queries, this is similar to Hive CLI (older version). In embedded mode, it launches Hive service (HiveServer2) internally hence it’s not recommended for production use.

To start Beeline in embedded mode and connect to Hive using a connection string !connect jdbc:hive2://, By running this command it prompts for user name and password. HiveServer2 by default provides user scott and password tiger, so let’s use these default credentials.

Note: One of the main differences between Hive CLI and HiveServer2 (HS2) is HS2 provides authentication, You cannot connect to Hive without authenticating.

beeline>!connect jdbc:hive2://
connecting to jdbc:hive2://
Enter username for jdbc:hive2://: scott
Enter password for jdbc:hive2://: *******
0: jdbc:hive2://>

You may get below errors

Alternatively, you can also supply the embedded URL and credentials in one statement.

beeline>!connect jdbc:hive2:// -n scott -p tiger
bin/beeline -u jdbc:hive2:// scott tiger

Beeline CLI option -n is used to specify a username and -p to specify a password.

Using Beeline to Connect to Remote Hive

In Remote mode, the HiveServer2 process is running on a remote cluster and we can connect to remote Hive from Beeline by providing a Remote IP address and port on the JDBC connection URL string.

In order to use Beeline connecting to remove server, first, you need to have the HiveServer2 service running on remote server, if it’s not already running, Start HiveServer2

Note: By default, HiveServer2 runs on port 10000.

Using separate HiveSever2 service enables us to configure different types of authentications LDAP and Kerberos hence, connecting to Hive in Remote mode is recommended to use for production.

This is the most secure way of connecting to Hive and protecting production data by not giving users access to cluster.

To connect to Hive running on remote cluster, just pass the IP address and Port on JDBC connection string.

beeline>!connect jdbc:hive2:// scott tiger
beeline>!connect jdbc:hive2:// -n scott -p tiger

By not providing a username and password, it prompts for the credentials to enter.

beeline> !connect jdbc:hive2:// scott tiger
Connecting to jdbc:hive2://
Connected to: Apache Hive (version 3.1.2)
Driver: Hive JDBC (version 3.1.2)
0: jdbc:hive2://>

In case if you are running on LOCAL, you can also try with the localhost, hostname, or instead of remote IP address.

Upon successfully staring Beeline, enter the show databases; to list the database, by default hive provides default database.

0: jdbc:hive2://> show databases;
| database_name  |
| default        |
1 rows selected (1.775 seconds)
0: jdbc:hive2://>

You can also directly issues a Beeline command from the Unix shell, For more command option please refer Beeline Options

prabha@namenode:~/hive$ bin/beeline -u jdbc:hive2:// scott tiger

Happy Learning !!

Related Article

Leave a Reply

This Post Has 2 Comments

  1. Anonymous

    Nice Articles. Thank you

  2. Utkarsha Srivastava

    Thanks for sharing this information.