Upsert Records to a Database Using Merge

Updated: Jan 22, 2023

This example will show you how you can use DataPipline to upsert records to a database using Merge.

To accomplish this both JdbcUpsertWriter and MergeUpsert will be used.

This example can be easily modified to Upsert Records to MySql or MariaDB or Upsert Records to PostgreSql.

Input CSV file

101,Hewitt,Jennifer Love,0,17000.00,1985-5-25,B

Java code listing

package com.northconcepts.datapipeline.examples.cookbook;

import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.PreparedStatement;

import com.northconcepts.datapipeline.core.DataException;
import com.northconcepts.datapipeline.core.DataReader;
import com.northconcepts.datapipeline.core.DataWriter;
import com.northconcepts.datapipeline.csv.CSVReader;
import com.northconcepts.datapipeline.csv.CSVWriter;
import com.northconcepts.datapipeline.jdbc.JdbcReader;
import com.northconcepts.datapipeline.jdbc.JdbcUpsertWriter;
import com.northconcepts.datapipeline.jdbc.upsert.MergeUpsert;
import com.northconcepts.datapipeline.job.Job;

public class MergeUpsertRecords {

	public static void main(String[] args) {

		final String DATABASE_DRIVER = "org.hsqldb.jdbcDriver";
		final String DATABASE_URL = "jdbc:hsqldb:mem:aname";
		final String DATABASE_USERNAME = "sa";
		final String DATABASE_PASSWORD = "";
		final String DATABASE_TABLE = "CreditBalance";
		final String PRIMARY_KEY = "Account";

		Connection connection;
		try {
			connection = DriverManager.getConnection(DATABASE_URL, DATABASE_USERNAME, DATABASE_PASSWORD);

		} catch (Throwable e) {
			throw DataException.wrap(e);

		DataReader reader = new CSVReader(new File("example/data/input/credit-balance-02.csv")).setFieldNamesInFirstRow(true);
		DataWriter writer = new JdbcUpsertWriter(connection, DATABASE_TABLE, new MergeUpsert(), PRIMARY_KEY);, writer);

		reader = new JdbcReader(connection, "Select * from CreditBalance;");
		writer = new CSVWriter(new OutputStreamWriter(System.out));, writer);

	public static void createTable(Connection connection) throws Throwable{
		PreparedStatement preparedStatement;
		String dropTableQuery = "DROP TABLE CreditBalance IF EXISTS;";
		String createTableQuery = "CREATE TABLE CreditBalance ("
			+ "Account INTEGER, "
			+ "LastName VARCHAR(256), "
			+ "FirstName VARCHAR(256), "
			+ "Balance DOUBLE, "
			+ "CreditLimit DOUBLE, "
			+ "AccountCreated DATE, "
			+ "Rating CHAR, "
			+ "PRIMARY KEY (Account));";

		preparedStatement = connection.prepareStatement(dropTableQuery);

		preparedStatement = connection.prepareStatement(createTableQuery);

Code Walkthrough

  1. First you need to feed your database details.
  2. DriverManager is used to create a connection to the database.
  3. createTable(connection) creates a table CreditBalance .
  4. A CSVReader is created using the file path of the input file credit-balance-02.csv.
  5. The CSVReader.setFieldNamesInFirstRow(true) method is invoked to specify that the names specified in the first row should be used as field names.
  6. JdbcUpsertWriter will write the records to the database table. For this example JdbcUpsertWriter takes four arguments i.e. Connection(connection), Table Name(CreditBalance), strategy(MergeUpsert()) and keyFieldNames(Account).
  7. Data is transferred from the reader to writer via method.
  8. JdbcReader is used to obtain the records from the database using the query Select * from CreditBalance.
  9. CSVWriter is used to write the CSV record to the output console
  10., writer) is used to transfer the data from the reader to the writer.


Writes records to a database table using the upsert idiom (attempt to insert, but update if the duplicate key exists). The default strategy used is GenericUpsert, however, several others are provided: MergeUpsert, VariableFieldsUpsert, and MySqlUpsert.


CSVReader is an input reader which can be used to read CSV files. It is a sub-class of TextReader and inherits the open and close among other methods. The CSVReader.setFieldNamesInFirstRow(true) method causes the CSVReader to use the names specified in the first row of the input data as field names. If this method is not invoked, the fields would be named as A1, A2, etc. similar to MS Excel. If those fields names need to be changed, a rename transformation can be added on top of CSVReader or any other type (Refer Rename a field for example).

HSQLDB (HyperSQL Database)

HSQLDB is an open-source project written in Java, it represents a relational database. It follows the SQL and JDBC standards and supports SQL features such as stored procedures and triggers. It can be used in the in-memory mode, or it can be configured to use disk storage.


A batch-able upsert strategy that relies on the SQL Merge statement.
Sample Generated SQL:
MERGE INTO tableName target USING (VALUES (?)) source(ID) ON target.ID=source.ID
WHEN NOT MATCHED THEN INSERT (col1, col2, col3) VALUES (?, ?, ?)
WHEN MATCHED THEN UPDATE SET SET col1=?, col2=?, col3=?;


The output will be written to both the console and the CreditBalance table.

Console Output

101,Hewitt,Jennifer Love,0.0,17000.0,1985-05-25,B
Mobile Analytics