Hive

As of Datameer X 7.4

(warning) Datameer X support for Hive Metastore (Hive Server1) is being deprecated in favor of HiveServer2, effective in a future Datameer X minor release. It is strongly recommended that the appropriate configuration changes be introduced as soon as possible.

Beginning with Datameer X 7.4, dialogs where use of a Hive connection is an option will display the warning "Support for Hive Server1 has been deprecated and is being removed in a future release. Please use Hive Server2 instead."

In addition, if a Hive Server1 connection is used for run processing, the result will be a final job status of COMPLETED_WITH_WARNINGS, even if there were no processing errors or other issues with execution. This is intentional and does not require escalation to Datameer X support. Rather, it is intended to alert you that important functionality will be removed in an upcoming version.

Until the complete removal of Hive Server1 support, if it is absolutely necessary to do so, it will be possible to disable this warning by setting the datameer.deprecation.with.warnings.enabled property to false. Note that a Datameer X restart is required when this property flag is changed.

In order to connect to Hive you must be using an Enterprise version of Datameer.

Datameer X does not generate Hive queries when connecting to Hive for data retrieval. Datameer X can leverage a Thrift server or point directly to a Thrift warehouse path in HDFS when data is stored in a delimited fashion.

Configuring Hive as a Connection

In order to import from Hive, you must first create a connection.

As of Datameer X 7.4

(warning) Datameer X support for Hive Metastore (Hive Server1) is being deprecated in favor of HiveServer2. We strongly recommended that the appropriate configuration changes be introduced as soon as possible.

To create a Hive connector:

  1. Click the + (plus) button and select Connection or right-click in the browser and select Create new  >  Connection .
  2. From the drop-down list select Hive as the connection type. Please see related warning at top of page.
  3. Enter the URL for the Hive metastore server. They usually run on port 10000 or 9083.
    Add any custom properties that might be necessary or desired when importing from Hive.

    When adding a Hive connection that is accessing data stored in an S3 service, additional authentication is required.

    Add the following properties in the custom properties field:

    fs.s3n.awsAccessKeyId=<ID>
    fs.s3n.awsSecretAccessKey=<KEY>

    High Availability (HA)

    If high availability (HA) for the Hive Metastore is enabled on cluster, users must provide both thrift URLs separated by commas while creating the Hive connection. 

    Additional Security Settings

    If you are connecting to Hive v0.10 or higher there are additional possible security settings. Select Yes to enable the secure Hive features and enter the metastore and HDFS principals.

    Metastore Principal: Service principal for the metastore thrift server. The special string _HOST is replaced automatically with the correct host name.

    HDFS Principal: Principal name of the Hadoop namenode.

  4. Enter a description and click Save.

After configuring a Hive connection with the wizard you can set up one or more import jobs which access the Hive connection. 

Importing Data with a Hive Connector

(warning) Please see related warning in above section regarding Hive Metastore deprecation.

  1. Click the + (plus) button and selectImport Job or right-click in the browser and select Create new Import Job.
  2. Click Select Connection and choose the name of your Hive connection then click Next.
  3. Select a Database.

    As of Datameer X 7.5

    Datameer X is able to compute the partition location while importing data from a partitioned Hive table, without fetching it from the HiveServer 2. This will improve the performance if the default partition location pattern is used. The setting can be configured globally within the plugin configuration page. The default value can be overwritten with the import job or data link wizard. 

    Select a Partition Location ModeDefault Mode sets the Hive plugin to the globally defined partition location.  Compute default partition location calculates the partition location from the table location and partition specification. Fetch every partition from Hive obtains the actual partition location from the Hive server for each partition.  If you are unsure of the best choice, contact your Hive or Hadoop Administrator.

  4. Choose the desired table.

    Supported Hive File Formats

    TEXTFILE - Plain text.

    SEQUENCEFILE - A flat file consisting of binary key/value pairs. It is extensively used in MapReduce as input/output formats.

    ORC (Optimized Row Columnar) - A file format that provides a highly efficient way to store Hive data. It was designed to overcome limitations of the other Hive file formats. Using ORC files improves performance when Hive is reading, writing, and processing data.

    RCFILE (Record Columnar File) - A data placement structure that determines how to store relational tables on computer clusters. It is designed for systems using the MapReduce framework.

    Hive views are not supported and have been removed from the Table list. This due to the fact that a Hive view is a reference to non-materialized data. Since Datameer X doesn't support running a Hive query, a Hive view isn't currently possible.

    If the filtering of views is causing a performance issue, the property below must be added to the Custom Properties in the Hive connector to remove the filter.

    das.hive.exclude.views=false

    Removing the filter to increase performance allows views to be shown in the Table drop-down list, but they are still not supported for import.

    As of Datameer X v6.3

    Importing Hive views is supported using the JDBC connector with a HiveServer2 implementation.

  5. Partitions from Hive being imported have additional filtering options. This works for both string and date/time partitions.
    The following options are available: 

    • Filter by values - Select all available partition values for applying a value based filter.
    • Filter by fixed dates - Parse partition values for date and time constants and use start and end date for applying a time based filter for partitions. You have to specify a Java date pattern for each partition that is related to a date.
    • Filter by dynamic dates - Parse partition values for date and time constants and use start and end date expression for applying a filter based on a sliding time window. You have to specify a Java date pattern for each partition that is related to a date.

    This filter feature allows for import of data that has already been partitioned on the Hive server. To view how date/time partitions work in data links, refer to Linking to Data. To create partitions within a Datameer X workbook, use the Time-based Partitions feature under the Define Fields section of the import.

  6. Next, you see a preview of the imported data. 

    From the Define Fields page, you can change the data field types and if necessary, set up date parse patterns.
    By default, the preview includes the columns within the Hive partition but not the partition values. If needed, add the partition values to the import job by marking the included box under the column name.  

    Complex data field types (e.g., lists, structs, maps, and any nested data types) are represented as JSON and displayed as strings.
    You can extract and use this data with the JSON functions (i.e. JSON_ELEMENTJSON_ELEMENTSJSON_KEYSJSON_MAP or JSON_VALUE) after loading this data into a workbook.

    Datameer X jobs are compiled outside of Hive and don't have the same restrictions as Hive queries do. A workbook in Datameer X isn't a direct analog to a Hive query and there are often concepts that don't translate back and forth as one-to-one features.

    A filter is similar to a where clause. It restricts the results on only include results that match the requested search criteria.

    Data type mapping when importing from a Hive table

    Hive typesDatameer X types

    StringBooleanFloatIntegerBig_integerBig_decimalDateList
    STRING(tick)






    VARCHAR(tick)






    CHAR(tick)






    BOOLEAN
    (tick)





    FLOAT

    (tick)




    DOUBLE

    (tick)




    DECIMAL




    (tick)

    TINYINT


    (tick)



    SMALLINT


    (tick)



    INT


    (tick)



    BIGINT


    (tick)



    DATE





    (tick)
    TIMESTAMP





    (tick)
    COMPLEX TYPES(tick)






    all others(tick)






    Additional advanced features are available to specify how to handle the data.
    Time-based partitions let workbook users partition data by date. This features allows calculations to run on all or only specific parts of the imported data. See Partitioning Data in Datameer for more information.

  7. Review the schedule, data retention, and advanced properties for the job.

  8. Add a description, click Save, and name the file.

Using a Custom Hive SerDe Library

SerDe is short for Serializer/Deserializer. A SerDe allows Hive to read in data from a table, and write it back out to HDFS in any custom format. You can write your own SerDe for your own data formats in Datameer.

The classes for your Hive SerDe must be in the classpath of the Hive plug-in used to connect Datameer X to Hive. Datameer X provides Hive plug-ins for major versions of Hive. (e.g., 0.13.1, 0.14.0, 1.1.0, 1.2.0, 1.2.1) from CDH, MAPR, HDP, and APACHE distributions.

To add your custom SerDe to Datameer X

  1. Determine the version of Hive you're using. (e.g., 0.7)

  2. Shutdown Datameer.

  3. unzip <Datameer X Install folder>/plugins/plugin-hive-<Hive Version>-<Datameer X Version>.zip

  4. Add the JAR file of your SerDe to: /lib/compile/hadoop and rezip.

  5. Remove the corresponding .md5 file, if it exists. (e.g., plugin-hive-0.14.0-6.4.0.zip)

  6. Restart Datameer.

If you run into problem, review Apache Hive - Custom SerDes and get in contact with the vendor of your 3rd party product/library.

 Adding only the custom SerDe may not suffice. Additional steps may be required depending on your Hive product.