工作流/数据库节点/查询数据节点
查询数据节点
更新于: 2026-06-24 15:44:40
低代码工作流中的查询数据节点用于在指定的数据库中查询数据,对应 SQL 中的 SELECT 操作。
在低代码工作流中,你可以添加查询数据节点,以图形化方式配置数据库内数据的查询操作。此节点中需要指定待操作的数据库表,如果你有更精细化的查询需求,可以添加查询字段、查询条件、排序方式和查询上限等配置。整个过程无需编写 SQL 语句,操作简单直观。
相比 SQL 自定义节点,查询数据节点中的操作极大降低了操作门槛,对于不熟悉 SQL 的用户,也能高效、轻松地操作数据库。
注意
在数据表区域,你需要根据页面提示添加需要操作的数据表。每个查询数据节点仅支持操作一张数据表。
在调试期间,查询数据节点显示和使用的是数据表的测试数据,而非数据库中的真实线上数据。单击数据表或单击查看数据,弹出数据表的详情页,可查看此数据表的测试数据。
说明
如需在工作流中实现数据库多用户模式,需在创建数据表时,先选择多用户模式。更多信息,请参考数据库。
在查询字段区域,系统会根据你所选数据表的结构,罗列出该表所包含的所有字段。你可以根据业务需求,从中选择想要查询的目标字段,支持添加多个查询字段。如果不指定查询字段,系统将返回表中的所有字段。
在查询条件区域,你可以设置对应的筛选条件,以此来指定待查询数据的范围。
%,例如 %值%,无需手动配置通配符。在排序方式区域,你可以设置查询结果的排序方式。系统会根据查询字段的数据类型提供对应的排序选项,详细说明如下:
如果添加了多个查询字段,你还可以拖动字段来调整字段排序的优先级。
查询上限用于限制返回结果行数,相当于 SQL 语句中的 LIMIT 限制,默认值为 100,最大可设置为 1000。
查询数据节点中的输出参数是执行数据查询操作后的输出内容。
其中isSuccess、errorBody 仅在节点的异常处理方式设置为返回设定内容或执行异常流程时返回,用于节点执行异常时传递详细信息。
默认情况下,节点运行超时、运行异常时,工作流会中断,工作流调试界面或 API 中会返回错误信息。你也可以手动设置节点运行超时等异常情况下的处理方式,例如超时时间、是否重试、是否跳转异常分支等。
|
异常处理设置 |
说明 |
|---|---|
|
超时时间 |
超时时间指节点运行的最大耗时,如果超过此时长,则判断为节点运行超时。 |
|
重试次数 |
节点运行超时或异常时,默认不重试,你也可以设置为重试 1 次。 |
|
异常处理方式 |
节点运行超时或异常时,默认中断工作流。你也可以手动修改此节点的异常处理方式:
|
例如使用查询数据节点,在用户信息表 userinfo 中查询 companyname 字段值为 co 的数据,并返回对应的 username 和 tel 字段值。查询结果按照 username 字段值进行 A 到 Z 字母序升序排序。
工作流的试运行环境和 API Playground 的数据源是隔离的。工作流试运行时访问的是测试数据,而调用 API 时访问的是线上数据。若需验证 API 渠道数据,需通过 API 重新添加线上数据后再进行测试。