update comment

Author: vincentlauvlwj

ktorm-support-sqlite/src/main/kotlin/org/ktorm/support/sqlite/InsertOrUpdate.kt

@@ -62,7 +62,7 @@ public data class InsertOrUpdateExpression(
  *     set(it.salary, 1000)
  *     set(it.hireDate, LocalDate.now())
  *     set(it.departmentId, 1)
- *     onConflict(it.id) {
+ *     onConflict {
  *         set(it.salary, it.salary + 900)
  *     }
  * }
@@ -76,6 +76,32 @@ public data class InsertOrUpdateExpression(
  * on conflict (id) do update set salary = t_employee.salary + ?
  * ```
  *
+ * By default, the column used in the `on conflict` statement is the primary key you already defined in
+ * the schema definition. If you want, you can specify one or more columns for the `on conflict` statement
+ * as belows:
+ *
+ * ```kotlin
+ * database.insertOrUpdate(Employees) {
+ *     set(it.id, 1)
+ *     set(it.name, "vince")
+ *     set(it.job, "engineer")
+ *     set(it.salary, 1000)
+ *     set(it.hireDate, LocalDate.now())
+ *     set(it.departmentId, 1)
+ *     onConflict(it.name, it.job) {
+ *         set(it.salary, it.salary + 900)
+ *     }
+ * }
+ * ```
+ *
+ * Generated SQL:
+ *
+ * ```sql
+ * insert into t_employee (id, name, job, salary, hire_date, department_id)
+ * values (?, ?, ?, ?, ?, ?)
+ * on conflict (name, job) do update set salary = t_employee.salary + ?
+ * ```
+ *
  * @param table the table to be inserted.
  * @param block the DSL block used to construct the expression.
  * @return the effected row count.
@@ -116,6 +142,33 @@ public fun <T : BaseTable<*>> Database.insertOrUpdate(
  * returning id
  * ```
  *
+ * By default, the column used in the `on conflict` statement is the primary key you already defined in
+ * the schema definition. If you want, you can specify one or more columns for the `on conflict` statement
+ * as belows:
+ *
+ * ```kotlin
+ * val id = database.insertOrUpdateReturning(Employees, Employees.id) {
+ *     set(it.id, 1)
+ *     set(it.name, "vince")
+ *     set(it.job, "engineer")
+ *     set(it.salary, 1000)
+ *     set(it.hireDate, LocalDate.now())
+ *     set(it.departmentId, 1)
+ *     onConflict(it.name, it.job) {
+ *         set(it.salary, it.salary + 900)
+ *     }
+ * }
+ * ```
+ *
+ * Generated SQL:
+ *
+ * ```sql
+ * insert into t_employee (id, name, job, salary, hire_date, department_id)
+ * values (?, ?, ?, ?, ?, ?)
+ * on conflict (name, job) do update set salary = t_employee.salary + ?
+ * returning id
+ * ```
+ *
  * @since 3.6.0
  * @param table the table to be inserted.
  * @param returning the column to return
@@ -162,6 +215,33 @@ public fun <T : BaseTable<*>, C : Any> Database.insertOrUpdateReturning(
  * returning id, job
  * ```
  *
+ * By default, the column used in the `on conflict` statement is the primary key you already defined in
+ * the schema definition. If you want, you can specify one or more columns for the `on conflict` statement
+ * as belows:
+ *
+ * ```kotlin
+ * val (id, job) = database.insertOrUpdateReturning(Employees, Pair(Employees.id, Employees.job)) {
+ *     set(it.id, 1)
+ *     set(it.name, "vince")
+ *     set(it.job, "engineer")
+ *     set(it.salary, 1000)
+ *     set(it.hireDate, LocalDate.now())
+ *     set(it.departmentId, 1)
+ *     onConflict(it.name, it.job) {
+ *         set(it.salary, it.salary + 900)
+ *     }
+ * }
+ * ```
+ *
+ * Generated SQL:
+ *
+ * ```sql
+ * insert into t_employee (id, name, job, salary, hire_date, department_id)
+ * values (?, ?, ?, ?, ?, ?)
+ * on conflict (name, job) do update set salary = t_employee.salary + ?
+ * returning id, job
+ * ```
+ *
  * @since 3.6.0
  * @param table the table to be inserted.
  * @param returning the columns to return
@@ -210,6 +290,34 @@ public fun <T : BaseTable<*>, C1 : Any, C2 : Any> Database.insertOrUpdateReturni
  * returning id, job, salary
  * ```
  *
+ * By default, the column used in the `on conflict` statement is the primary key you already defined in
+ * the schema definition. If you want, you can specify one or more columns for the `on conflict` statement
+ * as belows:
+ *
+ * ```kotlin
+ * val (id, job, salary) =
+ * database.insertOrUpdateReturning(Employees, Triple(Employees.id, Employees.job, Employees.salary)) {
+ *     set(it.id, 1)
+ *     set(it.name, "vince")
+ *     set(it.job, "engineer")
+ *     set(it.salary, 1000)
+ *     set(it.hireDate, LocalDate.now())
+ *     set(it.departmentId, 1)
+ *     onConflict(it.name, it.job) {
+ *         set(it.salary, it.salary + 900)
+ *     }
+ * }
+ * ```
+ *
+ * Generated SQL:
+ *
+ * ```sql
+ * insert into t_employee (id, name, job, salary, hire_date, department_id)
+ * values (?, ?, ?, ?, ?, ?)
+ * on conflict (name, job) do update set salary = t_employee.salary + ?
+ * returning id, job, salary
+ * ```
+ *
  * @since 3.6.0
  * @param table the table to be inserted.
  * @param returning the columns to return