> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coze.cn/llms.txt
> Use this file to discover all available pages before exploring further.

低代码工作流中的更新数据节点用于更新指定的数据库中数据，对应 SQL 中的 UPDATE 操作。
## 节点说明 {#648a50a6}
在低代码工作流中，你可以添加**更新数据节点**，以图形化方式配置数据库内数据的更新操作。此节点中需要指定待操作的数据库表、更新条件、待更新的字段名称及字段值，每次执行此节点时将更新所有符合条件的数据。整个过程无需编写 SQL 语句，操作简单直观。
相比 [SQL 自定义节点](/guides/database_sql_node)，更新数据节点中的操作极大降低了操作门槛，对于不熟悉 SQL 的用户，也能高效、轻松地操作数据库。
:::notice 注意
* 开发调试阶段不会改动数据库原表，在调试区查看到的是测试数据，和数据库中的真实数据是隔离的。
* 在低代码工作流中调试查询数据节点时，不能使用库数据表中的真实数据，需要先插入测试数据后再进行更新操作的测试。
:::
## 配置更新数据节点 {#f4e7c64b}
### 数据表 {#1f2257e2}
在**数据表**区域，你需要根据页面提示添加待更新数据的数据表。每个更新数据节点仅支持操作一张数据表。
在调试期间，更新数据节点中显示和使用的是数据表的**测试数据**，而非数据库中的真实线上数据。单击数据表或单击查看数据，弹出数据表的详情页，可查看此数据表的测试数据。
:::tip 说明
如需在工作流中实现数据库多用户模式，需在创建数据表时，先选择多用户模式。更多信息，请参考[数据库](/guides/database)。
:::
![Image=629x209](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/293c1c649a5b4c7d836e765e36a3e062~tplv-goo7wpa0wc-image.image)
### 更新条件 {#5159c6b0}
在**更新条件**区域，你可以设置对应的筛选条件，以此来指定待更新数据的范围。

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

### 选择并设置字段 {#f4ccb985}
在**选择并设置字段**区域，系统会根据你所选数据表的结构，罗列出该表所包含的所有字段。你可以根据业务需求，选择待更新的字段，为其更新字段值。支持设置为固定值，或引用上游节点的输出参数。
### 输出 {#9bc77d14}
更新数据节点中的输出参数是执行数据更新操作后的输出内容。

* outputList：废弃字段，无需关注。
* rowNum：更新的数据行数。
* errorBody：节点执行失败时的详细信息，包括 errorMessage 和 errorCode。
* isSuccess：节点执行状态，true 表示执行成功，false 表示执行失败。

其中`isSuccess`、`errorBody` 仅在节点的异常处理方式设置为**返回设定内容**或**执行异常流程**时返回，用于节点执行异常时传递详细信息。
### 异常处理 {#607c766e}
默认情况下，节点运行超时、运行异常时，工作流会中断，工作流调试界面或 API 中会返回错误信息。你也可以手动设置节点运行超时等异常情况下的处理方式，例如超时时间、是否重试、是否跳转异常分支等。
<!-- @cols-width: 188,664 -->
| | | \
|**异常处理设置** |**说明** |
|---|---|
| | | \
|超时时间 |超时时间指节点运行的最大耗时，如果超过此时长，则判断为节点运行超时。 |\
| |默认情况下，节点的超时时间默认为 60s，即 1 分钟。你也可以将其改为 0.1s~60s，灵活控制超时时间。 |
| | | \
|重试次数 |节点运行超时或异常时，默认不重试，你也可以设置为重试 1 次。 |
| | | \
|异常处理方式 |节点运行超时或异常时，默认中断工作流。你也可以手动修改此节点的异常处理方式： |\
| | |\
| |* **中断流程**：工作流执行中断，不再运行后续节点。 |\
| |* **返回设定内容**：发生异常后，工作流运行不会中断。开发者可自定义设置需要返回的输出字段内容，必须是输出中已定义的字段，且格式为合法的 JSON 格式。另外，节点还会返回输出参数 `isSuccess`、`errorBody`，传递节点异常的详细信息。 |\
| |* **执行异常流程**：发生异常后，工作流运行不会中断，转而执行异常流程分析，开发者需要为新增的异常分支配置处理流程。异常信息会通过节点的输出参数 `isSuccess`、`errorBody` 返回。 |

![Image=307x280](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/29a3611502344180aed9eaf50fe9e2a7~tplv-goo7wpa0wc-image.image)


## 示例 {#c26df1a3}
例如使用**更新数据节点**，在用户信息表 `userinfo` 中更新用户电话信息，即查询 `username` 字段等于 `xiaoming` 的数据，并将其对应的 `tel` 字段值更新为新值。
![Image=445x385](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/ed253f5643ef43719e36ea850920dd33~tplv-goo7wpa0wc-image.image)