Method BuildQuery

go/sql/builder.go:897–908

BuildQuery builds the arguments array for a DML event INSERT query. It returns the query string and the shared arguments array. Returns an error if the number of arguments differs from the number of table columns.

(args []interface{})

// It returns the query string and the shared arguments array.
// Returns an error if the number of arguments differs from the number of table columns.
func (b *DMLInsertQueryBuilder) BuildQuery(args []interface{}) (string, []interface{}, error) {
	if len(args) != b.tableColumns.Len() {
		return "", nil, fmt.Errorf("args count differs from table column count in BuildDMLInsertQuery")
	}
	sharedArgs := make([]interface{}, 0, b.sharedColumns.Len())
	for _, column := range b.sharedColumns.Columns() {
		tableOrdinal := b.tableColumns.Ordinals[column.Name]
		arg := column.convertArg(args[tableOrdinal])
		sharedArgs = append(sharedArgs, arg)
	}
	return b.preparedStatement, sharedArgs, nil
}

// DMLUpdateQueryBuilder can build UPDATE queries for DML events.
// It holds the prepared query statement so it doesn't need to be recreated every time.