# Row Normaliser

## <img src="/files/9fFRSG8RkE2R92dIE5bi" alt="" data-size="line"> Row Normaliser

### Description <a href="#description" id="description"></a>

The Row Normaliser transform converts the columns of an input stream into rows.

You can use this transform to normalize repeating groups of columns.

{% hint style="warning" %}
**Important**: When combining multiple columns with different meta types (e.g., String and Integer) into a new field, no automatic type conversion is performed. Instead the first meta type is set. This lack of conversion may lead to issues with subsequent transformations on the resulting data rows. It is strongly advised to ensure that the data types of values being put into the same field are aligned before normalization.
{% endhint %}

| Hop Engine | <sup>✓</sup> |
| ---------- | ------------ |
| Spark      | <sup>✓</sup> |
| Flink      | <sup>✓</sup> |
| Dataflow   | <sup>✓</sup> |

### Options

| Option         | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Transform name | Name of the transform, this name has to be unique in a single pipeline.                                                                                                                                                                                                                                                                                                                                                                                     |
| Typefield      | The name of the type field (**key** in the example below).                                                                                                                                                                                                                                                                                                                                                                                                  |
| Fields table   | <p>A list of the fields you want to normalize; you must set the following properties for each selected field:</p><p>\* Fieldname: Name of the fields to normalize, as you get them from the input transform. \* Type: Give a string to classify the field (you can use the same field names, or input custom strings). \* New field: You can give one or more fields where the new value should transferred to (<strong>value</strong> in our example).</p> |
| Get Fields     | Click to retrieve a list of all fields coming in on the stream(s).                                                                                                                                                                                                                                                                                                                                                                                          |

### Example

#### Input data

| RecordID    | FirstName | LastName      | City        |
| ----------- | --------- | ------------- | ----------- |
| 345-12-0000 | Mitchel   | Runolfsdottir | Jerryside   |
| 976-67-7113 | Elden     | Welch         | Lake Jamaal |
| 824-21-0000 | Rory      | Ledner        | Scottieview |

#### Normalized data (example 1)

Set **Typefield** = "key" and use the **Get Fields** button to load all the fields for normalization, set also **New field** = "value" in all rows. The result is:

| key       | value         |
| --------- | ------------- |
| RecordID  | 345-12-0000   |
| FirstName | Mitchel       |
| LastName  | Runolfsdottir |
| City      | Jerryside     |
| RecordID  | 976-67-7113   |
| FirstName | Elden         |
| LastName  | Welch         |
| City      | Lake Jamaal   |
| RecordID  | 824-21-0000   |
| FirstName | Rory          |
| LastName  | Ledner        |
| City      | Scottieview   |

#### Normalized data (example 2)

Similar to example 1, but remove the **RecordID** field from the **Fields table**. The result is:

| RecordID    | key       | value         |
| ----------- | --------- | ------------- |
| 345-12-0000 | FirstName | Mitchel       |
| 345-12-0000 | LastName  | Runolfsdottir |
| 345-12-0000 | City      | Jerryside     |
| 976-67-7113 | FirstName | Elden         |
| 976-67-7113 | LastName  | Welch         |
| 976-67-7113 | City      | Lake Jamaal   |
| 824-21-0000 | FirstName | Rory          |
| 824-21-0000 | LastName  | Ledner        |
| 824-21-0000 | City      | Scottieview   |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.primeur.com/data-shaper-1.21/knowing-the-data-shaper-designer/pipelines/transforms/rownormaliser.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.