From 9749eb317d39caa794cc27ef954656167cac487a Mon Sep 17 00:00:00 2001
From: Stefan Majewsky <majewsky@gmx.net>
Date: Thu, 23 Apr 2026 16:26:22 +0200
Subject: add query planning for Upsert()

---
 dialect.go | 45 +++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 43 insertions(+), 2 deletions(-)

(limited to 'dialect.go')

diff --git a/dialect.go b/dialect.go
index d74725e..a098ca2 100644
--- a/dialect.go
+++ b/dialect.go
@@ -4,6 +4,7 @@
 package oblast
 
 import (
+	"fmt"
 	"strconv"
 	"strings"
 )
@@ -37,6 +38,12 @@ type Dialect interface {
 	// If UsesLastInsertID is true, this is usually not needed and the empty
 	// string can be returned.
 	InsertSuffixForAutoColumns(columns []string) string
+
+	// UpsertClause generates an "ON CONFLICT" or similar clause
+	// that can be appended to an INSERT query to make it fall back to
+	// behave like UPDATE if a record with the same primary key already exists.
+	// This is only used for record types that have a primary key.
+	UpsertClause(pkColumns, otherColumns []string) string
 }
 
 // MysqlDialect is the dialect of MySQL and MariaDB databases.
@@ -51,6 +58,20 @@ func (mysqlDialect) QuoteIdentifier(name string) string                 { return
 func (mysqlDialect) UsesLastInsertID() bool                             { return true }
 func (mysqlDialect) InsertSuffixForAutoColumns(columns []string) string { return "" }
 
+func (d mysqlDialect) UpsertClause(pkColumns, otherColumns []string) string {
+	clauses := make([]string, max(1, len(otherColumns)))
+	if len(otherColumns) == 0 {
+		// we need at least one UPDATE clause; if there are no non-PK columns,
+		// we can just use one of the PK columns, updating those is a safe no-op
+		clauses[0] = fmt.Sprintf(`%[1]s = VALUES(%[1]s)`, d.QuoteIdentifier(pkColumns[0]))
+	} else {
+		for idx, name := range otherColumns {
+			clauses[idx] = fmt.Sprintf(`%[1]s = VALUES(%[1]s)`, d.QuoteIdentifier(name))
+		}
+	}
+	return ` ON DUPLICATE KEY UPDATE ` + strings.Join(clauses, ", ")
+}
+
 // PostgresDialect is the dialect of PostgreSQL databases.
 func PostgresDialect() Dialect {
 	return postgresDialect{}
@@ -62,14 +83,31 @@ func (postgresDialect) Placeholder(i int) string           { return "$" + strcon
 func (postgresDialect) QuoteIdentifier(name string) string { return `"` + name + `"` }
 func (postgresDialect) UsesLastInsertID() bool             { return false }
 
-func (p postgresDialect) InsertSuffixForAutoColumns(columns []string) string {
+func (d postgresDialect) InsertSuffixForAutoColumns(columns []string) string {
 	quotedColumns := make([]string, len(columns))
 	for idx, name := range columns {
-		quotedColumns[idx] = p.QuoteIdentifier(name)
+		quotedColumns[idx] = d.QuoteIdentifier(name)
 	}
 	return ` RETURNING ` + strings.Join(quotedColumns, ", ")
 }
 
+func (d postgresDialect) UpsertClause(pkColumns, otherColumns []string) string {
+	quotedPkColumns := make([]string, len(pkColumns))
+	for idx, name := range pkColumns {
+		quotedPkColumns[idx] = d.QuoteIdentifier(name)
+	}
+	clauses := make([]string, len(otherColumns))
+	for idx, name := range otherColumns {
+		clauses[idx] = fmt.Sprintf(`%[1]s = EXCLUDED.%[1]s`, d.QuoteIdentifier(name))
+	}
+	if len(otherColumns) == 0 {
+		return fmt.Sprintf(` ON CONFLICT (%s) DO NOTHING`, strings.Join(quotedPkColumns, ", "))
+	} else {
+		return fmt.Sprintf(` ON CONFLICT (%s) DO UPDATE SET %s`,
+			strings.Join(quotedPkColumns, ", "), strings.Join(clauses, ", "))
+	}
+}
+
 // SqliteDialect is the dialect of SQLite databases.
 func SqliteDialect() Dialect {
 	return sqliteDialect{}
@@ -81,3 +119,6 @@ func (sqliteDialect) Placeholder(_ int) string                           { retur
 func (sqliteDialect) QuoteIdentifier(name string) string                 { return `"` + name + `"` }
 func (sqliteDialect) UsesLastInsertID() bool                             { return true }
 func (sqliteDialect) InsertSuffixForAutoColumns(columns []string) string { return "" }
+func (sqliteDialect) UpsertClause(pkColumns, otherColumns []string) string {
+	return postgresDialect{}.UpsertClause(pkColumns, otherColumns)
+}
-- 
cgit v1.2.3