Data Integration Connections > Connection properties > Hive connection properties

Hive connection properties

To use Hive Connector in a mapping task, you must create a connection in Data Integration.
When you set up a Hive connection, you must configure the connection properties.
The following table describes the Hive connection properties:
Connection property
Authentication Type
You can select one of the following authentication types:
  • - Kerberos. Select Kerberos for a Kerberos cluster.
  • - LDAP. Select LDAP for an LDAP-enabled cluster.
  • Note: LDAP is not applicable for elastic mappings.
  • - None. Select None for a cluster that is not secure or not LDAP-enabled.
The JDBC URL to connect to Hive.
Use the following format: jdbc:hive2://<server>:<port>/<database name>
To access Hive on a Hadoop cluster enabled for TLS, specify the details in the JDBC URL in the following format:
jdbc:hive2://<host>:<port>/<database name>;ssl=true;sslTrustStore=<TrustStore_path>;trustStorePassword=<TrustStore_password>,
where the truststore path is the directory path of the truststore file that contains the TLS certificate on the agent machine.
JDBC Driver *
The JDBC driver class to connect to Hive.
The user name to connect to Hive in LDAP or None mode.
The password to connect to Hive in LDAP or None mode.
Principal Name
The principal name to connect to Hive through Kerberos authentication.
Impersonation Name
The user name of the user that the Secure Agent impersonates to run mappings on a Hadoop cluster. You can configure user impersonation to enable different users to run mappings or connect to Hive. The impersonation name is required for the Hadoop connection if the cluster uses Kerberos authentication.
Keytab Location
The path and file name to the Keytab file for Kerberos login.
Configuration Files Path *
The directory that contains the Hadoop configuration files for the client.
Copy the site.xml files from the Hadoop cluster and add them to a folder in the Linux box. Specify the path in this field before you use the connection in a mapping or elastic mapping to access Hive on a Hadoop cluster:
  • - For mappings, you require the core-site.xml, hdfs-site.xml, and hive-site.xml files.
  • - For elastic mappings, you require the core-site.xml, hdfs-site.xml, hive-site.xml, mapred-site.xml, and yarn-site.xml files.
The URI to access the Distributed File System (DFS), such as Amazon S3, Microsoft Azure Data Lake Storage, Google Cloud Storage, and HDFS.
Note: For elastic mappings, Azure Data Lake Storage Gen2 is supported on the Azure HDinsight cluster. Google Cloud Storage is not supported.
Based on the DFS you want to access, specify the required storage and bucket name.
For example, for HDFS, refer to the value of the fs.defaultFS property in the core-site.xml file of the cluster and enter the same value in the DFS URI field.
DFS Staging Directory
The staging directory in the cluster where the Secure Agent stages the data. You must have full permissions for the DFS staging directory.
Hive Staging Database
The Hive database where external or temporary tables are created. You must have full permissions for the Hive staging database.
Additional Properties
The additional properties required to access the DFS.
Configure the property as follows:
<DFS property name>=<value>;<DFS property name>=<value>
For example:
To access the Amazon S3 file system, specify the access key, secret key, and the Amazon S3 property name, each separated by a semicolon:
fs.s3a.<bucket_name>.access.key=<access key value>;
fs.s3a.<bucket_name>.secret.key=<secret key value>;
To access the Azure Data Lake Storage Gen2 file system, specify the authentication type, authentication provider, client ID, client secret, and the client endpoint, each separated with a semicolon:<Authentication type>;<Authentication_provider>;<Client_ID>;<Client-secret>;<ADLS Gen2 endpoint>
* These fields are mandatory parameters.