Awesome

hive-testbench

A testbench for experimenting with Apache Hive at any data scale.

Overview

The hive-testbench is a data generator and set of queries that lets you experiment with Apache Hive at scale. The testbench allows you to experience base Hive performance on large datasets, and gives an easy way to see the impact of Hive tuning parameters and advanced settings.

Prerequisites

You will need:

• Hadoop 2.2 or later cluster or Sandbox.
• Hive 13 or later.
• Between 15 minutes and 2 days to generate data (depending on the Scale Factor you choose and available hardware).

Install and Setup

All of these steps should be carried out on your Hadoop cluster.

• Step 1: Prepare your environment.

  In addition to Hadoop and Hive 13+, before you begin ensure gcc is installed and available on your system path. If you system does not have it, install it using yum or apt-get.

• Step 2: Decide which test suite(s) you want to use.

  hive-testbench comes with data generators and sample queries based on both the TPC-DS and TPC-H benchmarks. You can choose to use either or both of these benchmarks for experiementation. More information about these benchmarks can be found at the Transaction Processing Council homepage.

• Step 3: Compile and package the appropriate data generator.

  For TPC-DS, ./tpcds-build.sh downloads, compiles and packages the TPC-DS data generator. For TPC-H, ./tpch-build.sh downloads, compiles and packages the TPC-H data generator.

• Step 4: Decide how much data you want to generate.

  You need to decide on a "Scale Factor" which represents how much data you will generate. Scale Factor roughly translates to gigabytes, so a Scale Factor of 100 is about 100 gigabytes and one terabyte is Scale Factor 1000. Decide how much data you want and keep it in mind for the next step. If you have a cluster of 4-10 nodes or just want to experiment at a smaller scale, scale 1000 (1 TB) of data is a good starting point. If you have a large cluster, you may want to choose Scale 10000 (10 TB) or more. The notion of scale factor is similar between TPC-DS and TPC-H.

• Step 5: Generate and load the data.

  The scripts tpcds-setup.sh and tpch-setup.sh generate and load data for TPC-DS and TPC-H, respectively. General usage is tpcds-setup.sh scale_factor [directory] or tpch-setup.sh scale_factor [directory]

  Some examples: Build 1 TB of TPC-DS data: ./tpcds-setup 1000 Build 1 TB of TPC-H data: ./tpch-setup 1000 Build 100 TB of TPC-DS data: ./tpcds-setup 100000

• Step 6: Run queries.

  More than 50 sample TPC-DS queries and all TPC-H queries are included for you to try. You can use hive, beeline or the SQL tool of your choice. The testbench also includes a set of suggested settings.

  This example assumes you have generated 1 TB of TPC-DS data during Step 5:

  cd sample-queries-tpcds
  hive -i testbench.settings
  hive> use tpcds_bin_partitioned_orc_1000;
  hive> source query55.sql;
  

  Note that the database is named based on the Data Scale chosen in step 3. At Data Scale 10000, your database will be named tpcds_bin_partitioned_orc_10000. At Data Scale 1000 it would be named tpcds_bin_partitioned_orc_1000. You can always show databases to get a list of available databases.

  Similarly, if you generated 1 TB of TPC-H data during Step 5:

  cd sample-queries-tpch
  hive -i testbench.settings
  hive> use tpch_bin_partitioned_orc_1000;
  hive> source tpch_query1.sql;
  

Feedback

If you have questions, comments or problems, visit the Hortonworks Hive forum.

If you have improvements, pull requests are accepted.