# tHBaseConnection

Establishes an HBase connection to be reused by other HBase components in your Job.

tHBaseConnection opens a connection to an HBase database.

This component is not shipped with your Talend Studio by default. You need to install it using the Feature Manager. For more information, see [Installing features using the Feature Manager](https://help.qlik.com/talend/r/en-US/8.0/studio-user-guide/install-features-to-talend-studio).

## tHBaseConnection Standard properties

These properties are used to configure tHBaseConnection running in the Standard Job framework.

The Standard tHBaseConnection component belongs to the Big Data and the Databases NoSQL families.

The component in this framework is available in all Talend products with Big Data and in Talend Data Fabric.

## Basic settings

| Properties | Description |
| --- | --- |
| Property type | Either Built-in or Repository<br><br>- Built-in: no property data<br>stored centrally.<br><br>- Repository: select the<br>repository file in which the properties are stored. The fields that follow are<br>completed automatically using the data retrieved. |
| HBase version | Select the HBase version of the distribution you are using. |
| Hadoop version | Select the Hadoop version of the distribution you are using. |
| Zookeeper quorum | Type in the name or the URL of the ZooKeeper service you use to coordinate the<br>transaction between your Talend Studio and<br>your database. Note that when you configure the ZooKeeper, you might need to explicitly<br>set the *zookeeper.znode.parent* property to define the path to the<br>root Znode that contains all the Znodes created and used by your database; then select<br>the Set Zookeeper znode parent check box to define<br>this property. |
| Zookeeper client port | Type in the number of the client listening port of the ZooKeeper service you<br>are using. |
| Inspect the classpath for<br>configurations | Select this check box to allow the component to check the configuration<br>files in the directory you have set with the *$HADOOP\_CONF\_DIR*<br>variable and directly read parameters from these files in this directory. This<br>feature allows you to easily change the Hadoop configuration for the component to<br>switch between different environments, for example, from a test environment to a<br>production environment.<br><br>In this situation, the fields or options used to configure Hadoop<br>connection and/or Kerberos security are hidden.<br><br>If you want to use certain parameters such as the Kerberos parameters but<br>these parameters are not included in these Hadoop configuration files, you need to<br>create a file called *talend-site.xml* and put this file into the<br>same directory defined with *$HADOOP\_CONF\_DIR*. This *talend-site.xml* file should read as follows:<br><br>```<br><!-- Put site-specific property overrides in this file. --><br><configuration><br><property><br><name>talend.kerberos.authentication </name><br><value>kinit </value><br><description> Set the Kerberos authentication method to use. Valid values are: kinit or keytab.  </description><br></property><br><property><br><name>talend.kerberos.keytab.principal </name><br><value>user@BIGDATA.COM </value><br><description> Set the keytab's principal name.  </description><br></property><br><property><br><name>talend.kerberos.keytab.path </name><br><value>/kdc/user.keytab </value><br><description> Set the keytab's path.  </description><br></property><br><property><br><name>talend.encryption </name><br><value>none </value><br><description> Set the encryption method to use. Valid values are: none or ssl.  </description><br></property><br><property><br><name>talend.ssl.trustStore.path </name><br><value>ssl </value><br><description> Set SSL trust store path.  </description><br></property><br><property><br><name>talend.ssl.trustStore.password </name><br><value>ssl </value><br><description> Set SSL trust store password.  </description><br></property><br></configuration><br>```<br><br>The parameters read from these configuration files override the default<br>ones used by Talend Studio.<br>When a parameter does not exist in these configuration files, the default one is<br>used. |
| Use kerberos<br>authentication | If the database to be used is running with Kerberos security, select this<br>checkbox, then, enter the principal names in the HBase Master<br>principal and HBase Region Server principal<br>fields. You should be able to find the information in the *hbase-site.xml* file of the cluster to be used.<br><br>If you need to use a Kerberos keytab file to log in, select Use a keytab to authenticate. A keytab file contains<br>pairs of Kerberos principals and encrypted keys. You need to enter the principal to<br>be used in the Principal field and the access<br>path to the keytab file itself in the Keytab<br>field. This keytab file must be stored in the machine in which your Job actually<br>runs, for example, on a Talend JobServer.<br><br>Note that the user that executes a keytab-enabled Job is not necessarily<br>the one a principal designates but must have the right to read the keytab file being<br>used. For example, the username you are using to execute a Job is *user1* and the principal to be used is *guest*; in this<br>situation, ensure that *user1* has the right to read the keytab<br>file to be used. |

## Advanced settings

| Properties | Description |
| --- | --- |
| Properties | If you need to use custom configuration for your HBase, complete<br>this table with the property or properties to be customized. Then at<br>runtime, the customized property or properties will override those<br>corresponding ones defined earlier for your HBase.<br><br>For example, you need to define the value of the *dfs.replication* property as *1* for the HBase configuration. Then you<br>need to add one row to this table using the plus button and type in<br>the name and the value of this property in this row. |
| tStatCatcher Statistics | Select this check box to collect the log data at a component<br>level. |

## Global Variables

| Variables | Description |
| --- | --- |
| Global Variables | ERROR\_MESSAGE: the error message generated by the<br>component when an error occurs. This is an After variable and it returns a string. This<br>variable functions only if the Die on error checkbox is<br>cleared, if the component has this checkbox.<br><br>A Flow variable functions during the execution of a component<br>while an After variable functions after the execution of the component.<br><br>To fill up a field or expression with a variable, press Ctrl+Space to access the variable list and choose the variable to use from<br>it.<br><br>For more information about variables, see [Using contexts and variables](https://help.qlik.com/talend/r/en-US/8.0/studio-user-guide/contexts-and-variables). |

## Usage

| Usage guidance | Description |
| --- | --- |
| **Usage rule** | This component is generally used with other HBase components,<br>particularly tHBaseClose. |
| Prerequisites | Before starting, ensure that you have met the Loopback IP prerequisites expected by your<br>database.<br><br>For further information about how to install a Hadoop distribution, see the manuals<br>corresponding to the Hadoop distribution you are using. |

**Related concepts**

* [Exchanging customer data with HBase](https://help.qlik.com/talend/en-US/components/8.0/hbase/thbaseconnection-thbaseinput-tfileinputdelimited-exchanging-customer-data-with-hbase-standard-component-bigdata-in-this)