From PostgreSQL wiki

Jump to: navigation, search



Note: MERGE is often used interchangeably with the term UPSERT (the linked page discusses the progress of UPSERT implementations in Postgresql).
In the latest PostgreSQL release 9.3.4 (as of 3/21/14), MERGE is not implemented.
Reference: Merge #1 on most requested features list, with 565 votes as of 5/22/14
Reference: Merge requested feature detail.
Reference: SQL 2011 unsupported features, see feature F312
Postgres 9.4 release is targeted for 3Q 2014 (Roadmap as of 3/21/14), and it seems this release will also not contain the MERGE or Upsert features, according to 2014 blog posts (Craig Kerstiens and Armin Ronacher) linked below.


MERGE is typically used to merge two tables, and was introduced in the 2003 SQL standard. The REPLACE statement (a MySQL extension) or UPSERT sequence attempts an UPDATE, or on failure, INSERT. This is similar to UPDATE, then for unmatched rows, INSERT. Whether concurrent access allows modifications which could cause row loss is implementation independent.

To implement this cleanly requires that the table have a unique index so duplicate checking can be easily performed. It is possible to do it without a unique index if we require the user to LOCK the table before the MERGE.


Discussion of MERGE progress in PostgreSQL:

Likely Implementation Order

Note: This section is from 2010 and may not reflect current progress.

Due to the way this feature needs to be implemented internally, the following is the likely sequence in which this feature will be built:

  1. PostgreSQL doesn't have a good way to lock access to a key value that doesn't exist yet--what other databases call key range locking (SQL Server for example). Improvements to the index implementation are needed to allow this feature.
  2. Add a subset of MERGE support sufficient to implement REPLACE/UPSERT. The full MERGE feature set is a bit broader than this.
  3. Document how to use the new MERGE feature in lieu of REPLACE/UPSERT, to make transitions easier for users of other databases. Actually adding other vendor's non-standard syntax to make other apps work transparently is unlikely to be accepted as a patch.
  4. Complete implementing the entirety of the feature set for SQL MERGE.
Personal tools