运行查询

UiPath.Database.Activities.ExecuteQuery

描述

对数据库执行查询，并返回 DataTable 形式的查询结果。

项目兼容性

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变量。
  备注：

  The amount of time specified in this field does not include the response time for the query result retrieval. This means that the total execution time of the activity may be greater than the actual query execution time, to which the TimeoutMS property applies.

连接配置

• 连接字符串 - 用于建立数据库连接的连接字符串。此字段仅支持 String 变量。
• 现有连接- 从“连接”或“启动事务”活动获得且已打开的数据库连接。如果提供了此连接，则忽略ConnectionString和SecureConnectionString属性。此字段仅支持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”级别记录变量和参数的值。

输出

• “数据表” - 包含在DataTable变量中的 SQL 命令输出。
  备注：

  当您查询包含Date数据类型列的表格时，输出DataTable中的相应列将属于DateTime数据类型。

跨平台配置

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

高级选项

其他

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

输出

• “数据表” - 包含在DataTable变量中的 SQL 命令输出。