typeorm 0.3.0-rc.9 → 0.3.0

package/query-builder/InsertQueryBuilder.js

@@ -1,371 +1,474 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-var tslib_1 = require("tslib");
-var CockroachDriver_1 = require("../driver/cockroachdb/CockroachDriver");
-var ObserverExecutor_1 = require("../observer/ObserverExecutor");
-var QueryBuilder_1 = require("./QueryBuilder");
-var SqlServerDriver_1 = require("../driver/sqlserver/SqlServerDriver");
-var PostgresDriver_1 = require("../driver/postgres/PostgresDriver");
-var MysqlDriver_1 = require("../driver/mysql/MysqlDriver");
-var RandomGenerator_1 = require("../util/RandomGenerator");
-var InsertResult_1 = require("./result/InsertResult");
-var ReturningStatementNotSupportedError_1 = require("../error/ReturningStatementNotSupportedError");
-var InsertValuesMissingError_1 = require("../error/InsertValuesMissingError");
-var ReturningResultsEntityUpdator_1 = require("./ReturningResultsEntityUpdator");
-var AbstractSqliteDriver_1 = require("../driver/sqlite-abstract/AbstractSqliteDriver");
-var SqljsDriver_1 = require("../driver/sqljs/SqljsDriver");
-var BroadcasterResult_1 = require("../subscriber/BroadcasterResult");
-var __1 = require("../");
-var OracleDriver_1 = require("../driver/oracle/OracleDriver");
-var AuroraDataApiDriver_1 = require("../driver/aurora-data-api/AuroraDataApiDriver");
+exports.InsertQueryBuilder = void 0;
+const QueryBuilder_1 = require("./QueryBuilder");
+const InsertResult_1 = require("./result/InsertResult");
+const ReturningStatementNotSupportedError_1 = require("../error/ReturningStatementNotSupportedError");
+const InsertValuesMissingError_1 = require("../error/InsertValuesMissingError");
+const ReturningResultsEntityUpdator_1 = require("./ReturningResultsEntityUpdator");
+const BroadcasterResult_1 = require("../subscriber/BroadcasterResult");
+const error_1 = require("../error");
+const uuid_1 = require("uuid");
+const DriverUtils_1 = require("../driver/DriverUtils");
+const ObjectUtils_1 = require("../util/ObjectUtils");
+const InstanceChecker_1 = require("../util/InstanceChecker");
 /**
  * Allows to build complex sql queries in a fashion way and execute those queries.
  */
-var InsertQueryBuilder = /** @class */ (function (_super) {
-    tslib_1.__extends(InsertQueryBuilder, _super);
-    function InsertQueryBuilder() {
-        return _super !== null && _super.apply(this, arguments) || this;
+class InsertQueryBuilder extends QueryBuilder_1.QueryBuilder {
+    constructor() {
+        super(...arguments);
+        this["@instanceof"] = Symbol.for("InsertQueryBuilder");
     }
     // -------------------------------------------------------------------------
     // Public Implemented Methods
     // -------------------------------------------------------------------------
     /**
-     * Gets generated sql query without parameters being replaced.
+     * Gets generated SQL query without parameters being replaced.
      */
-    InsertQueryBuilder.prototype.getQuery = function () {
-        var sql = this.createInsertExpression();
+    getQuery() {
+        let sql = this.createComment();
+        sql += this.createInsertExpression();
         return sql.trim();
-    };
+    }
     /**
      * Executes sql generated by query builder and returns raw database results.
      */
-    InsertQueryBuilder.prototype.execute = function () {
-        return tslib_1.__awaiter(this, void 0, void 0, function () {
-            var queryRunner, transactionStartedByUs, valueSets, broadcastResult_1, returningResultsEntityUpdator, _a, sql, parameters, insertResult, _b, broadcastResult_2, error_1, rollbackError_1;
-            var _this = this;
-            return tslib_1.__generator(this, function (_c) {
-                switch (_c.label) {
-                    case 0:
-                        queryRunner = this.obtainQueryRunner();
-                        transactionStartedByUs = false;
-                        _c.label = 1;
-                    case 1:
-                        _c.trys.push([1, 15, 20, 25]);
-                        if (!(this.expressionMap.useTransaction === true && queryRunner.isTransactionActive === false)) return [3 /*break*/, 3];
-                        return [4 /*yield*/, queryRunner.startTransaction()];
-                    case 2:
-                        _c.sent();
-                        transactionStartedByUs = true;
-                        _c.label = 3;
-                    case 3:
-                        valueSets = this.getValueSets();
-                        if (!this.expressionMap.callObservers) return [3 /*break*/, 5];
-                        if (!(this.expressionMap.callListeners === true && this.expressionMap.mainAlias.hasMetadata)) return [3 /*break*/, 5];
-                        broadcastResult_1 = new BroadcasterResult_1.BroadcasterResult();
-                        valueSets.forEach(function (valueSet) {
-                            queryRunner.broadcaster.broadcastBeforeInsertEvent(broadcastResult_1, _this.expressionMap.mainAlias.metadata, valueSet);
-                        });
-                        if (!(broadcastResult_1.promises.length > 0)) return [3 /*break*/, 5];
-                        return [4 /*yield*/, Promise.all(broadcastResult_1.promises)];
-                    case 4:
-                        _c.sent();
-                        _c.label = 5;
-                    case 5:
-                        returningResultsEntityUpdator = new ReturningResultsEntityUpdator_1.ReturningResultsEntityUpdator(queryRunner, this.expressionMap);
-                        if (this.expressionMap.updateEntity === true && this.expressionMap.mainAlias.hasMetadata) {
-                            this.expressionMap.extraReturningColumns = returningResultsEntityUpdator.getInsertionReturningColumns();
-                        }
-                        _a = tslib_1.__read(this.getQueryAndParameters(), 2), sql = _a[0], parameters = _a[1];
-                        insertResult = new InsertResult_1.InsertResult();
-                        // console.time(".query execution by database");
-                        _b = insertResult;
-                        return [4 /*yield*/, queryRunner.query(sql, parameters)];
-                    case 6:
-                        // console.time(".query execution by database");
-                        _b.raw = _c.sent();
-                        if (!(this.expressionMap.updateEntity === true && this.expressionMap.mainAlias.hasMetadata)) return [3 /*break*/, 8];
-                        // console.time(".updating entity");
-                        return [4 /*yield*/, returningResultsEntityUpdator.insert(insertResult, valueSets)];
-                    case 7:
-                        // console.time(".updating entity");
-                        _c.sent();
-                        _c.label = 8;
-                    case 8:
-                        if (!(this.expressionMap.callListeners === true && this.expressionMap.mainAlias.hasMetadata)) return [3 /*break*/, 10];
-                        broadcastResult_2 = new BroadcasterResult_1.BroadcasterResult();
-                        valueSets.forEach(function (valueSet) {
-                            queryRunner.broadcaster.broadcastAfterInsertEvent(broadcastResult_2, _this.expressionMap.mainAlias.metadata, valueSet);
-                        });
-                        if (!(broadcastResult_2.promises.length > 0)) return [3 /*break*/, 10];
-                        return [4 /*yield*/, Promise.all(broadcastResult_2.promises)];
-                    case 9:
-                        _c.sent();
-                        _c.label = 10;
-                    case 10:
-                        if (!transactionStartedByUs) return [3 /*break*/, 12];
-                        return [4 /*yield*/, queryRunner.commitTransaction()];
-                    case 11:
-                        _c.sent();
-                        _c.label = 12;
-                    case 12:
-                        if (!this.expressionMap.callObservers) return [3 /*break*/, 14];
-                        if (!(transactionStartedByUs || (this.expressionMap.useTransaction === false && queryRunner.isTransactionActive === false))) return [3 /*break*/, 14];
-                        return [4 /*yield*/, new ObserverExecutor_1.ObserverExecutor(this.connection.observers).execute()];
-                    case 13:
-                        _c.sent();
-                        _c.label = 14;
-                    case 14: 
-                    // console.timeEnd(".commit");
-                    return [2 /*return*/, insertResult];
-                    case 15:
-                        error_1 = _c.sent();
-                        if (!transactionStartedByUs) return [3 /*break*/, 19];
-                        _c.label = 16;
-                    case 16:
-                        _c.trys.push([16, 18, , 19]);
-                        return [4 /*yield*/, queryRunner.rollbackTransaction()];
-                    case 17:
-                        _c.sent();
-                        return [3 /*break*/, 19];
-                    case 18:
-                        rollbackError_1 = _c.sent();
-                        return [3 /*break*/, 19];
-                    case 19: throw error_1;
-                    case 20:
-                        if (!(queryRunner !== this.queryRunner)) return [3 /*break*/, 22];
-                        return [4 /*yield*/, queryRunner.release()];
-                    case 21:
-                        _c.sent();
-                        _c.label = 22;
-                    case 22:
-                        if (!(this.connection.driver instanceof SqljsDriver_1.SqljsDriver && !queryRunner.isTransactionActive)) return [3 /*break*/, 24];
-                        return [4 /*yield*/, this.connection.driver.autoSave()];
-                    case 23:
-                        _c.sent();
-                        _c.label = 24;
-                    case 24: return [7 /*endfinally*/];
-                    case 25: return [2 /*return*/];
+    async execute() {
+        // console.time(".value sets");
+        const valueSets = this.getValueSets();
+        // console.timeEnd(".value sets");
+        // If user passed empty array of entities then we don't need to do
+        // anything.
+        //
+        // Fixes GitHub issues #3111 and #5734. If we were to let this through
+        // we would run into problems downstream, like subscribers getting
+        // invoked with the empty array where they expect an entity, and SQL
+        // queries with an empty VALUES clause.
+        if (valueSets.length === 0)
+            return new InsertResult_1.InsertResult();
+        // console.time("QueryBuilder.execute");
+        // console.time(".database stuff");
+        const queryRunner = this.obtainQueryRunner();
+        let transactionStartedByUs = false;
+        try {
+            // start transaction if it was enabled
+            if (this.expressionMap.useTransaction === true &&
+                queryRunner.isTransactionActive === false) {
+                await queryRunner.startTransaction();
+                transactionStartedByUs = true;
+            }
+            // console.timeEnd(".database stuff");
+            // call before insertion methods in listeners and subscribers
+            if (this.expressionMap.callListeners === true &&
+                this.expressionMap.mainAlias.hasMetadata) {
+                const broadcastResult = new BroadcasterResult_1.BroadcasterResult();
+                valueSets.forEach((valueSet) => {
+                    queryRunner.broadcaster.broadcastBeforeInsertEvent(broadcastResult, this.expressionMap.mainAlias.metadata, valueSet);
+                });
+                await broadcastResult.wait();
+            }
+            let declareSql = null;
+            let selectOutputSql = null;
+            // if update entity mode is enabled we may need extra columns for the returning statement
+            // console.time(".prepare returning statement");
+            const returningResultsEntityUpdator = new ReturningResultsEntityUpdator_1.ReturningResultsEntityUpdator(queryRunner, this.expressionMap);
+            const returningColumns = [];
+            if (Array.isArray(this.expressionMap.returning) &&
+                this.expressionMap.mainAlias.hasMetadata) {
+                for (const columnPath of this.expressionMap.returning) {
+                    returningColumns.push(...this.expressionMap.mainAlias.metadata.findColumnsWithPropertyPath(columnPath));
                 }
-            });
-        });
-    };
+            }
+            if (this.expressionMap.updateEntity === true &&
+                this.expressionMap.mainAlias.hasMetadata) {
+                if (!(valueSets.length > 1 &&
+                    this.connection.driver.options.type === "oracle")) {
+                    this.expressionMap.extraReturningColumns =
+                        this.expressionMap.mainAlias.metadata.getInsertionReturningColumns();
+                }
+                returningColumns.push(...this.expressionMap.extraReturningColumns.filter((c) => !returningColumns.includes(c)));
+            }
+            if (returningColumns.length > 0 &&
+                this.connection.driver.options.type === "mssql") {
+                declareSql = this.connection.driver.buildTableVariableDeclaration("@OutputTable", returningColumns);
+                selectOutputSql = `SELECT * FROM @OutputTable`;
+            }
+            // console.timeEnd(".prepare returning statement");
+            // execute query
+            // console.time(".getting query and parameters");
+            const [insertSql, parameters] = this.getQueryAndParameters();
+            // console.timeEnd(".getting query and parameters");
+            // console.time(".query execution by database");
+            const statements = [declareSql, insertSql, selectOutputSql];
+            const sql = statements.filter((s) => s != null).join(";\n\n");
+            const queryResult = await queryRunner.query(sql, parameters, true);
+            const insertResult = InsertResult_1.InsertResult.from(queryResult);
+            // console.timeEnd(".query execution by database");
+            // load returning results and set them to the entity if entity updation is enabled
+            if (this.expressionMap.updateEntity === true &&
+                this.expressionMap.mainAlias.hasMetadata) {
+                // console.time(".updating entity");
+                await returningResultsEntityUpdator.insert(insertResult, valueSets);
+                // console.timeEnd(".updating entity");
+            }
+            // call after insertion methods in listeners and subscribers
+            if (this.expressionMap.callListeners === true &&
+                this.expressionMap.mainAlias.hasMetadata) {
+                const broadcastResult = new BroadcasterResult_1.BroadcasterResult();
+                valueSets.forEach((valueSet) => {
+                    queryRunner.broadcaster.broadcastAfterInsertEvent(broadcastResult, this.expressionMap.mainAlias.metadata, valueSet);
+                });
+                await broadcastResult.wait();
+            }
+            // close transaction if we started it
+            // console.time(".commit");
+            if (transactionStartedByUs) {
+                await queryRunner.commitTransaction();
+            }
+            // console.timeEnd(".commit");
+            return insertResult;
+        }
+        catch (error) {
+            // rollback transaction if we started it
+            if (transactionStartedByUs) {
+                try {
+                    await queryRunner.rollbackTransaction();
+                }
+                catch (rollbackError) { }
+            }
+            throw error;
+        }
+        finally {
+            // console.time(".releasing connection");
+            if (queryRunner !== this.queryRunner) {
+                // means we created our own query runner
+                await queryRunner.release();
+            }
+            // console.timeEnd(".releasing connection");
+            // console.timeEnd("QueryBuilder.execute");
+        }
+    }
     // -------------------------------------------------------------------------
     // Public Methods
     // -------------------------------------------------------------------------
     /**
      * Specifies INTO which entity's table insertion will be executed.
      */
-    InsertQueryBuilder.prototype.into = function (entityTarget, columns) {
-        entityTarget = entityTarget instanceof __1.EntitySchema ? entityTarget.options.name : entityTarget;
-        var mainAlias = this.createFromAlias(entityTarget);
+    into(entityTarget, columns) {
+        entityTarget = InstanceChecker_1.InstanceChecker.isEntitySchema(entityTarget)
+            ? entityTarget.options.name
+            : entityTarget;
+        const mainAlias = this.createFromAlias(entityTarget);
         this.expressionMap.setMainAlias(mainAlias);
         this.expressionMap.insertColumns = columns || [];
         return this;
-    };
+    }
     /**
      * Values needs to be inserted into table.
      */
-    InsertQueryBuilder.prototype.values = function (values) {
+    values(values) {
         this.expressionMap.valuesSet = values;
         return this;
-    };
+    }
     /**
      * Optional returning/output clause.
      */
-    InsertQueryBuilder.prototype.output = function (output) {
+    output(output) {
         return this.returning(output);
-    };
+    }
     /**
      * Optional returning/output clause.
      */
-    InsertQueryBuilder.prototype.returning = function (returning) {
+    returning(returning) {
         // not all databases support returning/output cause
-        if (!this.connection.driver.isReturningSqlSupported())
+        if (!this.connection.driver.isReturningSqlSupported("insert")) {
             throw new ReturningStatementNotSupportedError_1.ReturningStatementNotSupportedError();
+        }
         this.expressionMap.returning = returning;
         return this;
-    };
+    }
     /**
      * Indicates if entity must be updated after insertion operations.
      * This may produce extra query or use RETURNING / OUTPUT statement (depend on database).
      * Enabled by default.
      */
-    InsertQueryBuilder.prototype.updateEntity = function (enabled) {
+    updateEntity(enabled) {
         this.expressionMap.updateEntity = enabled;
         return this;
-    };
+    }
     /**
      * Adds additional ON CONFLICT statement supported in postgres and cockroach.
+     *
+     * @deprecated Use `orIgnore` or `orUpdate`
      */
-    InsertQueryBuilder.prototype.onConflict = function (statement) {
+    onConflict(statement) {
         this.expressionMap.onConflict = statement;
         return this;
-    };
+    }
     /**
      * Adds additional ignore statement supported in databases.
      */
-    InsertQueryBuilder.prototype.orIgnore = function (statement) {
-        if (statement === void 0) { statement = true; }
-        this.expressionMap.onIgnore = statement;
+    orIgnore(statement = true) {
+        this.expressionMap.onIgnore = !!statement;
         return this;
-    };
+    }
     /**
      * Adds additional update statement supported in databases.
      */
-    InsertQueryBuilder.prototype.orUpdate = function (statement) {
-        this.expressionMap.onUpdate = {};
-        if (statement && statement.conflict_target instanceof Array)
-            this.expressionMap.onUpdate.conflict = " ( " + statement.conflict_target.join(", ") + " ) ";
-        if (statement && typeof statement.conflict_target === "string")
-            this.expressionMap.onUpdate.conflict = " ON CONSTRAINT " + statement.conflict_target + " ";
-        if (statement && statement.columns instanceof Array)
-            this.expressionMap.onUpdate.columns = statement.columns.map(function (column) { return column + " = :" + column; }).join(", ");
-        if (statement && statement.overwrite instanceof Array) {
-            if (this.connection.driver instanceof MysqlDriver_1.MysqlDriver || this.connection.driver instanceof AuroraDataApiDriver_1.AuroraDataApiDriver) {
-                this.expressionMap.onUpdate.overwrite = statement.overwrite.map(function (column) { return column + " = VALUES(" + column + ")"; }).join(", ");
-            }
-            else if (this.connection.driver instanceof PostgresDriver_1.PostgresDriver || this.connection.driver instanceof AbstractSqliteDriver_1.AbstractSqliteDriver || this.connection.driver instanceof CockroachDriver_1.CockroachDriver) {
-                this.expressionMap.onUpdate.overwrite = statement.overwrite.map(function (column) { return column + " = EXCLUDED." + column; }).join(", ");
-            }
+    orUpdate(statementOrOverwrite, conflictTarget, orUpdateOptions) {
+        if (!Array.isArray(statementOrOverwrite)) {
+            this.expressionMap.onUpdate = {
+                conflict: statementOrOverwrite === null || statementOrOverwrite === void 0 ? void 0 : statementOrOverwrite.conflict_target,
+                columns: statementOrOverwrite === null || statementOrOverwrite === void 0 ? void 0 : statementOrOverwrite.columns,
+                overwrite: statementOrOverwrite === null || statementOrOverwrite === void 0 ? void 0 : statementOrOverwrite.overwrite,
+                skipUpdateIfNoValuesChanged: orUpdateOptions === null || orUpdateOptions === void 0 ? void 0 : orUpdateOptions.skipUpdateIfNoValuesChanged,
+            };
+            return this;
         }
+        this.expressionMap.onUpdate = {
+            overwrite: statementOrOverwrite,
+            conflict: conflictTarget,
+            skipUpdateIfNoValuesChanged: orUpdateOptions === null || orUpdateOptions === void 0 ? void 0 : orUpdateOptions.skipUpdateIfNoValuesChanged,
+        };
         return this;
-    };
+    }
     // -------------------------------------------------------------------------
     // Protected Methods
     // -------------------------------------------------------------------------
     /**
      * Creates INSERT express used to perform insert query.
      */
-    InsertQueryBuilder.prototype.createInsertExpression = function () {
-        var tableName = this.getTableName(this.getMainTableName());
-        var valuesExpression = this.createValuesExpression(); // its important to get values before returning expression because oracle rely on native parameters and ordering of them is important
-        var returningExpression = this.createReturningExpression();
-        var columnsExpression = this.createColumnNamesExpression();
-        var query = "INSERT ";
-        if (this.connection.driver instanceof MysqlDriver_1.MysqlDriver || this.connection.driver instanceof AuroraDataApiDriver_1.AuroraDataApiDriver) {
-            query += "" + (this.expressionMap.onIgnore ? " IGNORE " : "");
+    createInsertExpression() {
+        const tableName = this.getTableName(this.getMainTableName());
+        const valuesExpression = this.createValuesExpression(); // its important to get values before returning expression because oracle rely on native parameters and ordering of them is important
+        const returningExpression = this.connection.driver.options.type === "oracle" &&
+            this.getValueSets().length > 1
+            ? null
+            : this.createReturningExpression("insert"); // oracle doesnt support returning with multi-row insert
+        const columnsExpression = this.createColumnNamesExpression();
+        let query = "INSERT ";
+        if (DriverUtils_1.DriverUtils.isMySQLFamily(this.connection.driver) ||
+            this.connection.driver.options.type === "aurora-mysql") {
+            query += `${this.expressionMap.onIgnore ? " IGNORE " : ""}`;
         }
-        query += "INTO " + tableName;
+        query += `INTO ${tableName}`;
         // add columns expression
         if (columnsExpression) {
-            query += "(" + columnsExpression + ")";
+            query += `(${columnsExpression})`;
         }
         else {
-            if (!valuesExpression && (this.connection.driver instanceof MysqlDriver_1.MysqlDriver || this.connection.driver instanceof AuroraDataApiDriver_1.AuroraDataApiDriver)) // special syntax for mysql DEFAULT VALUES insertion
+            if (!valuesExpression &&
+                (DriverUtils_1.DriverUtils.isMySQLFamily(this.connection.driver) ||
+                    this.connection.driver.options.type === "aurora-mysql"))
+                // special syntax for mysql DEFAULT VALUES insertion
                 query += "()";
         }
         // add OUTPUT expression
-        if (returningExpression && this.connection.driver instanceof SqlServerDriver_1.SqlServerDriver) {
-            query += " OUTPUT " + returningExpression;
+        if (returningExpression &&
+            this.connection.driver.options.type === "mssql") {
+            query += ` OUTPUT ${returningExpression}`;
         }
         // add VALUES expression
         if (valuesExpression) {
-            query += " VALUES " + valuesExpression;
+            if (this.connection.driver.options.type === "oracle" &&
+                this.getValueSets().length > 1) {
+                query += ` ${valuesExpression}`;
+            }
+            else {
+                query += ` VALUES ${valuesExpression}`;
+            }
         }
         else {
-            if (this.connection.driver instanceof MysqlDriver_1.MysqlDriver || this.connection.driver instanceof AuroraDataApiDriver_1.AuroraDataApiDriver) { // special syntax for mysql DEFAULT VALUES insertion
+            if (DriverUtils_1.DriverUtils.isMySQLFamily(this.connection.driver) ||
+                this.connection.driver.options.type === "aurora-mysql") {
+                // special syntax for mysql DEFAULT VALUES insertion
                 query += " VALUES ()";
             }
             else {
-                query += " DEFAULT VALUES";
+                query += ` DEFAULT VALUES`;
             }
         }
-        if (this.connection.driver instanceof PostgresDriver_1.PostgresDriver || this.connection.driver instanceof AbstractSqliteDriver_1.AbstractSqliteDriver || this.connection.driver instanceof CockroachDriver_1.CockroachDriver) {
-            query += "" + (this.expressionMap.onIgnore ? " ON CONFLICT DO NOTHING " : "");
-            query += "" + (this.expressionMap.onConflict ? " ON CONFLICT " + this.expressionMap.onConflict : "");
+        if (this.connection.driver.supportedUpsertType ===
+            "on-conflict-do-update") {
+            if (this.expressionMap.onIgnore) {
+                query += " ON CONFLICT DO NOTHING ";
+            }
+            else if (this.expressionMap.onConflict) {
+                query += ` ON CONFLICT ${this.expressionMap.onConflict} `;
+            }
+            else if (this.expressionMap.onUpdate) {
+                const { overwrite, columns, conflict, skipUpdateIfNoValuesChanged, } = this.expressionMap.onUpdate;
+                let conflictTarget = "ON CONFLICT";
+                if (Array.isArray(conflict)) {
+                    conflictTarget += ` ( ${conflict
+                        .map((column) => this.escape(column))
+                        .join(", ")} )`;
+                }
+                else if (conflict) {
+                    conflictTarget += ` ON CONSTRAINT ${this.escape(conflict)}`;
+                }
+                if (Array.isArray(overwrite)) {
+                    query += ` ${conflictTarget} DO UPDATE SET `;
+                    query += overwrite === null || overwrite === void 0 ? void 0 : overwrite.map((column) => `${this.escape(column)} = EXCLUDED.${this.escape(column)}`).join(", ");
+                    query += " ";
+                }
+                else if (columns) {
+                    query += ` ${conflictTarget} DO UPDATE SET `;
+                    query += columns
+                        .map((column) => `${this.escape(column)} = :${column}`)
+                        .join(", ");
+                    query += " ";
+                }
+                if (Array.isArray(overwrite) &&
+                    skipUpdateIfNoValuesChanged &&
+                    this.connection.driver.options.type === "postgres") {
+                    query += ` WHERE (`;
+                    query += overwrite
+                        .map((column) => `${tableName}.${this.escape(column)} IS DISTINCT FROM EXCLUDED.${this.escape(column)}`)
+                        .join(" OR ");
+                    query += ") ";
+                }
+            }
+        }
+        else if (this.connection.driver.supportedUpsertType ===
+            "on-duplicate-key-update") {
             if (this.expressionMap.onUpdate) {
-                var _a = this.expressionMap.onUpdate, overwrite = _a.overwrite, columns = _a.columns, conflict = _a.conflict;
-                query += "" + (columns ? " ON CONFLICT " + conflict + " DO UPDATE SET " + columns : "");
-                query += "" + (overwrite ? " ON CONFLICT " + conflict + " DO UPDATE SET " + overwrite : "");
+                const { overwrite, columns } = this.expressionMap.onUpdate;
+                if (Array.isArray(overwrite)) {
+                    query += " ON DUPLICATE KEY UPDATE ";
+                    query += overwrite
+                        .map((column) => `${this.escape(column)} = VALUES(${this.escape(column)})`)
+                        .join(", ");
+                    query += " ";
+                }
+                else if (Array.isArray(columns)) {
+                    query += " ON DUPLICATE KEY UPDATE ";
+                    query += columns
+                        .map((column) => `${this.escape(column)} = :${column}`)
+                        .join(", ");
+                    query += " ";
+                }
             }
         }
-        else if (this.connection.driver instanceof MysqlDriver_1.MysqlDriver || this.connection.driver instanceof AuroraDataApiDriver_1.AuroraDataApiDriver) {
+        else {
             if (this.expressionMap.onUpdate) {
-                var _b = this.expressionMap.onUpdate, overwrite = _b.overwrite, columns = _b.columns;
-                query += "" + (columns ? " ON DUPLICATE KEY UPDATE " + columns : "");
-                query += "" + (overwrite ? " ON DUPLICATE KEY UPDATE " + overwrite : "");
+                throw new error_1.TypeORMError(`onUpdate is not supported by the current database driver`);
             }
         }
         // add RETURNING expression
-        if (returningExpression && (this.connection.driver instanceof PostgresDriver_1.PostgresDriver || this.connection.driver instanceof OracleDriver_1.OracleDriver || this.connection.driver instanceof CockroachDriver_1.CockroachDriver)) {
-            query += " RETURNING " + returningExpression;
+        if (returningExpression &&
+            (this.connection.driver.options.type === "postgres" ||
+                this.connection.driver.options.type === "oracle" ||
+                this.connection.driver.options.type === "cockroachdb" ||
+                DriverUtils_1.DriverUtils.isMySQLFamily(this.connection.driver))) {
+            query += ` RETURNING ${returningExpression}`;
+        }
+        // Inserting a specific value for an auto-increment primary key in mssql requires enabling IDENTITY_INSERT
+        // IDENTITY_INSERT can only be enabled for tables where there is an IDENTITY column and only if there is a value to be inserted (i.e. supplying DEFAULT is prohibited if IDENTITY_INSERT is enabled)
+        if (this.connection.driver.options.type === "mssql" &&
+            this.expressionMap.mainAlias.hasMetadata &&
+            this.expressionMap
+                .mainAlias.metadata.columns.filter((column) => this.expressionMap.insertColumns.length > 0
+                ? this.expressionMap.insertColumns.indexOf(column.propertyPath) !== -1
+                : column.isInsert)
+                .some((column) => this.isOverridingAutoIncrementBehavior(column))) {
+            query = `SET IDENTITY_INSERT ${tableName} ON; ${query}; SET IDENTITY_INSERT ${tableName} OFF`;
         }
         return query;
-    };
+    }
     /**
      * Gets list of columns where values must be inserted to.
      */
-    InsertQueryBuilder.prototype.getInsertedColumns = function () {
-        var _this = this;
+    getInsertedColumns() {
         if (!this.expressionMap.mainAlias.hasMetadata)
             return [];
-        return this.expressionMap.mainAlias.metadata.columns.filter(function (column) {
+        return this.expressionMap.mainAlias.metadata.columns.filter((column) => {
             // if user specified list of columns he wants to insert to, then we filter only them
-            if (_this.expressionMap.insertColumns.length)
-                return _this.expressionMap.insertColumns.indexOf(column.propertyPath) !== -1;
+            if (this.expressionMap.insertColumns.length)
+                return (this.expressionMap.insertColumns.indexOf(column.propertyPath) !== -1);
             // skip columns the user doesn't want included by default
             if (!column.isInsert) {
                 return false;
             }
             // if user did not specified such list then return all columns except auto-increment one
             // for Oracle we return auto-increment column as well because Oracle does not support DEFAULT VALUES expression
-            if (column.isGenerated && column.generationStrategy === "increment"
-                && !(_this.connection.driver instanceof OracleDriver_1.OracleDriver)
-                && !(_this.connection.driver instanceof AbstractSqliteDriver_1.AbstractSqliteDriver)
-                && !(_this.connection.driver instanceof MysqlDriver_1.MysqlDriver)
-                && !(_this.connection.driver instanceof AuroraDataApiDriver_1.AuroraDataApiDriver))
+            if (column.isGenerated &&
+                column.generationStrategy === "increment" &&
+                !(this.connection.driver.options.type === "oracle") &&
+                !DriverUtils_1.DriverUtils.isSQLiteFamily(this.connection.driver) &&
+                !DriverUtils_1.DriverUtils.isMySQLFamily(this.connection.driver) &&
+                !(this.connection.driver.options.type === "aurora-mysql") &&
+                !(this.connection.driver.options.type === "mssql" &&
+                    this.isOverridingAutoIncrementBehavior(column)))
                 return false;
             return true;
         });
-    };
+    }
     /**
      * Creates a columns string where values must be inserted to for INSERT INTO expression.
      */
-    InsertQueryBuilder.prototype.createColumnNamesExpression = function () {
-        var _this = this;
-        var columns = this.getInsertedColumns();
+    createColumnNamesExpression() {
+        const columns = this.getInsertedColumns();
         if (columns.length > 0)
-            return columns.map(function (column) { return _this.escape(column.databaseName); }).join(", ");
+            return columns
+                .map((column) => this.escape(column.databaseName))
+                .join(", ");
         // in the case if there are no insert columns specified and table without metadata used
         // we get columns from the inserted value map, in the case if only one inserted map is specified
-        if (!this.expressionMap.mainAlias.hasMetadata && !this.expressionMap.insertColumns.length) {
-            var valueSets = this.getValueSets();
+        if (!this.expressionMap.mainAlias.hasMetadata &&
+            !this.expressionMap.insertColumns.length) {
+            const valueSets = this.getValueSets();
             if (valueSets.length === 1)
-                return Object.keys(valueSets[0]).map(function (columnName) { return _this.escape(columnName); }).join(", ");
+                return Object.keys(valueSets[0])
+                    .map((columnName) => this.escape(columnName))
+                    .join(", ");
         }
         // get a table name and all column database names
-        return this.expressionMap.insertColumns.map(function (columnName) { return _this.escape(columnName); }).join(", ");
-    };
+        return this.expressionMap.insertColumns
+            .map((columnName) => this.escape(columnName))
+            .join(", ");
+    }
     /**
      * Creates list of values needs to be inserted in the VALUES expression.
      */
-    InsertQueryBuilder.prototype.createValuesExpression = function () {
-        var _this = this;
-        var valueSets = this.getValueSets();
-        var columns = this.getInsertedColumns();
+    createValuesExpression() {
+        const valueSets = this.getValueSets();
+        const columns = this.getInsertedColumns();
         // if column metadatas are given then apply all necessary operations with values
         if (columns.length > 0) {
-            var expression_1 = "";
-            var parametersCount_1 = Object.keys(this.expressionMap.nativeParameters).length;
-            valueSets.forEach(function (valueSet, valueSetIndex) {
-                columns.forEach(function (column, columnIndex) {
+            let expression = "";
+            valueSets.forEach((valueSet, valueSetIndex) => {
+                columns.forEach((column, columnIndex) => {
                     if (columnIndex === 0) {
-                        expression_1 += "(";
+                        if (this.connection.driver.options.type === "oracle" &&
+                            valueSets.length > 1) {
+                            expression += " SELECT ";
+                        }
+                        else if (this.connection.driver.options.type === "sap" &&
+                            valueSets.length > 1) {
+                            expression += " SELECT ";
+                        }
+                        else {
+                            expression += "(";
+                        }
                     }
-                    var paramName = "i" + valueSetIndex + "_" + column.databaseName;
                     // extract real value from the entity
-                    var value = column.getEntityValue(valueSet);
+                    let value = column.getEntityValue(valueSet);
                     // if column is relational and value is an object then get real referenced column value from this object
                     // for example column value is { question: { id: 1 } }, value will be equal to { id: 1 }
                     // and we extract "1" from this object
-                    /*if (column.referencedColumn && value instanceof Object && !(value instanceof Function)) { // todo: check if we still need it since getEntityValue already has similar code
+                    /*if (column.referencedColumn && value instanceof Object && !(typeof value === "function")) { // todo: check if we still need it since getEntityValue already has similar code
                         value = column.referencedColumn.getEntityValue(value);
                     }*/
-                    // make sure our value is normalized by a driver
-                    value = _this.connection.driver.preparePersistentValue(value, column);
+                    if (!(typeof value === "function")) {
+                        // make sure our value is normalized by a driver
+                        value = this.connection.driver.preparePersistentValue(value, column);
+                    }
                     // newly inserted entities always have a version equal to 1 (first version)
-                    if (column.isVersion) {
-                        expression_1 += "1";
+                    // also, user-specified version must be empty
+                    if (column.isVersion && value === undefined) {
+                        expression += "1";
                         // } else if (column.isNestedSetLeft) {
                         //     const tableName = this.connection.driver.escape(column.entityMetadata.tablePath);
                         //     const rightColumnName = this.connection.driver.escape(column.entityMetadata.nestedSetRightColumn!.databaseName);
@@ -379,9 +482,8 @@ var InsertQueryBuilder = /** @class */ (function (_super) {
                         //     expression += subQuery;
                     }
                     else if (column.isDiscriminator) {
-                        _this.expressionMap.nativeParameters["discriminator_value_" + parametersCount_1] = _this.expressionMap.mainAlias.metadata.discriminatorValue;
-                        expression_1 += _this.connection.driver.createParameter("discriminator_value_" + parametersCount_1, parametersCount_1);
-                        parametersCount_1++;
+                        expression += this.createParameter(this.expressionMap.mainAlias.metadata
+                            .discriminatorValue);
                         // return "1";
                         // for create and update dates we insert current date
                         // no, we don't do it because this constant is already in "default" value of the column
@@ -390,140 +492,200 @@ var InsertQueryBuilder = /** @class */ (function (_super) {
                         //     return "CURRENT_TIMESTAMP";
                         // if column is generated uuid and database does not support its generation and custom generated value was not provided by a user - we generate a new uuid value for insertion
                     }
-                    else if (column.isGenerated && column.generationStrategy === "uuid" && !_this.connection.driver.isUUIDGenerationSupported() && value === undefined) {
-                        var paramName_1 = "uuid_" + column.databaseName + valueSetIndex;
-                        value = RandomGenerator_1.RandomGenerator.uuid4();
-                        _this.expressionMap.nativeParameters[paramName_1] = value;
-                        expression_1 += _this.connection.driver.createParameter(paramName_1, parametersCount_1);
-                        parametersCount_1++;
+                    else if (column.isGenerated &&
+                        column.generationStrategy === "uuid" &&
+                        !this.connection.driver.isUUIDGenerationSupported() &&
+                        value === undefined) {
+                        value = (0, uuid_1.v4)();
+                        expression += this.createParameter(value);
+                        if (!(valueSetIndex in
+                            this.expressionMap.locallyGenerated)) {
+                            this.expressionMap.locallyGenerated[valueSetIndex] =
+                                {};
+                        }
+                        column.setEntityValue(this.expressionMap.locallyGenerated[valueSetIndex], value);
                         // if value for this column was not provided then insert default value
                     }
                     else if (value === undefined) {
-                        if (_this.connection.driver instanceof AbstractSqliteDriver_1.AbstractSqliteDriver) { // unfortunately sqlite does not support DEFAULT expression in INSERT queries
-                            if (column.default !== undefined) { // try to use default defined in the column
-                                expression_1 += _this.connection.driver.normalizeDefault(column);
+                        if ((this.connection.driver.options.type === "oracle" &&
+                            valueSets.length > 1) ||
+                            DriverUtils_1.DriverUtils.isSQLiteFamily(this.connection.driver) ||
+                            this.connection.driver.options.type === "sap") {
+                            // unfortunately sqlite does not support DEFAULT expression in INSERT queries
+                            if (column.default !== undefined &&
+                                column.default !== null) {
+                                // try to use default defined in the column
+                                expression +=
+                                    this.connection.driver.normalizeDefault(column);
                             }
                             else {
-                                expression_1 += "NULL"; // otherwise simply use NULL and pray if column is nullable
+                                expression += "NULL"; // otherwise simply use NULL and pray if column is nullable
                             }
                         }
                         else {
-                            expression_1 += "DEFAULT";
+                            expression += "DEFAULT";
                         }
                         // support for SQL expressions in queries
                     }
-                    else if (value instanceof Function) {
-                        expression_1 += value();
+                    else if (typeof value === "function") {
+                        expression += value();
                         // just any other regular value
                     }
                     else {
-                        if (_this.connection.driver instanceof SqlServerDriver_1.SqlServerDriver)
-                            value = _this.connection.driver.parametrizeValue(column, value);
+                        if (this.connection.driver.options.type === "mssql")
+                            value = this.connection.driver.parametrizeValue(column, value);
                         // we need to store array values in a special class to make sure parameter replacement will work correctly
                         // if (value instanceof Array)
                         //     value = new ArrayParameter(value);
-                        _this.expressionMap.nativeParameters[paramName] = value;
-                        if ((_this.connection.driver instanceof MysqlDriver_1.MysqlDriver || _this.connection.driver instanceof AuroraDataApiDriver_1.AuroraDataApiDriver) && _this.connection.driver.spatialTypes.indexOf(column.type) !== -1) {
-                            var useLegacy = _this.connection.driver.options.legacySpatialSupport;
-                            var geomFromText = useLegacy ? "GeomFromText" : "ST_GeomFromText";
+                        const paramName = this.createParameter(value);
+                        if ((DriverUtils_1.DriverUtils.isMySQLFamily(this.connection.driver) ||
+                            this.connection.driver.options.type ===
+                                "aurora-mysql") &&
+                            this.connection.driver.spatialTypes.indexOf(column.type) !== -1) {
+                            const useLegacy = this.connection.driver.options.legacySpatialSupport;
+                            const geomFromText = useLegacy
+                                ? "GeomFromText"
+                                : "ST_GeomFromText";
                             if (column.srid != null) {
-                                expression_1 += geomFromText + "(" + _this.connection.driver.createParameter(paramName, parametersCount_1) + ", " + column.srid + ")";
+                                expression += `${geomFromText}(${paramName}, ${column.srid})`;
                             }
                             else {
-                                expression_1 += geomFromText + "(" + _this.connection.driver.createParameter(paramName, parametersCount_1) + ")";
+                                expression += `${geomFromText}(${paramName})`;
                             }
                         }
-                        else if (_this.connection.driver instanceof PostgresDriver_1.PostgresDriver && _this.connection.driver.spatialTypes.indexOf(column.type) !== -1) {
+                        else if (this.connection.driver.options.type ===
+                            "postgres" &&
+                            this.connection.driver.spatialTypes.indexOf(column.type) !== -1) {
                             if (column.srid != null) {
-                                expression_1 += "ST_SetSRID(ST_GeomFromGeoJSON(" + _this.connection.driver.createParameter(paramName, parametersCount_1) + "), " + column.srid + ")::" + column.type;
+                                expression += `ST_SetSRID(ST_GeomFromGeoJSON(${paramName}), ${column.srid})::${column.type}`;
                             }
                             else {
-                                expression_1 += "ST_GeomFromGeoJSON(" + _this.connection.driver.createParameter(paramName, parametersCount_1) + ")::" + column.type;
+                                expression += `ST_GeomFromGeoJSON(${paramName})::${column.type}`;
                             }
                         }
+                        else if (this.connection.driver.options.type === "mssql" &&
+                            this.connection.driver.spatialTypes.indexOf(column.type) !== -1) {
+                            expression +=
+                                column.type +
+                                    "::STGeomFromText(" +
+                                    paramName +
+                                    ", " +
+                                    (column.srid || "0") +
+                                    ")";
+                        }
                         else {
-                            expression_1 += _this.connection.driver.createParameter(paramName, parametersCount_1);
+                            expression += paramName;
                         }
-                        parametersCount_1++;
                     }
                     if (columnIndex === columns.length - 1) {
                         if (valueSetIndex === valueSets.length - 1) {
-                            expression_1 += ")";
+                            if (this.connection.driver.options.type ===
+                                "oracle" &&
+                                valueSets.length > 1) {
+                                expression += " FROM DUAL ";
+                            }
+                            else if (this.connection.driver.options.type === "sap" &&
+                                valueSets.length > 1) {
+                                expression += " FROM dummy ";
+                            }
+                            else {
+                                expression += ")";
+                            }
                         }
                         else {
-                            expression_1 += "), ";
+                            if (this.connection.driver.options.type ===
+                                "oracle" &&
+                                valueSets.length > 1) {
+                                expression += " FROM DUAL UNION ALL ";
+                            }
+                            else if (this.connection.driver.options.type === "sap" &&
+                                valueSets.length > 1) {
+                                expression += " FROM dummy UNION ALL ";
+                            }
+                            else {
+                                expression += "), ";
+                            }
                         }
                     }
                     else {
-                        expression_1 += ", ";
+                        expression += ", ";
                     }
                 });
             });
-            if (expression_1 === "()")
+            if (expression === "()")
                 return "";
-            return expression_1;
+            return expression;
         }
-        else { // for tables without metadata
+        else {
+            // for tables without metadata
             // get values needs to be inserted
-            var expression_2 = "";
-            var parametersCount_2 = Object.keys(this.expressionMap.nativeParameters).length;
-            valueSets.forEach(function (valueSet, insertionIndex) {
-                var columns = Object.keys(valueSet);
-                columns.forEach(function (columnName, columnIndex) {
+            let expression = "";
+            valueSets.forEach((valueSet, insertionIndex) => {
+                const columns = Object.keys(valueSet);
+                columns.forEach((columnName, columnIndex) => {
                     if (columnIndex === 0) {
-                        expression_2 += "(";
+                        expression += "(";
                     }
-                    var paramName = "i" + insertionIndex + "_" + columnName;
-                    var value = valueSet[columnName];
+                    const value = valueSet[columnName];
                     // support for SQL expressions in queries
-                    if (value instanceof Function) {
-                        expression_2 += value();
+                    if (typeof value === "function") {
+                        expression += value();
                         // if value for this column was not provided then insert default value
                     }
                     else if (value === undefined) {
-                        if (_this.connection.driver instanceof AbstractSqliteDriver_1.AbstractSqliteDriver) {
-                            expression_2 += "NULL";
+                        if (DriverUtils_1.DriverUtils.isSQLiteFamily(this.connection.driver) ||
+                            this.connection.driver.options.type === "sap") {
+                            expression += "NULL";
                         }
                         else {
-                            expression_2 += "DEFAULT";
+                            expression += "DEFAULT";
                         }
                         // just any other regular value
                     }
                     else {
-                        _this.expressionMap.nativeParameters[paramName] = value;
-                        expression_2 += _this.connection.driver.createParameter(paramName, parametersCount_2);
-                        parametersCount_2++;
+                        expression += this.createParameter(value);
                     }
                     if (columnIndex === Object.keys(valueSet).length - 1) {
                         if (insertionIndex === valueSets.length - 1) {
-                            expression_2 += ")";
+                            expression += ")";
                         }
                         else {
-                            expression_2 += "), ";
+                            expression += "), ";
                         }
                     }
                     else {
-                        expression_2 += ", ";
+                        expression += ", ";
                     }
                 });
             });
-            if (expression_2 === "()")
+            if (expression === "()")
                 return "";
-            return expression_2;
+            return expression;
         }
-    };
+    }
     /**
      * Gets array of values need to be inserted into the target table.
      */
-    InsertQueryBuilder.prototype.getValueSets = function () {
-        if (this.expressionMap.valuesSet instanceof Array && this.expressionMap.valuesSet.length > 0)
+    getValueSets() {
+        if (Array.isArray(this.expressionMap.valuesSet))
             return this.expressionMap.valuesSet;
-        if (this.expressionMap.valuesSet instanceof Object)
+        if (ObjectUtils_1.ObjectUtils.isObject(this.expressionMap.valuesSet))
             return [this.expressionMap.valuesSet];
         throw new InsertValuesMissingError_1.InsertValuesMissingError();
-    };
-    return InsertQueryBuilder;
-}(QueryBuilder_1.QueryBuilder));
+    }
+    /**
+     * Checks if column is an auto-generated primary key, but the current insertion specifies a value for it.
+     *
+     * @param column
+     */
+    isOverridingAutoIncrementBehavior(column) {
+        return (column.isPrimary &&
+            column.isGenerated &&
+            column.generationStrategy === "increment" &&
+            this.getValueSets().some((valueSet) => column.getEntityValue(valueSet) !== undefined &&
+                column.getEntityValue(valueSet) !== null));
+    }
+}
 exports.InsertQueryBuilder = InsertQueryBuilder;
 
 //# sourceMappingURL=InsertQueryBuilder.js.map