Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents
Why use TiDB in Hive as the Metastore database?

TiDB is a distributed SQL database built by PingCAP and its open-source community. It is MySQL compatible and features horizontal scalability, strong consistency, and high availability. It's a one-stop solution for both Online Transactional Processing (OLTP) and Online Analytical Processing (OLAP) workloads.

In scenarios with enormous amounts of data, due to TiDB's distributed architecture, query performance is not limited to the capability of a single machine. When the data volume reaches the bottleneck, you can add nodes to improve TiDB's storage capacity.

Because TiDB is compatible with the MySQL protocol, it's easy to switch Hive's Metastore database to TiDB. You can use TiDB as if you were using MySQL, with almost no changes:

  • For the existing Hive cluster, you can use the mysqldump tool to replicate all data in MySQL to TiDB.
  • You can use the metadata initialization tool that comes with Hive to create a new Hive cluster

How to create a Hive cluster with TiDB

Creating a Hive cluster with TiDB involves the following steps:

  • Meet component requirements
  • Install a Hive cluster
    • Deploy a TiDB cluster
    • Configure Hive
    • Initialize metadata
    • Launch Metastore and test

Components required

Java Development Kit (JDK)1.8.0_221

There are no mandatory requirements for the component versions, as long as the components are compatible with each other. After you confirm that you have successfully installed Hadoop and JDK and can use them directly, you can move on to the next step.

Install a Hive cluster

Step 1: Deploy a TiDB cluster

  1. To set up a TiDB cluster, refer to this document.

  2. Create a Hive user in TiDB and set a password.

  3. Create a database named hive and grant privileges to the hive user.  

    Code Block
    -- Create a database for Hive Metastore.
    create database hive;
    -- Create a user and password for Hive Metastore.
    create user 'hive'@'%' identified by '123456';
    -- Grant privileges to the user.
    grant all privileges on hive.* to 'hive'@'%' identified by '123456';
    -- Flush privileges.
    flush privileges;

  4. Set the configuration item. 

    Code Block
    set global tidb_skip_isolation_level_check=1;

    If you don't set the configuration item, Metastore throws the following exception when it is running: 

    Code Block
    MetaException(message:The isolation level 'SERIALIZABLE' is not supported. Set tidb_skip_isolation_level_check=1 to skip this error)

Step 2: Configure Hive

  1. Download and decompress Hive. In this example, the decompression directory for Hive is ${HIVE_HOME}.

  2. To edit the hive-site.xml configuration file, run vim ${HIVE_HOME}/conf/hive-site.xml. (The configuration items only use the minimum configuration.)

    Code Block
        <description>TiDB address</description>
        <description>TiDB username</description>
        <description>TiDB password</description>

  3. To edit the configuration file, run vim ${HIVE_HOME}/conf/

    Code Block
    export HADOOP_HOME=...
    export JAVA_HOME=...

  4. Copy mysql-connector-java-${version}.jar to the lib directory in Hive.

    Code Block
    cp ${MYSQL_JDBC_PATH}/mysql-connector-java-${version}.jar ${HIVE_HOME}/lib

Step 3: Initialize metadata

You're performing this step to create a table for Hive metadata. The SQL script is in ${HIVE_HOME}/scripts/metastore/upgrade/mysql.

To initialize metadata, run the following command.

Code Block
${HIVE_HOME}/bin/schematool -dbType mysql -initSchema --verbose

When schemaTool completed appears in the last line, it means the metadata is successfully initialized.

Step 4: Launch Metastore and test

  1. Launch Metastore.

    Code Block
    ${HIVE_HOME}/bin/hive --service metastore

  2. Start the Hive client for testing.

    Code Block


If you use MySQL as the Hive Metastore database, as data grows in Hive, MySQL might become the bottleneck for the entire system. In this case, TiDB is a good solution, because it is compatible with the MySQL protocol and has excellent horizontal scalability. Due to its distributed architecture, TiDB far outperforms MySQL on large data sets and large numbers of concurrent queries.

This post showed how to deploy a Hive cluster with TiDB as the Metastore database. We hope TiDB can help you horizontally scale your Hive Metastore to meet your growing business needs.

In addition, if you're interested in our MySQL-to-TiDB migration story, check out this post.


  1. Hive Compatibility Version?

    Hive VersionStatus
    1.xNot tested
    2.1.xTested and verified in production
    2.3.xTested and verified in production

  2. Do the schemas in the Hive metastore database need to be changed?For Hive version 2.1.x and 2.3.x,no schema change is needed.
  3. Does the foreign key constraint for tables in Hive the metastore database affecting migrating to TiDB? For the versions tested, foreign key constraints do not impact using TiDB as Hive metastore. 

  4. How to handle `MetaException(message:The isolation level 'SERIALIZABLE' is not supported. Set tidb_skip_isolation_level_check=1 to skip this error) ` exception? In TiDB, execute the following command `set global tidb_skip_isolation_level_check=1;` to skip check.