編輯頁面
.createEach()
在資料庫中建立一組記錄。
await Something.createEach(initialValues);
或
var createdRecords = await Something.createEach(initialValues).fetch();
用法
| 參數 | 類型 | 詳細資訊 | |
|---|---|---|---|
| 1 | initialValues | 包含新記錄屬性的字典陣列。 |
注意：基於效能考量，從 Sails v1.0 / Waterline 0.13 開始，傳遞到此模型方法的
initialValues陣列中的字典在大多數情況下會直接就地修改（而在 Sails/Waterline v0.12 中，情況不一定如此）。
結果
| 類型 | 描述 |
|---|---|
為了最佳化效能，預設情況下不會提供已建立的記錄作為結果。若要覆寫預設設定，請鏈式調用 .fetch()，新建立的記錄將會回傳。（請注意，這在某些适配器中需要額外的資料庫查詢。） |
錯誤
| 名稱 | 類型 | 何時？ |
|---|---|---|
| UsageError | 如果傳入無效的內容，則會拋出此錯誤。 | |
| AdapterError | 如果資料庫适配器發生錯誤，則會拋出此錯誤。請參閱Concepts > Models and ORM > Errors，以了解如何處理唯一性錯誤的範例（起因於嘗試建立具有重複值的記錄，而這會違反唯一性約束）。 | |
| Error | 如果發生任何其他非預期的情況，則會拋出此錯誤。 |
有關在 Sails 和 Waterline 中處理錯誤的範例，請參閱Concepts > Models and ORM > Errors。
Meta 鍵
| 鍵 | 類型 | 詳細資訊 |
|---|---|---|
| fetch | 如果設定為 true，則會回傳已建立的記錄。預設值為 false。 |
有關 meta 鍵的更多資訊，請參閱.meta()。
範例
在資料庫中建立名為 Finn 和 Jake 的使用者
await User.createEach([{name:'Finn'}, {name: 'Jake'}]);
獲取新建立的記錄
var createdUsers = User.createEach([{name:'Finn'}, {name: 'Jake'}]).fetch();
sails.log(`Created ${createdUsers.length} user${createdUsers.length===1?'':'s'}.`);
註記
- 此方法可以與
await、Promise 鏈式調用或傳統 Node 回呼一起使用。- 您可以使用
.createEach新增的記錄數量受限於您使用的特定資料庫的最大查詢大小。 MySQL 預設的限制為 4MB，但可以透過max_allowed_packet設定來變更。 MongoDB 對於單個文件施加 16MB 的限制，但基本上對於一次可以建立的文件數量沒有限制。 PostgreSQL 具有非常大的（約 1GB）最大大小。 有關查詢限制的更多資訊，請查閱您的資料庫文件。- 在執行非常大量的批量插入時，另一個需要注意的事項是綁定變數的最大數量。 這因資料庫而異，但指的是查詢中被替換的值的數量。 有關更多詳細資訊，請參閱最大允許參數數量。
- 當使用
.fetch()並手動為新記錄指定主鍵值時，不保證回傳記錄的排序順序（它會根據使用的資料庫适配器而有所不同）。
為了在 sailsjs.com 上獲得更好的體驗，更新您的瀏覽器。
參考
- 應用程式
- 藍圖 API
- 命令列介面
-
配置
- sails.config.*
- sails.config.blueprints
- sails.config.bootstrap()
- sails.config.custom
- sails.config.datastores
- sails.config.globals
- sails.config.http
- sails.config.i18n
- sails.config.log
- sails.config.models
- sails.config.policies
- sails.config.routes
- sails.config.security
- sails.config.session
- sails.config.sockets
- sails.config.views
-
Request (`req`)
- req._startTime
- req.body
- req.cookies
- req.fresh
- req.headers
- req.hostname
- req.ip
- req.ips
- req.isSocket
- req.method
- req.options
- req.originalUrl
- req.params
- req.path
- req.protocol
- req.query
- req.secure
- req.signedCookies
- req.socket
- req.subdomains
- req.url
- req.wantsJSON
- req.xhr
- req.accepts()
- req.acceptsCharsets()
- req.acceptsLanguages()
- req.allParams()
- req.file()
- req.get()
- req.is()
- req.param()
- req.setLocale()
- req.setTimeout()
- req.host
- Response (`res`)
- Waterline (ORM)
- WebSockets
參考
以愛打造
Sails 框架是由奧斯汀，德克薩斯州的一家網路和行動商店，在我們的貢獻者的幫助下建立的。 我們在 2012 年創建 Sails，以協助我們進行 Node.js 專案。 自然地，我們將其開源。 我們希望它可以讓您的生活更輕鬆一點！
© 2012-2024 The Sails Company.
Sails 框架是免費且開源的，基於 MIT 許可證。
插圖由 Edamame 提供。