执行单SQL查询

一、功能说明

用于在目标数据库中执行一条指定的SQL语句，进行数据查询、插入、更新或删除操作。需要结合【连接数据库】组件一起使用。

注：针对SQL server数据库类型，SQL语句中的字符串类型的参数，建议尽量使用英文单引号格式。

二、属性说明

基础属性

● 目标数据库对象：输入数据库对象的变量名称，如前面【连接数据库】组件中打开的数据库。

● SQL语句：输入需要执行的SQL语句。例如，查询students表中的name字段第一条数据，MySQL语句示例为："select name from `students`"

● sql语句参数：输入的参数值。若SQL语句包含变量，则需填写对应的参数；否则，不需要填写。

● 是否显示字典：选择是，则在返回值中显示key值；选择否，不显示key值。

● 输出到变量：将组件运行结果输出并保存到指定变量，用于在流程中定义和存储数据，以便在后续步骤中动态获取和使用这些信息。

高级属性

● 执行前延时（秒）：流程开始执行预设任务前，特意设置的一段等待时间，目的是预留缓冲（如等待前置条件就绪、避免操作冲突）。

● 执行后延时（秒）：指流程完成指令动作后，出现预期外的时间延迟，比如机器人完成抓取后延时。

● 超时时间（秒）：执行某个流程时，等待响应所能容忍的最大时间限制。

异常处理

● 异常重试：当流程运行过程中发生异常时，可根据实际需求配置是否启用重试逻辑。

● 异常处理：处理方式分为终止流程和继续流程。

• 终止流程：彻底停止当前正在进行的步骤或任务，后续相关操作不再执行。
• 继续流程：暂停或中断后，恢复当前步骤或任务，按原有逻辑或调整后继续进行。

三、使用示例

执行逻辑

 1. 添加【连接数据库】组件到可视化编辑区，进行数据库的连接参数配置。

 2. 连接成功后，继续添加【执行单SQL查询】组件，在右侧或双击组件后的属性框中，配置该组件各参数。

 例如：在表名为students的表中，模糊查询包含“张”的第一条数据。

则输入以下信息：

select name from students where name LIKE @name

['张%']

输出结果 

属性设置完成，运行组件；运行成功后，打印返回值内容，输出运行结果。

当选择显示字典时，结果输出为：{'name': '张飞'}

当选择不显示字典时，结果输出为：['张飞']