运行命令

UiPath.Database.Activities.ExecuteNonQuery

描述

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

项目兼容性

Windows - 旧版 | Windows | 跨平台

Windows - 旧版 Windows 配置

设计器面板

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

属性面板

常见

• “出错时继续” - 指定在活动抛出错误时是否应继续自动化操作。此字段仅支持Boolean值（ True ， False ）。默认值为False 。因此，如果该字段为空且活动引发错误，系统将停止执行项目。如果该值设为True ，则无论出现何种错误，系统都将继续执行项目。
  备注：

  如果“Try Catch 异常处理”中包含该活动且“出错时继续”属性的值为“True”，则系统在执行项目时不会捕获任何错误。

• DisplayName - The display name of the activity. This field supports only String variables.
• “超时” - 指定最长等待时间（以毫秒为单位），如果超出该时间后系统并未运行，就会引发错误。默认值为 30000 毫秒（30 秒），且必须大于或等于 0。此字段仅支持Int32变量。
  备注：

  该字段中指定的时长不包含查询结果检索的响应时间。这表示，活动的总执行时间可能要比实际查询执行时间更长，而“超时(毫秒)”属性便适用此情形。

连接配置

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

输入

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

其他

• 命令类型- 指定命令字符串的解释方式。可选择以下选项：
  • Text - Executes the query given in the SQL parameter.
  • StoredProcedure - Invokes the procedure name specified in the SQL parameter.
  • TableDirect - Invokes all records from a table.
• “私有”- 选中后将不再以“Verbose”级别记录变量和参数的值。

输出

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

跨平台配置

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

高级选项

其他

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

输出

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