# tImpalaRow

Acts on the actual DB structure or on the data (although without handling data).

The SQLBuilder tool helps you write your Impala SQL statements easily. tImpalaRow is the dedicated component for this database. It executes the Impala SQL query stated in the specified database. The Row suffix means the component implements a flow in the Job design although it does not provide output.

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).

## tImpalaRow Standard properties

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

The Standard tImpalaRow component belongs to the Big Data family.

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 | <ul> <li> <p>Either <span>Built-in</span> or <span>Repository</span>.</p> </li> <li> <p> <span>Built-in</span>: No property data stored								centrally.</p> </li> <li> <span>Repository</span> : Select the							repository file in which the properties are stored. The fields that							follow are completed automatically using the data retrieved.</li> </ul> |
| Use an existing connection | Select this check box and in the Component<br>List drop-down list, select the desired connection component to<br>reuse the connection details you already defined.<br><br>Information noteNote: When a Job contains the parent Job and the child Job, do the following if you<br>want to share an existing connection between the parent Job and the child Job (for example,<br>to share the connection created by the parent Job with the child Job).<br><br><ol> <li>In the parent level, register the database connection to be shared               in the <span>Basic settings</span> view of the               connection component which creates that very database connection. </li> <li>In the child level, use a dedicated connection component to read               that registered database connection. </li> </ol><br><br>For an example about how to share a database connection across Job levels,<br>see [Sharing a database connection](https://help.qlik.com/talend/r/en-US/7.3/studio-user-guide/sharing-database-connection). |
| Impala Driver | Select the driver you are using from the drop-down list. |
| Host | Database server IP address. |
| Port | Listening port number of DB server. |
| Database | Enter the name of the database. |
| Additional JDBC<br>Settings | Specify additional connection properties for the database<br>connection you are creating.<br><br>This option is not available if you have selected the<br>Use an existing connection check box<br>in the Basic settings view. |
| Username and<br>Password | Enter the database user authentication data to authenticate<br>using LDAP.<br><br>To enter the password, click the […] button next to the<br>password field, and then in the pop-up dialog box enter the password between<br>double quotes and click OK to save the settings.<br><br>These parameters are not available when you select the Use kerberos<br>authentication check box. |
| Use kerberos authentication | If you are accessing an Impala system running with Kerberos security,<br>select this checkbox and then enter the Kerberos principal of this Impala system. |
| Schema and Edit<br>Schema | <ul> <li> <p>A schema is a row description. It defines the number of fields            (columns) to be processed and passed on to the next component. When you create a Spark            Job, avoid the reserved word <kbd>line</kbd> when naming the            fields.</p> <p>Click <span>Edit        schema</span> to make changes to the schema. If the current schema is of the <span>Repository</span> type, three options are available:</p> <ul> <li> <p> <span>View schema</span>: choose this                option to view the schema only.</p> </li> <li> <p> <span>Change to built-in property</span>:                choose this option to change the schema to <span>Built-in</span> for local changes.</p> </li> <li> <p> <span>Update repository connection</span>:                choose this option to change the schema stored in the repository and decide whether                to propagate the changes to all the Jobs upon completion.</p> <p>If you just want to                propagate the changes to the current Job, you can select <span>No</span> upon completion and choose this schema metadata                again in the <span>Repository Content</span>                window.</p> </li> </ul> </li> <li> <p> <span>Built-in</span>: The schema is created								and stored locally for this component only. For more information about a component schema in its <span>Basic settings</span> tab, see <a href="https://help.qlik.com/talend/r/en-US/8.0/studio-user-guide/basic-settings-tab" target="_blank">Basic settings tab</a>.</p> </li> <li> <p> <span>Repository</span>: The schema already								exists and is stored in the Repository, hence can be reused. For more information about a component schema in its <span>Basic settings</span> tab, see <a href="https://help.qlik.com/talend/r/en-US/8.0/studio-user-guide/basic-settings-tab" target="_blank">Basic settings tab</a>.</p> </li> </ul> |
| Table Name | Name of the table to be processed. |
| Query type | <ul> <li> <p>Either <span>Built-in</span> or <span>Repository</span>.</p> </li> <li> <p> <span>Built-in</span>: Fill in manually the								query statement or build it graphically using SQLBuilder</p> </li> <li> <p> <span>Repository</span>: Select the relevant								query stored in the Repository. The Query field gets accordingly								filled in.</p> </li> </ul> |
| Guess Query | Click the Guess Query button to<br>generate the query which corresponds to your table schema in the<br>Query field. |
| Query | Enter your DB query paying particularly attention to properly<br>sequence the fields in order to match the schema definition. |
| Die on error | This check box is selected by default. Clear the check box to skip<br>the row on error and complete the process for error-free rows. If<br>needed, you can retrieve the rows on error via a Row &gt; Rejects link. |

## Advanced settings

| Properties | Description |
| --- | --- |
| Propagate QUERY's recordset | Select this check box to insert the result of the query into a<br>COLUMN of the current flow. Select this column from the use column list.<br><br>Information noteNote:<br><br>This option allows the component to have a different schema<br>from that of the preceding component. Moreover, the column that<br>holds the QUERY's recordset should be set to the type of<br>*Object* and this component<br>is usually followed by tParseRecordSet. |
| tStatCatcher Statistics | Select this check box to collect log data at the component<br>level. |

## Global Variables

| Variables | Description |
| --- | --- |
| Global Variables | QUERY: the query statement<br>being processed. This is a Flow variable and it returns a string.<br><br><br>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 offers the benefit of flexible DB queries and<br>covers all possible Impala SQL queries. |