Executes the merge insert operation

This function updates the original dataset and returns a dictionary with information about merge statistics - i.e. the number of inserted, updated, and deleted rows.

Parameters:

data_obj : ReaderLike¶

The new data to use as the source table for the operation. This parameter can be any source of data (e.g. table / dataset) that write_dataset() accepts.

schema : Optional[pa.Schema]¶

The schema of the data. This only needs to be supplied whenever the data source is some kind of generator.