# tChunking

Available in...

* Cloud Data Fabric
* Data Fabric
* Qlik Talend Cloud Enterprise Edition
* Real-Time Big Data Platform

Breaks down large texts into smaller, and more manageable chunks.

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

## tChunking Standard Properties

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

The Standard tChunking component belongs to the AI family.

## Basic settings

| Properties | Description |
| --- | --- |
| Schema and Edit 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>Sync        columns</span> to retrieve the schema from the previous component connected in the      Job.</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>: You create and store the schema locally for this component                only.</p> </li> <li> <p> <span>Repository</span>: You have already created the schema and stored it in the                Repository. You can reuse it in various projects and Job designs.</p> </li> </ul> |
| Split column | Select the column that must be broken down into chunks. |
| Chunking method | Select the method from the drop-down list:<br><br><ul> <li> <span>Fixed-size</span>: Each chunk contains the same number of								characters.</li> <li> <span>Token-based</span>: Each chunk contains the same								number of tokens.</li> </ul><br><br>The chunks will be the exact defined size or less. |
| Chunk size | Enter the maximum number of characters or tokens that a chunk must contain.<br><br>When the<br>Chunking method is:<br><br><ul> <li> <span>Fixed-size</span>. The size is based on the									number of characters. For example, <kbd>How are										you?</kbd> equals 12 characters.</li> <li> <span>Token-based</span>. The size is based on the									token. <kbd>How are you?</kbd> equals 4 tokens.										<kbd>How</kbd>, <kbd>are</kbd>,										<kbd>you</kbd> and <kbd>?</kbd> are									1 token each.</li> </ul> |
| Chunk overlap | Enter the number of characters or tokens that should overlap between two<br>adjacent chunks. This number must be less than the Chunk<br>size.<br><br>Overlapping ensures continuity and context between chunks, and prevents<br>the segmentation from disrupting the flow and coherence of the<br>text.<br><br>The overlap is based on the chunking method, Fixed-size or<br>Token-based. |
| Tokenizer | This option is available when Token-based is selected as<br>Chunking method.<br><br>Select the model from the<br>drop-down list.<br><br>Hugging Face may take more time than the other<br>models. |

## Advanced settings

| Properties | Description |
| --- | --- |
| tStatCatcher<br>Statistics | Select this check box to gather the Job processing metadata at the Job<br>level as well as at each component level. |

## Global Variables

| Variables | Description |
| --- | --- |
| ERROR\_MESSAGE | The error message generated by the component when an error<br>occurs. This is an After variable and it returns a string. |
| NB\_LINE | The number of rows processed. This is an After variable and<br>it returns an integer. |

## Usage

| Usage guidance | Description |
| --- | --- |
| **Usage rule** | This component is used as an intermediate step. It requires an input and<br>output flows. |