v7

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-0112015.7 KB
Data

Merge Insert

Create a "merge insert" operation This operation can add rows, update rows, and remove rows all in a single transaction. See python method lancedb.table.Table.merge_insert for examples.

post/v1/table/{name}/merge_insert/

Path parameters

namestring required

name of the table

Query parameters

onstring required

The column to use as the primary key for the merge operation.

when_matched_update_allboolean

Rows that exist in both the source table (new data) and the target table (old data) will be updated, replacing the old row with the corresponding matching row.

when_matched_update_all_filtstring

If present then only rows that satisfy the filter expression will be updated

when_not_matched_insert_allboolean

Rows that exist only in the source table (new data) will be inserted into the target table (old data).

when_not_matched_by_source_deleteboolean

Rows that exist only in the target table (old data) will be deleted. An optional condition (when_not_matched_by_source_delete_filt) can be provided to limit what data is deleted.

when_not_matched_by_source_delete_filtstring

The filter expression that specifies the rows to delete.

Response

Merge Insert successful