@@ -5,7 +5,7 @@ As there are often use cases in which it is just easier to execute raw / already
...
@@ -5,7 +5,7 @@ As there are often use cases in which it is just easier to execute raw / already
By default the function will return two arguments - a results array, and an object containing metadata (affected rows etc.). Note that since this is a raw query, the metadata (property names etc.) is dialect specific. Some dialects return the metadata "within" the results object (as properties on an array). However, two arguments will always be returned, but for MSSQL and MySQL it will be two references to the same object.
By default the function will return two arguments - a results array, and an object containing metadata (affected rows etc.). Note that since this is a raw query, the metadata (property names etc.) is dialect specific. Some dialects return the metadata "within" the results object (as properties on an array). However, two arguments will always be returned, but for MSSQL and MySQL it will be two references to the same object.
```js
```js
sequelize.query("UPDATE users SET y = 42 WHERE x = 12").spread((results,metadata)=>{
sequelize.query("UPDATE users SET y = 42 WHERE x = 12").then(([results,metadata])=>{
// Results will be an empty array and metadata will contain the number of affected rows.
// Results will be an empty array and metadata will contain the number of affected rows.
When invoking several scopes, keys from subsequent scopes will overwrite previous ones (similar to [_.assign](https://lodash.com/docs#assign)). Consider two scopes:
When invoking several scopes, keys from subsequent scopes will overwrite previous ones (similar to [Object.assign](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/assign). Consider two scopes:
* Find a row that matches the query, or build (but don't save) the row if none is found.
* Find a row that matches the query, or build (but don't save) the row if none is found.
* The successful result of the promise will be (instance, built) - Make sure to use .spread()
* The successful result of the promise will be (instance, built)
*
*
* @param {Object} options find options
* @param {Object} options find options
* @param {Object} options.where A hash of search attributes.
* @param {Object} options.where A hash of search attributes.
...
@@ -2224,7 +2225,7 @@ class Model {
...
@@ -2224,7 +2225,7 @@ class Model {
/**
/**
* Find a row that matches the query, or build and save the row if none is found
* Find a row that matches the query, or build and save the row if none is found
* The successful result of the promise will be (instance, created) - Make sure to use .spread()
* The successful result of the promise will be (instance, created)
*
*
* If no transaction is passed in the `options` object, a new transaction will be created internally, to prevent the race condition where a matching row is created by another connection after the find but before the insert call.
* If no transaction is passed in the `options` object, a new transaction will be created internally, to prevent the race condition where a matching row is created by another connection after the find but before the insert call.
* However, it is not always possible to handle this case in SQLite, specifically if one transaction inserts and another tries to select before the first one has committed. In this case, an instance of sequelize. TimeoutError will be thrown instead.
* However, it is not always possible to handle this case in SQLite, specifically if one transaction inserts and another tries to select before the first one has committed. In this case, an instance of sequelize. TimeoutError will be thrown instead.
* Execute a query on the DB, with the possibility to bypass all the sequelize goodness.
* Execute a query on the DB, with the possibility to bypass all the sequelize goodness.
*
*
* By default, the function will return two arguments: an array of results, and a metadata object, containing number of affected rows etc. Use `.spread` to access the results.
* By default, the function will return two arguments: an array of results, and a metadata object, containing number of affected rows etc.
*
*
* If you are running a type of query where you don't need the metadata, for example a `SELECT` query, you can pass in a query type to make sequelize format the results:
* If you are running a type of query where you don't need the metadata, for example a `SELECT` query, you can pass in a query type to make sequelize format the results:
