Sails.js 的 `.fetch()` 查询方法:让 Waterline 回传增删改记录的完整指南

发布时间:2026/11/16 8:58:37

Sails.js 的 `.fetch()` 查询方法:让 Waterline 回传增删改记录的完整指南 Sails.js 的.fetch()查询方法让 Waterline 回传增删改记录的完整指南【免费下载链接】sailsRealtime MVC Framework for Node.js项目地址: https://gitcode.com/gh_mirrors/sa/sails.fetch()是 Sails.js 内置 ORMWaterline中一个短小但极为实用的查询实例query instance方法。执行.create()、.createEach()、.update()或.destroy()这类写操作时默认情况下数据库不会回传受影响的记录链式调用.fetch()即可让 Waterline 与底层数据库适配器把这些记录原样返回。读完本文你将掌握.fetch()的用法、返回类型差异、与.meta({fetch: true})的关系以及在大批量写操作下如何规避性能陷阱。为什么需要.fetch()写操作的默认沉默行为在 Sails 应用中查询实例query instance是模型方法返回的可链式延迟对象Deferred例如Zookeeper.find()返回的对象在await之前并不会真正执行详见 Queries 文档。对于读操作.find()等执行后自然能拿到记录但对于写操作情况不同执行.update()、.create()、.createEach()或.destroy()时默认不会返回任何数据如果使用回调风格.exec()则回调的第二个参数将是undefined。这一设计是为了性能写操作默认只关心是否成功数据库无需把受影响的记录序列化回传。当你确实需要拿到刚刚写入/更新/删除的那条些记录时才需要链式调用.fetch()显式要求 Waterline 和底层数据库适配器把结果送回来。这一默认行为在框架源码中也有直接印证。在 lib/hooks/blueprints/actions/create.js 中blueprint 的 create action 执行完Model.create(data).meta(queryOptions.meta).exec(...)后会检查// If we didnt fetch the new instance, just return OK. if (!newInstance) { return res.ok(); }也就是说未启用 fetch 时即便通过 REST 接口调用 blueprint create响应也只是状态 OK而不携带新记录数据。基本用法零参数一行链式调用.fetch().fetch()不接受任何参数。它必须链式接在写操作模型方法返回的查询实例之后并且需要在查询真正执行await、.exec()、.then()或.toPromise()之前调用。典型示例创建后立即取回新记录原文档给出的经典示例是在.create()之后链式调用.fetch()从而立刻拿到带主键id的新记录var newUser await User.create({ fullName: Alice McBailey }).fetch(); sails.log(Hi, ${newUser.fullName}! Your id is ${newUser.id}.);执行await后newUser即为数据库中实际写入的那条记录包含自动生成的主键、默认值、生命周期回调写入的字段等。没有.fetch()的话newUser将是undefined。各写操作方法的返回类型与差异.fetch()在不同写操作方法上的返回形态不同理解这一点可以避免解包时的低级错误模型方法默认返回链式.fetch()后的返回.create()无单个记录((dictionary))即新建的那条记录.createEach()无记录数组((array))包含所有新建记录.update()无记录数组((array))包含所有被更新的记录.destroy()无记录数组((array))包含所有被删除的记录以 .create() 文档 中的 Result 表格说明为例为了优化性能创建出的记录默认不作为结果返回只有链式调用.fetch()后新记录才会被回传——并且要注意在部分适配器中这需要额外执行一次数据库查询。.update()与.destroy()的文档也做了同样说明。批量更新后取回所有受影响记录var updatedUsers await User.update({name:Finn}) .set({ name:Jake }) .fetch(); sails.log(Updated all ${updatedUsers.length} user${updatedUsers.length1?:s} named Finn to have the name Jake. Here they are now:); sails.log(updatedUsers);注意.update()的返回始终是数组——即使只有一条记录被更新。同时需注意update查询不支持skip/limit分页与select投影。删除后取回被销毁的记录var burnedBooks await Book.destroy({ controversiality: { : 0.9 } }).fetch(); sails.log(Deleted books:, burnedBooks);同样.destroy()返回被删除记录的数组。另请留意 .destroy() 文档 中的安全提示如果 criteria 传入空字典{}将销毁表中所有记录。新记录的主键是.fetch()最常见的用途.create()后拿不到主键是新手最常见的困惑之一。由于主键通常由数据库自动生成自增 id 或 uuid没有.fetch()就无法在后续逻辑中引用新记录。这也是.fetch()在 Sails 应用中出现频率最高的场景。底层原理.fetch()就是.meta({fetch: true})的快捷方式原文档明确给出了关键结论.fetch()只是.meta({fetch: true})的语法糖shortcut。.meta() 文档 的 Supported options 表格完整列出了fetch这一 meta 键OptionTypeDefaultDetailsfetch((boolean))false在执行.update()、.create()、.createEach()或.destroy()查询时设为true可让数据库适配器回传所有被更新/删除的记录否则.exec()回调的第二个参数为undefined。警告对影响大量记录的 update/destroy 查询启用该键可能引发性能问题。因此下面两种写法完全等价var newUser await User.create({ name: alice }).fetch(); // 等价写法 var newUser2 await User.create({ name: alice }).meta({ fetch: true });meta 键还有第三种设置途径在显式回调之后传入字典例如User.create({ name: alice }, function(err, newUser){/* ... */}, { fetch: true });从框架源码看fetch键贯穿了整个 blueprint 层。例如 lib/hooks/blueprints/parse-blueprint-options.js 在为 create action 组装查询选项时直接设置了queryOptions.meta { fetch: true }同一文件 L344-L345 对 update action 也做了同样处理。这说明REST 蓝图接口默认就能回传新建/更新后的记录随后还会在 create.js 中通过findOne做一次 populate 再返回。.fetch()与生命周期回调lifecycle callbacks的联动fetch键不仅影响返回值还影响模型生命周期回调的执行。在 lib/hooks/blueprints/actions/destroy.js 的源码注释中明确写道...well also include the meta query options for the purpose of enabling theafterDestroylifecycle callback (which only runs if.meta({fetch: true})is included).也就是说blueprint destroy action 之所以在findOne与destroy上都透传queryOptions.meta正是为了让afterDestroy这类生命周期回调在fetch: true时得以触发。由此可以推断当你需要依赖写操作后的生命周期回调如afterCreate、afterUpdate、afterDestroy时带上.fetch()或meta: {fetch: true}是必要条件之一反之若确认不需要回传数据省略它还能顺带跳过这些回调的额外开销。性能警告大批量写操作慎用.fetch()原文档给出了一条明确的警告Warning: This is not recommended for update/destroy queries that affect large numbers of records.原因在于要求适配器收集并回传每一条受影响记录的完整数据会显著增加数据库与 Node.js 进程之间的数据传输量部分适配器还需要额外发起一次查询见 .create() 文档 中 requires an extra database query in some adapters 的说明。在批量任务例如定时清理、批量状态迁移中这可能会拖慢整次操作。实践建议只需确认是否成功省略.fetch()仅关注是否抛错需要主键或受影响记录使用.fetch()但尽量缩小 criteria 的影响范围大表全量更新/删除考虑分批处理如按id分段避免单次查询影响海量记录追求性能且数据库支持把级联删除等需求下推到物理层如 MySQL/PostgreSQL 的 CASCADE 约束而不是依赖 ORM 层逐条处理详见 .meta() 文档 中关于cascade键的说明。错误处理与执行方式.fetch()本身不引入新的错误类型它与普通查询一样错误取决于所执行的模型方法与底层适配器UsageError、AdapterError、Error等详见各模型方法文档中的 Errors 小节。查询既可以用await执行推荐代码更简洁、更安全也可以用.exec()回调或.then()/.catch()链式执行。需要提醒的是.exec()回调风格下.fetch()决定的就是回调第二参数是否为undefined。小结.fetch()是 Waterline 查询实例中用一行代码换回写操作结果的便捷方法适用对象.create()、.createEach()、.update()、.destroy()返回值单个记录或记录数组取决于模型方法本质.meta({fetch: true})的快捷方式默认fetch: false附加价值与afterCreate/afterUpdate/afterDestroy等生命周期回调联动blueprint destroy 源码中有明确印证主要风险影响大量记录的 update/destroy 查询会带来性能开销应谨慎使用。在 fetch.md 原文档 基础上建议进一步阅读 Queries 总览 理解查询实例的 Deferred 机制以及 .meta() 了解cascade、skipAllLifecycleCallbacks、decrypt等更多 meta 键的完整能力。【免费下载链接】sailsRealtime MVC Framework for Node.js项目地址: https://gitcode.com/gh_mirrors/sa/sails创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
延伸阅读

更多相关文章

2026/11/16 8:58:36

金螳螂家装避坑指南:从入门到精通,搞定代码跑不通难题

金螳螂家装避坑指南:从入门到精通,搞定代码跑不通难题 复制来的代码跑不通不知道怎么调,这是很多刚接触工程数字化或想给金螳螂家装做内部效率工具的开发者最崩溃的时刻。你看着屏幕上的报错,心里只有一个念头:这代码到底哪里断了?从入门到精通的路上,…

2026/11/14 17:11:48

尤甚新手避坑:3个底层逻辑讲透项目搭建痛点

尤甚新手避坑:3个底层逻辑讲透项目搭建痛点 学会语法却不知怎么搭项目,这是无数开发者卡在入门到进阶的深坑里。尤甚作为近期技术圈热议的架构思维模型,常被误解为某种特定语言或框架,实则它是一种 以数据流向和状态管理为核心…

2026/11/14 17:00:53

3个高频坑让老东家性能优化面试稳过

3个高频坑让老东家性能优化面试稳过 官方文档里关于 老东家 的章节动辄几百页,翻半天还是记不住重点,尤其是 性能优化 相关的参数调优,更是让人头大。 别慌,咱们不背文档。 今天就把 老东家 在面试中最爱考的几个点,给你拆得明明白白。…

2026/11/16 8:57:35

特种工证件打印机通过率揭秘:外省证怎么转?转岗者如何应对

特种工证件打印机通过率揭秘:外省证怎么转?转岗者如何应对 之前考的证在外省能不能转过来?这是不少特种作业人员在考虑转岗或换地区时最关心的问题。如果你手里有低压电工证、焊工证或高处作业证,但换了一个城市工作,你可能会发现新地方的政策、审核流程…

2026/11/16 8:57:35

昆明有代办电工证的吗通过率揭秘:外省证书如何转过来

昆明有代办电工证的吗通过率揭秘:外省证书如何转过来 之前考的证在外省能不能转过来?这几乎是所有打算在昆明发展、持有电工证的朋友最关心的问题。特别是很多来自其他省份的朋友,带着已经在老家考取的证书来到昆明,却因为 通过率揭秘…

2026/11/16 8:57:35

新手考哪个电工证在哪考最靠谱

新手考哪个电工证在哪考最靠谱 怕考不过白交培训费?新手考哪个电工证,选错地方不仅浪费钱,还耽误时间。尤其是在漯河这样工程类岗位需求多的地区,选对电工证类型和报名渠道,直接影响你后续的就业和职业发展。…

2026/11/16 8:57:35

考电工证要注意哪些网上查询报名门槛和流程全解析

考电工证要注意哪些网上查询报名门槛和流程全解析 学历不高怕报不上名?别慌!考电工证这事其实没你想的那么难,关键是你得知道怎么操作。今天就从 信阳市政公用工程从业者 的角度,带你一步步了解 考电工证要注意哪些 ,怎么通过 网上查询…

2026/11/16 8:52:35

上海惠南电工证复审要赶在2026河南最新政策前完成?这3步教你搞定

上海惠南电工证复审要赶在2026河南最新政策前完成?这3步教你搞定 你现在正被“ 急需特种作业证才能上岗找工作 ”这个问题逼得喘不过气,尤其是像你这样的驻马店转岗从业者,手里握着的电工证要是到期不复审,不仅影响接单,还可能被平台直接封号。而…

2026/11/16 7:29:52

电工证考试口诉怎么准备值不值得考

电工证考试口诉怎么准备值不值得考 实操考试心里没底怕挂科,这是大多数准备考电工证的人心里最真实的感受。尤其是面对【电工证考试口诉】环节,很多人不知道该怎么准备,甚至担心自己说不好就被淘汰。其实,只要掌握方法, 值不值得考…

2026/11/16 5:30:20

桑植县考电工证千万别踩坑!报名全流程教你避坑

桑植县考电工证千万别踩坑!报名全流程教你避坑 你是不是也遇到过这种情况:想考个电工证,但不知道从哪儿下手,怕被中介坑,怕花冤枉钱,更怕考了证还不能用?别急,这正是你该看这篇文章的原因。在桑植县考电工证,确实有很多人被坑过,但只要你知道流程、…

2026/11/16 0:00:11

黎城电工证查询报名费多少钱 内部消息告诉你怎么避开中介陷阱

黎城电工证查询报名费多少钱 内部消息告诉你怎么避开中介陷阱 你是不是也和我一样,想考电工证,但不知道去哪报名,怕被中介坑?最近网上有不少人问“黎城电工证查询报名费多少钱”,结果一查,信息五花八门,真假难辨。别担心,今天我就从一线从业者的角度…

2026/11/16 0:00:11

青岛崂山区电工证培训通过率揭秘:外省证书怎么转过来?

青岛崂山区电工证培训通过率揭秘:外省证书怎么转过来? 之前考的证在外省能不能转过来?这个问题困扰着很多在外地打工的电工,尤其是像南阳卧龙区的建筑工人,他们常年在工地作业,手上持有电工证是基本要求,但很多人因为工作流动性大,担心证书不能转到本…

2026/11/15 4:46:37

面向复杂光照与角度的宠物面部识别鲁棒性增强策略

在智慧养宠时代,基于视觉的宠物身份识别技术正逐步从实验室走向家庭应用。然而,与配合度高的人类不同,宠物是典型的“非合作生物识别对象”——它们不会主动配合摄像头调整姿态,更无法控制光照环境。实际应用中,我们常…

2026/11/16 3:17:47

SSM电子书店源码全解析:结构、原理、部署与排错实战

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

还想了解更多?直接咨询顾问

免费诊断 + 免费方案 + 透明报价。

全国咨询热线400-8866-253
免费获取方案
☎咨询二维码 ☎ ↑