# tImpalaCreateTable

Creates Impala tables that fit a wide range of Impala data formats.

tImpalaCreateTable connects to the Impala database to be used and creates an Impala table that is dedicated to data of the format you specify.

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

## tImpalaCreateTable Standard properties

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

The Standard tImpalaCreateTable 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 | Select the way the connections details will be stored:<br><br><ul> <li> <span>Built-in</span>: No property data stored                           centrally.</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 | Enter the database server IP address. |
| Port | Enter the listening port number of the database 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 | A schema is a row description. It defines the number of fields<br>(columns) to be processed and passed on to the next component. When you create a Spark<br>Job, avoid the reserved word line when naming the<br>fields.<br><br><br>Built-In: You create and store the schema locally for this component<br>only.<br><br><br>Repository: You have already created the schema and stored it in the<br>Repository. You can reuse it in various projects and Job designs.<br><br>When the schema to be reused has default values that are<br>integers or functions, ensure that these default values are not enclosed within<br>quotation marks. If they are, you must remove the quotation marks manually.<br><br>Click Edit<br>schema to make changes to the schema. If the current schema is of the Repository type, three options are available:<br><br><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> |
| Table Name | Enter the name of the table to be created. |
| Action on table | Select the action to be carried out for creating a table:<br><br><ul> <li> <span>Create table</span>: a table is created.</li> <li> <span>Create table if not exists</span>: a table is created if                           no table exists.</li> </ul> |
| Format | Select the data format to which the table to be created is<br>dedicated:<br><br><ul> <li> <span>TEXTFILE</span> </li> <li> <span>SEQUENCEFILE</span> </li> <li> <span>RCFILE</span> </li> <li> <span>PARQUET</span> </li> <li> <span>AVRO</span> </li> <li> <span>KUDU</span> (Note that the Kudu format is only available                           when you have installed the R2023-02 <span>Talend Studio</span> Monthly update or a later one delivered by <span>Talend</span>.)</li> </ul><br><br>Note that when the file format to be used is PARQUET, you might be prompted to find the specific PARQUET JAR file and<br>install it into Talend Studio.<br><br><ul> <li> <p>When the connection mode to Hive is <span>Embedded</span>, the Job is run in your local machine and calls this JAR            installed in <span>Talend Studio</span>.</p> </li> <li> <p>When the connection mode to Hive is <span>Standalone</span>, the Job is run in the server hosting Hive and this JAR file            is sent to the HDFS system of the cluster you are connecting to. Therefore, ensure that            you have correctly defined the NameNode URI in the corresponding field of the <span>Basic settings</span> view.</p> </li> </ul><br><br><br>This JAR file can be downloaded from Apache's site. For details about how to install<br>external modules, see [Installing external modules](https://help.qlik.com/talend/r/en-US/8.0/studio-user-guide/installing-external-modules). |
| Set partitions | Select this check box to add partition columns to the table to be<br>created. Once selecting it, you need to define the schema of the<br>partition columns you need to add.<br><br>When you select KUDU from the<br>Format drop-down list, you can configure the number<br>of partitions to be created with the Kudu partition<br>parameter. The default value is HASH PARTITIONS 3. For more<br>information, see [Partitioning tables](https://kudu.apache.org/docs/kudu_impala_integration.html#partitioning_tables) from Kudu<br>documentation. |
| Set file location | If you want to create an Impala table in a directory other than the default one, select<br>this check box and enter the directory in HDFS you want to use to<br>hold the table content.<br><br>This is typical useful when you need to create an external Impala<br>table by selecting the Create an external<br>table check box in the Advanced<br>settings tab. |
| Use S3 endpoint | The Use S3 endpoint check box is<br>displayed when you have selected the Set file<br>location check box to create an external Impala table.<br><br>Once this Use S3 endpoint check box is selected,<br>you need to enter the following parameters in the fields that appear:<br><br><ul> <li> <p> <span>S3 bucket</span>: enter the                            name of the bucket in which you need to create the table.</p> </li> <li> <span>Bucket name</span>: enter the name of the bucket in                        which you want to store the dependencies of your Job. This bucket must                        already exist on S3.</li> <li> <span>Temporary resource folder</span>: enter the                        directory in which you want to store the dependencies of your Job. For                        example, enter <span>temp_resources</span> to write the dependencies in                        the <span>/temp_resources</span> folder in the bucket.<p>If this folder already exists at runtime, its contents are overwritten                            by the upcoming dependencies; otherwise, this folder is automatically                            created.</p> </li> <li> <p> <span>Access key</span> and                                <span>Secret key</span>:                            enter the authentication information required to connect to the Amazon                            S3 bucket to be used. </p> <p>To enter the password, click the <span>[...]</span> button         next to the password field, enter the password in double quotes in the pop-up dialog box,         and click <span>OK</span> to save the settings.</p> </li> </ul><br><br><br>Note that the format of the S3 file is S3N (S3 Native Filesystem).<br><br>Since an Impala table created in S3 is actually an external table, this Use S3 endpoint check box must be used<br>with the Create an external table<br>case being selected. |

## Advanced settings

| Properties | Description |
| --- | --- |
| Like table | Select this check box and enter the name of the Impala table you<br>want to copy. This allows you to copy the definition of an existing<br>table without copying its data. |
| Create an external table | Select this check box to make the table to be created an external<br>Impala table. This kind of Impala table leaves the raw data where it is<br>if the data is in HDFS.<br><br>An external table is usually the better choice for accessing<br>shared data existing in a file system. |
| Table comment | Enter the description you want to use for the table to be<br>created. |
| As select | Select this check box and enter the As select statement for creating an<br>Impala table that is based on a Select<br>statement. |
| Table properties | Add any custom Impala table properties you want to override the<br>default ones used by the Hadoop engine of Talend Studio. |
| tStatCatcher Statistics | Select this check box to collect log data at the 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 works standalone. |