创建SQL Query¶

在“数据请求”的“SQL Query”节点上单击鼠标右键，选择“新增”，可以创建SQL Query。

alt text

注意：SQL Query 在使用过程中，是通过 名称引用 的，因此重命名时需对所有引用该SQL Query的地方进行更新。

基础属性¶

alt text

名称	描述
名称	SQL Query的名称，必须唯一。
描述	SQL Query的描述。
数据库连接	下拉框中显示处于“已连接”状态的数据库连接，从中选择其一。在进行数据库连接验证时，只针对当前所选的数据库进行连接验证，不验证其备数据库。
查询类型	查询类型包括 Query, Scalar Query，Update Query。具体参见 SQL Query。当选择 Scalar Query 时，可以设置回退值。当查询出错时，返回回退值。

SQL语句¶

alt text

名称

描述

SQL编辑器

在编辑器中编写SQL Query语句。根据在“基础信息”中所选的数据库，使用对应的SQL语句。

参数

点击参数列表最右侧的 + 按钮，添加参数。它们充当占位符，在执行查询时，您可以为其传递具体的值。
每个参数包含如下3个属性：
- 名称：参数的名称。在SQL Query语句中，可以使用参数作为占位符，之后只需修改参数的值，即可使SQL语句按照不同的条件进行执行。
- 数据类型：参数的数据类型。
- 测试值：在进行结果测试的时候，使用该值作为参数的值，进行查询测试。
说明：在SQL语句中，在参数前面会加上 @ 符号，参数只能用于where语句中。
注意：当数据类型为 DateTime 时，测试值会提供 UTC 选项，该选项仅适用于 PostgreSQL 数据库。

结果¶

编写完SQL Query后，无需将其绑定到控件上，可以直接在当前页面进行查询测试。

点击测试按钮，执行查询操作。

alt text

名称	描述
最多显示	启用后，允许您设置在测试SQL Query时查询将返回的最大行数。仅当查询类型设置为 Query 时，才可以启用此属性。
测试	测试SQLQuery是否正常执行，并将查询结果显示在结果区域内。
导出	将SQL Query查询结果导出到CSV文件。导出的内容为结果中显示的内容。