运行命令

UiPath.Database.Activities.ExecuteNonQuery

描述

对数据库执行 SQL 语句。 对于UPDATE 、 INSERT和DELETE语句，返回值为该命令影响的行数。 对于所有其他类型的语句，返回值均为 -1。

项目兼容性

Windows - 旧版 | Windows | 跨平台

Windows - 旧版 Windows 配置

设计器面板

• 配置连接... - 选择现有数据库连接或使用连接向导添加新连接。
• SQL 命令 - 要执行的 SQL 命令。必须根据“命令类型”属性中的选择填写该字段。此字段仅支持 String 变量。

属性面板

常见

• “出错时继续” - 指定在活动引发错误时是否应继续自动化操作。 此字段仅支持 Boolean 值（True、 False）。 默认值为 False。 因此，如果该字段为空且活动引发错误，系统将停止执行项目。 如果该值设置为 True，则无论出现何种错误，系统都将继续执行项目。
  注意：如果Try Catch 异常处理中包含该活动且出错时继续属性的值为 True，则系统在执行项目时不会捕获任何错误。
• “显示名称”- 活动的显示名称。 此字段仅支持 String 变量。
• “超时”- 指定等待时间 (以毫秒为单位)，如果超出该时间后 SQL 命令并未运行，就会引发错误。 默认值为 30000 毫秒（30 秒），且必须大于或等于 0。此字段仅支持Int32变量。
  注意： 此字段中指定的时间不包括查询结果检索的响应时间。 这意味着活动的总执行时间可能大于 TimeoutMS 属性适用的实际查询执行时间。

连接配置

• “连接字符串”- 用于建立数据库连接的连接字符串。 此字段仅支持String变量。
• 现有连接 - 已打开的数据库连接。如果提供了此连接，则系统将忽略“连接字符串”和“安全连接字符串”属性。此字段仅支持 DatabaseConnection 变量。
• “提供程序名称” - 用于访问数据库的数据库提供程序的名称。 此字段仅支持String变量。
• “安全连接字符串”- 用于以安全字符串形式建立数据库连接的连接字符串。 此字段仅支持SecureString变量。

输入

• 参数 - 绑定到 SQL 命令的命名参数字典。可通过在 SQL 命令中指定 @parameterName 语句来完成绑定。在运行时，“参数名称”将替换为其在字典中的对应值。
• SQL 命令 - 要执行的 SQL 命令。必须根据“命令类型”属性中的选择填写该字段。此字段仅支持 String 变量。

其他

• “命令类型” - 指定命令字符串的解释方式。 可用的选项如下：

  • “文本” - 执行 SQL 参数中指定的查询。
  • “存储 过程” - 调用 SQL 参数中指定的过程名称。
  • “表格直接” - 调用表格中的所有记录。
• “私有”- 选中后将不再以“Verbose”级别记录变量和参数的值。

输出

• 受影响的行数 - SQL 命令的执行结果。对于 UPDATE、INSERT 和 DELETE 语句，返回值为该命令影响的行数。对于所有其他类型的语句，返回值均为 -1。此字段仅支持 Int32 变量。

跨平台配置

• 现有连接- 从“连接到数据库”活动获得的已打开的数据库连接。
• “命令类型” - 指定命令字符串的解释方式。 可用的选项如下：
  • “文本” - 执行 SQL 命令。
  • 存储过程- 调用 SQL 命令中指定的过程名称。
  • 直接从表格调用 - 调用表格中的所有记录。
• SQL 命令 - 要执行的 SQL 命令。必须根据“命令类型”属性中的选择填写该属性。

高级选项

其他

• 参数 - 绑定到 SQL 命令的命名参数字典。可通过在 SQL 命令中指定 @parameterName 语句来完成绑定。在运行时，“参数名称”将替换为其在字典中的对应值。
• “超时”- 指定等待时间（以毫秒为单位），如果超出该时间活动未执行完任务，就会引发错误。 默认值为 30000 毫秒 (30 秒)。 超时值必须大于或等于 0。
• 出错时继续 - 指定在活动抛出错误时是否应继续自动化操作。

输出

• 受影响的行计数- SQL 命令的执行结果。