助手
扣子 AI 帮助与支持
你好,我是 扣子 文档问答助手 🎉 你在阅读当前文档的过程中,无论对文档概念的解释,还是文档内容方面的疑问,都可以随时向我提问,我会全力为你解答
推荐问题
如何快速了解这个空间的核心内容?
有哪些近期更新的重点文档?
我应该从哪些文档开始阅读?
文档反馈
低代码项目
快速开始
智能体
应用
资源
发布
模型
多人协作
开发工具
推广与变现

查询数据节点

更新于: 2026-06-24 15:44:40

低代码工作流中的查询数据节点用于在指定的数据库中查询数据,对应 SQL 中的 SELECT 操作。

节点说明

在低代码工作流中,你可以添加查询数据节点,以图形化方式配置数据库内数据的查询操作。此节点中需要指定待操作的数据库表,如果你有更精细化的查询需求,可以添加查询字段、查询条件、排序方式和查询上限等配置。整个过程无需编写 SQL 语句,操作简单直观。
相比 SQL 自定义节点,查询数据节点中的操作极大降低了操作门槛,对于不熟悉 SQL 的用户,也能高效、轻松地操作数据库。

注意

  • 开发调试阶段不会改动数据库原表,在调试区查看到的是测试数据,和数据库中的真实数据是隔离的。
  • 在低代码工作流中调试查询数据节点时,不能使用库数据表中的真实数据,需要先插入测试数据后再进行查询操作的测试。

配置数据节点

数据表

在数据表区域,你需要根据页面提示添加需要操作的数据表。每个查询数据节点仅支持操作一张数据表。
在调试期间,查询数据节点显示和使用的是数据表的测试数据,而非数据库中的真实线上数据。单击数据表或单击查看数据,弹出数据表的详情页,可查看此数据表的测试数据。

说明

如需在工作流中实现数据库多用户模式,需在创建数据表时,先选择多用户模式。更多信息,请参考数据库

Image

查询字段

查询字段区域,系统会根据你所选数据表的结构,罗列出该表所包含的所有字段。你可以根据业务需求,从中选择想要查询的目标字段,支持添加多个查询字段。如果不指定查询字段,系统将返回表中的所有字段。

查询条件

查询条件区域,你可以设置对应的筛选条件,以此来指定待查询数据的范围。

  • 支持等于(=)、不等于(!= 或 <>)、模糊匹配(LIKE)、模糊不匹配(NOT LIKE)、包含(IN)、不包含(NOT IN)、为空(IS NULL)、不为空(IS NOT NULL)等运算符。
    模糊查询时,后端会自动在字符串前后添加通配符 %,例如 %值%,无需手动配置通配符。
  • 支持添加多个条件,多个条件之间的逻辑关系可设置为且、或关系。

排序方式

排序方式区域,你可以设置查询结果的排序方式。系统会根据查询字段的数据类型提供对应的排序选项,详细说明如下:

  • 如果查询字段是字符串类型,支持按照 A→Z 或 Z→A 进行排序。
  • 如果查询字段是数值类型,支持按照 0→9 或 9→0 进行排序。
  • 如果查询字段是时间类型,支持按照 0→9 或 9→0 进行排序。
  • 如果查询字段是布尔类型,支持按照 0→1 或者 1→0 进行排序。
    其中,0 代表 false,1 代表 true。

如果添加了多个查询字段,你还可以拖动字段来调整字段排序的优先级。

查询上限

查询上限用于限制返回结果行数,相当于 SQL 语句中的 LIMIT 限制,默认值为 100,最大可设置为 1000。

输出

查询数据节点中的输出参数是执行数据查询操作后的输出内容。

  • outputList:执行数据查询操作后数据表中的字段和数据,Array 类型。你可以按需新增子项,注意变量名需与定义的字段名一致、数据类型需要和数据表中定义的数据类型一致。
  • rowNum:固定为 null。
  • errorBody:节点执行失败时的详细信息,包括 errorMessage 和 errorCode。
  • isSuccess:节点执行状态,true 表示执行成功,false 表示执行失败。
  • 其中isSuccesserrorBody 仅在节点的异常处理方式设置为返回设定内容执行异常流程时返回,用于节点执行异常时传递详细信息。

    异常处理

    默认情况下,节点运行超时、运行异常时,工作流会中断,工作流调试界面或 API 中会返回错误信息。你也可以手动设置节点运行超时等异常情况下的处理方式,例如超时时间、是否重试、是否跳转异常分支等。

    异常处理设置

    说明

    超时时间

    超时时间指节点运行的最大耗时,如果超过此时长,则判断为节点运行超时。
    默认情况下,节点的超时时间默认为 60s,即 1 分钟。你也可以将其改为 0.1s~60s,灵活控制超时时间。

    重试次数

    节点运行超时或异常时,默认不重试,你也可以设置为重试 1 次。

    异常处理方式

    节点运行超时或异常时,默认中断工作流。你也可以手动修改此节点的异常处理方式:

    • 中断流程:工作流执行中断,不再运行后续节点。
    • 返回设定内容:发生异常后,工作流运行不会中断。开发者可自定义设置需要返回的输出字段内容,必须是输出中已定义的字段,且格式为合法的 JSON 格式。另外,节点还会返回输出参数 isSuccesserrorBody,传递节点异常的详细信息。
    • 执行异常流程:发生异常后,工作流运行不会中断,转而执行异常流程分析,开发者需要为新增的异常分支配置处理流程。异常信息会通过节点的输出参数 isSuccesserrorBody 返回。

    Image

    示例

    例如使用查询数据节点,在用户信息表 userinfo 中查询 companyname 字段值为 co 的数据,并返回对应的 usernametel 字段值。查询结果按照 username 字段值进行 A 到 Z 字母序升序排序。
    Image

    常见问题

    为什么工作流试运行时能获取扣子数据库数据,但在 API Playground 中无法获取正确结果?

    工作流的试运行环境和 API Playground 的数据源是隔离的。工作流试运行时访问的是测试数据,而调用 API 时访问的是线上数据。若需验证 API 渠道数据,需通过 API 重新添加线上数据后再进行测试。