# Insert / Update

## ![](/files/fBjmD73AFIAWcvzwCysx) Insert / Update

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

The Insert/Update transform first looks up a row in a table using one or more lookup keys. If a table row for the specified keys can’t be found, a new row is inserted.

If it can be found and the fields to update are the same, nothing is done.

If they are not all the same, the row in the table is updated.

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

### Options

| Option                    | Description                                                                                                                                                            |
| ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Commit size               | The number of rows to change (insert / update) before running a commit.                                                                                                |
| Connection                | The database connection to which data is written                                                                                                                       |
| Don’t perform any updates | If enabled, the values in the database are never updated;only inserts are performed.                                                                                   |
| Key Lookup table          | Allows you to specify a list of field values and comparators. You can use the following comparators: =, = \~NULL, <>, <, ⇐, >, >=, LIKE, BETWEEN, IS NULL, IS NOT NULL |
| SQL button                | Click SQL to generate the SQL to create the table and indexes for correct operation.                                                                                   |
| Transform name            | Name of the transform; this name has to be unique in a single pipeline.                                                                                                |
| Target schema             | The name of the Schema for the table to which data is written. This is important for data sources that allow for table names with periods in them.                     |
| Target table              | Name of the table in which you want to do the insert or update.                                                                                                        |
| Update Fields             | Allows you to specify all fields in the table you want to insert/update including the keys. Avoid updates on certain fields by specifying N in the update column.      |


---

# 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/insertupdate.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.
