查询数据节点用于在指定的数据库中查询数据，对应 SQL 中的 SELECT 操作。 ## 节点说明 在工作流中，你可以添加**查询数据节点**，以图形化方式配置数据库内数据的查询操作。此节点中需要指定待操作的数据库表，如果你有更精细化的查询需求，可以添加查询字段、查询条件、排序方式和查询上限等配置。整个过程无需编写 SQL 语句，操作简单直观。 相比 [SQL 自定义节点]，查询数据节点中的操作极大降低了操作门槛，对于不熟悉 SQL 的用户，也能高效、轻松地操作数据库。 * 开发调试阶段不会改动数据库原表，在调试区查看到的是测试数据，和数据库中的真实数据是隔离的。 * 在工作流中调试查询数据节点时，不能使用库数据表中的真实数据，需要先插入测试数据后再进行查询操作的测试。 ## 配置数据节点 ### 数据表 在数据表区域，你需要根据页面提示添加需要操作的数据表。每个查询数据节点仅支持操作一张数据表。 在调试期间，查询数据节点显示和使用的是数据表的**测试数据**，而非数据库中的真实线上数据。单击数据表或单击查看数据，弹出数据表的详情页，可查看此数据表的测试数据。  ### 查询字段 在**查询字段**区域，系统会根据你所选数据表的结构，罗列出该表所包含的所有字段。你可以根据业务需求，从中选择想要查询的目标字段，支持添加多个查询字段。如果不指定查询字段，系统将返回表中的所有字段。 ### 查询条件 在**查询条件**区域，你可以设置对应的筛选条件，以此来指定待查询数据的范围。 * 支持等于（=）、不等于（!= 或 <>）、模糊匹配（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：执行数据查询操作后数据表中的字段和数据。你可以按需新增子项，注意变量名需与定义的字段名一致、数据类型需要和数据表中定义的数据类型一致。 * rowNum：固定为 null。 * errorBody：节点执行失败时的详细信息，包括 errorMessage 和 errorCode。 * isSuccess：节点执行状态，true 表示执行成功，false 表示执行失败。 其中isSuccess、errorBody 仅在节点的异常处理方式设置为**返回设定内容**或**执行异常流程**时返回，用于节点执行异常时传递详细信息。 ### 异常处理 默认情况下，节点运行超时、运行异常时，工作流会中断，工作流调试界面或 API 中会返回错误信息。你也可以手动设置节点运行超时等异常情况下的处理方式，例如超时时间、是否重试、是否跳转异常分支等。 | **异常处理设置** | **说明** | | ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 超时时间 | 超时时间指节点运行的最大耗时，如果超过此时长，则判断为节点运行超时。默认情况下，节点的超时时间默认为 60s，即 1 分钟。你也可以将其改为 0.1s\~60s，灵活控制超时时间。 | | 重试次数 | 节点运行超时或异常时，默认不重试，你也可以设置为重试 1 次。 | | 异常处理方式 | 节点运行超时或异常时，默认中断工作流。你也可以手动修改此节点的异常处理方式：* **中断流程**：工作流执行中断，不再运行后续节点。* **返回设定内容**：发生异常后，工作流运行不会中断。开发者可自定义设置需要返回的输出字段内容，必须是输出中已定义的字段，且格式为合法的 JSON 格式。另外，节点还会返回输出参数isSuccess、errorBody，传递节点异常的详细信息。* **执行异常流程**：发生异常后，工作流运行不会中断，转而执行异常流程分析，开发者需要为新增的异常分支配置处理流程。异常信息会通过节点的输出参数isSuccess、errorBody返回。 |  ## 示例 例如使用**查询数据节点**，在用户信息表 userinfo 中查询 companyname 字段值为 co 的数据，并返回对应的 username 和 tel 字段值。查询结果按照 username 字段值进行 A 到 Z 字母序生序排序。