Interface InsertValuesStepN<R extends Record>

All Superinterfaces:

Attachable, AttachableQueryPart, DMLQuery<R>, Flow.Publisher<Integer>, Insert<R>, InsertFinalStep<R>, InsertOnDuplicateStep<R>, InsertReturningStep<R>, Publisher<Integer>, org.reactivestreams.Publisher<Integer>, Query, QueryPart, RowCountQuery, Serializable, Statement

public interface InsertValuesStepN<R extends Record>
extends InsertOnDuplicateStep<R>

This type is used for the Insert's DSL API.

Example:

using(configuration)
      .insertInto(table, fields)
      .values(fields)
      .values(fields)
      .onDuplicateKeyUpdate()
      .set(field1, value1)
      .set(field2, value2)
      .execute();

Author:

Lukas Eder

Method Summary

Modifier and Type	Method	Description
@NotNull InsertOnDuplicateStep<R>	select(Select<? extends Record> select)	Use a SELECT statement as the source of values for the INSERT statement
@NotNull InsertValuesStepN<R>	values(Object... values)	Add a single row of values to the insert statement.
@NotNull InsertValuesStepN<R>	values(Collection<?> values)	Add a single row of values to the insert statement.
@NotNull InsertValuesStepN<R>	values(Field<?>... values)	Add a single row of values to the insert statement.
@NotNull InsertValuesStepN<R>	values(Record values)	Add a single row of values to the insert statement.
@NotNull InsertValuesStepN<R>	values(RowN values)	Add a single row of values to the insert statement.
@NotNull InsertValuesStepN<R>	valuesOfRecords(Collection<? extends Record> values)	Add multiple rows of values to the insert statement.
@NotNull InsertValuesStepN<R>	valuesOfRecords(Record... values)	Add multiple rows of values to the insert statement.
@NotNull InsertValuesStepN<R>	valuesOfRows(Collection<? extends RowN> values)	Add multiple rows of values to the insert statement.
@NotNull InsertValuesStepN<R>	valuesOfRows(RowN... values)	Add multiple rows of values to the insert statement.

Methods inherited from interface Attachable

attach, configuration, detach

Methods inherited from interface AttachableQueryPart

getBindValues, getParam, getParams, getSQL, getSQL

Methods inherited from interface InsertOnDuplicateStep

onConflict, onConflict, onConflictDoNothing, onConflictOnConstraint, onConflictOnConstraint, onConflictOnConstraint, onDuplicateKeyIgnore, onDuplicateKeyUpdate

Methods inherited from interface InsertReturningStep

returning, returning, returning, returningResult, returningResult, returningResult, returningResult, returningResult, returningResult, returningResult, returningResult, returningResult, returningResult, returningResult, returningResult, returningResult, returningResult, returningResult, returningResult, returningResult, returningResult, returningResult, returningResult, returningResult, returningResult, returningResult, returningResult

Methods inherited from interface Publisher

subscribe

Methods inherited from interface org.reactivestreams.Publisher

subscribe

Methods inherited from interface Query

bind, bind, cancel, execute, executeAsync, executeAsync, executeLarge, executeLargeAsync, executeLargeAsync, isExecutable, keepStatement, poolable, queryTimeout

Methods inherited from interface QueryPart

$replace, $replace, $traverse, $traverse, equals, hashCode, toString

Methods inherited from interface RowCountQuery

largePublisher

Method Details

values

@NotNull
@CheckReturnValue
@Support
@NotNull InsertValuesStepN<R> values(Object... values)

Add a single row of values to the insert statement.

values

@NotNull
@CheckReturnValue
@Support
@NotNull InsertValuesStepN<R> values(Field<?>... values)

Add a single row of values to the insert statement.

values

@NotNull
@CheckReturnValue
@Support
@NotNull InsertValuesStepN<R> values(Collection<?> values)

Add a single row of values to the insert statement.

values

@NotNull
@CheckReturnValue
@Support
@NotNull InsertValuesStepN<R> values(RowN values)

Add a single row of values to the insert statement.

values

@NotNull
@CheckReturnValue
@Support
@NotNull InsertValuesStepN<R> values(Record values)

Add a single row of values to the insert statement.

valuesOfRows

@NotNull
@CheckReturnValue
@Support
@NotNull InsertValuesStepN<R> valuesOfRows(RowN... values)

Add multiple rows of values to the insert statement.

This is equivalent to calling the other values clauses multiple times, but allows for dynamic construction of row arrays.

See Also:

• Rows.toRowArray(Function, Function)

valuesOfRows

@NotNull
@CheckReturnValue
@Support
@NotNull InsertValuesStepN<R> valuesOfRows(Collection<? extends RowN> values)

Add multiple rows of values to the insert statement.

This is equivalent to calling the other values clauses multiple times, but allows for dynamic construction of row arrays.

See Also:

• Rows.toRowList(Function, Function)

valuesOfRecords

@NotNull
@CheckReturnValue
@Support
@NotNull InsertValuesStepN<R> valuesOfRecords(Record... values)

Add multiple rows of values to the insert statement.

This is equivalent to calling the other values clauses multiple times, but allows for dynamic construction of row arrays.

Note: Irrespective of individual Record.touched() or Record.modified() flag values, all record values are copied to the VALUES clause using Record.intoArray(), to match insert columns by position, not by name. If you prefer omitting untouched or unmodified values and adding values by field name rather than by index, use InsertSetStep.set(Record...) instead. That syntax is available only if you omit the explicit insert columns list.

valuesOfRecords

@NotNull
@CheckReturnValue
@Support
@NotNull InsertValuesStepN<R> valuesOfRecords(Collection<? extends Record> values)

Add multiple rows of values to the insert statement.

This is equivalent to calling the other values clauses multiple times, but allows for dynamic construction of row arrays.

Note: Irrespective of individual Record.touched() or Record.modified() flag values, all record values are copied to the VALUES clause using Record.intoArray(), to match insert columns by position, not by name. If you prefer omitting untouched or unmodified values and adding values by field name rather than by index, use InsertSetStep.set(Record...) instead. That syntax is available only if you omit the explicit insert columns list.

select

@NotNull
@CheckReturnValue
@Support
@NotNull InsertOnDuplicateStep<R> select(Select<? extends Record> select)

Use a SELECT statement as the source of values for the INSERT statement

This variant of the INSERT … SELECT statement expects a select returning exactly as many fields as specified previously in the INTO clause: DSLContext.insertInto(Table)