version.ドキュメントリファレンスクエリクエリのDSL更新UPDATEクエリ更新のためのクエリ概要UPDATEクエリはQueryDslのupdateとそれに続く関数を呼び出して構築します。クエリ実行時にキーが重複した場合、org.komapper.core.UniqueConstraintExceptionがスローされます。singleエンティティ1件を更新するにはsingleを呼び出します。?*/このクエリを実行した場合の戻り値は更新されたデータを表す新しいエンティティです。下記のマッピング定義に応じて、発行されるSQLにも新しいエンティティにも適切な値が反映されます。@KomapperId@KomapperVersion@KomapperUpdatedAtクエリ実行時に楽観的排他制御が失敗した場合、org.komapper.core.OptimisticLockExceptionがスローされます。batchバッチでエンティティ複数件を更新するにはbatchを呼び出します。?*/このクエリを実行した場合の戻り値は更新されたデータを表す新しいエンティティのリストです。下記のマッピング定義に応じて、発行されるSQLにも新しいエンティティにも適切な値が反映されます。@KomapperVersion@KomapperUpdatedAtクエリ実行時に楽観的排他制御が失敗した場合、org.komapper.core.OptimisticLockExceptionがスローされます。実行で特定のプロパティのみを更新対象に含めるには事前にinclude関数を呼び出します。実行で特定のプロパティを更新対象から除外するには事前にexclude関数を呼び出します。?*/set任意のプロパティに更新データをセットするにはset関数にラムダ式を渡します。ラムダ式の中ではeq関数を使って値を設定できます。?*/eqIfNotNullを使って値がnullでない場合にのみ値を設定することもできます。1}これらのクエリを実行した場合の戻り値は更新された件数です。以下のマッピング定義を持つプロパティについて明示的にeqを呼び出さない場合、発行されるSQLに自動で値が設定されます。明示的にeqを呼び出した場合は明示した値が優先されます。@KomapperVersion@KomapperUpdatedAtwhere任意の条件にマッチする行を更新するにはwhereを呼び出します。?*/デフォルトではWHERE句の指定は必須でありWHERE句が指定されない場合は例外が発生します。意図的に全件更新を認める場合はoptionsを呼び出してallowMissingWhereClauseにtrueを設定します。true)}このクエリを実行した場合の戻り値は更新された件数です。returning以下の関数の後続でreturning関数を呼び出すことで、更新された値を取得できます。singlesetsingle関数の後続でreturning関数を呼び出す例です。VERSION*/returning関数にプロパティを指定することで取得対象のカラムを限定できます。VERSION*/Warningreturning関数は次のDialectでのみサポートされています。Serveroptionsクエリの挙動をカスタマイズするにはoptionsを呼び出します。ラムダ式のパラメータはデフォルトのオプションを表します。変更したいプロパティを指定してcopyメソッドを呼び出してください。)}指定可能なオプションには以下のものがあります。allowMissingWhereClause空のWHERE句を認めるかどうかです。デフォルトはfalseです。escapeSequenceLIKE句に指定されるエスケープシーケンスです。デフォルトはnullでDialectの値を使うことを示します。batchSizeバッチサイズです。デフォルトはnullです。disableOptimisticLock楽観的ロックを無効化するかどうかです。デフォルトはfalseです。この値がtrueのときWHERE句にバージョン番号が含まれません。queryTimeoutSecondsクエリタイムアウトの秒数です。デフォルトはnullでドライバの値を使うことを示します。suppressLoggingSQLのログ出力を抑制するかどうかです。デフォルトはfalseです。suppressOptimisticLockException楽観的ロックの取得に失敗した場合にOptimisticLockExceptionのスローを抑制するかどうかです。デフォルトはfalseです。同名プロパティよりもこちらに明示的に設定した値が優先的に利用されます。