Skip to content

Update upserting.md #211

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
szarnyasg merged 2 commits into from
Oct 13, 2025
Merged

Update upserting.md #211

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
f0a342e
Update upserting.md
johangithub Oct 12, 2025
5f1eb8a
Update docs/stable/duckdb/usage/upserting.md
szarnyasg Oct 13, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 12 additions & 10 deletions docs/stable/duckdb/usage/upserting.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ MERGE INTO people
USING (
SELECT
unnest([3, 1]) AS id,
unnest(['Sarah', 'Jhon']) AS name,
unnest(['Sarah', 'John']) AS name,
unnest([95_000.0, 105_000.0]) AS salary
) AS upserts
ON (upserts.id = people.id)
Expand All @@ -45,9 +45,10 @@ FROM people;

| id | name | salary |
|---:|-------|---------:|
| 1 | Jhon | 92000.0 |
| 2 | Anna | 100000.0 |
| 1 | John | 105000.0 |
| 3 | Sarah | 95000.0 |
| 2 | Anna | 105000.0 |



In the previous example we are updating the whole row if `id` matches. However, it is also a common pattern to receive a change set with some keys and the changed value. This is a good use for `SET`.
Expand All @@ -67,17 +68,17 @@ FROM people;

| id | name | salary |
|---:|-------|---------:|
| 2 | Anna | 100000.0 |
| 3 | Sarah | 95000.0 |
| 2 | Anna | 105000.0 |
| 1 | Jhon | 98000.0 |
| 1 | John | 98000.0 |

Another common pattern is to receive a delete set of rows, which may only contain ids of rows to be deleted.

```sql
MERGE INTO people
USING (
SELECT
1 AS id,
1 AS id
) AS deletes
ON (deletes.id = people.id)
WHEN MATCHED THEN DELETE;
Expand All @@ -87,10 +88,11 @@ FROM people;

| id | name | salary |
|---:|-------|---------:|
| 2 | Anna | 100000.0 |
| 3 | Sarah | 95000.0 |
| 2 | Anna | 105000.0 |

`MERGE INTO` also supports more complex conditions, for example for a given delete set we can decide to only remove rows that contain a `salary` bigger than a certain amount.

`MERGE INTO` also supports more complex conditions, for example for a given delete set we can decide to only remove rows that contain a `salary` greater than or equal to a certain amount.

```sql
MERGE INTO people
Expand All @@ -99,7 +101,7 @@ MERGE INTO people
unnest([3, 2]) AS id
) AS deletes
ON (deletes.id = people.id)
WHEN MATCHED AND people.salary > 100_000.0 THEN DELETE;
WHEN MATCHED AND people.salary >= 100_000.0 THEN DELETE;

FROM people;
```
Expand All @@ -117,7 +119,7 @@ MERGE INTO people
USING (
SELECT
unnest([3, 1]) AS id,
unnest(['Sarah', 'Jhon']) AS name,
unnest(['Sarah', 'John']) AS name,
unnest([95_000.0, 105_000.0]) AS salary
) AS upserts
ON (upserts.id = people.id)
Expand Down