运行命令

UiPath.Database.Activities.ExecuteNonQuery

描述

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

注意：数据库活动包现在与 .NET 6 Windows 兼容。

项目兼容性

Windows - 旧版 | Windows | 跨平台

跨平台配置

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

高级选项

其他

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

输出

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

Windows、Windows - 旧版配置

属性面板

常见

• “出错时继续”- 指定在活动引发错误时是否应继续自动化操作。该字段仅支持“布尔值”(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变量。