[]
查询参数是数据集动态查询的核心机制，通过接收用户输入、用户上下文参数、组织上下文参数或常量参数，实时过滤数据并返回匹配结果，查询参数既支持单值参数也支持多值参数，能够灵活满足不同场景需求，为交互式分析、行/列级权限控制及查询性
Wyn 系统中，数据集参数类型支持下面几种：
参数类型 | 缓存数据集 | 直连数据集 |
|---|---|---|
用户输入 | -不支持使用 | 支持： -自定义查询语句 -SQL 表达式 -计算字段 -过滤器 |
用户上下文 | -仅限数据集过滤器使用 | 支持： -自定义查询语句 -SQL 表达式 -计算字段 -过滤器 |
组织上下文 | -仅限数据集过滤器使用 | 支持： -自定义查询语句 -SQL 表达式 -计算字段 -过滤器 |
常量 | -自定义查询语句 -数据集过滤器 | 支持： -自定义查询语句 -SQL 表达式 -计算字段 -过滤器 |
界面状态： 已进入缓存/直连数据集的数据准备界面。
步骤一：进入参数设置界面
数据准备界面，单击数据集准备区域的参数按钮，进入参数准备界面。
步骤二：添加并配置参数
参数准备界面，单击添加参数。
设置参数信息。
参数设置项说明如下：
名称： 查询参数的名称。默认为Parameter1、2、3...，单击可以进行修改。建议使用业务语义化命名方便解读。
参数类型： 可选择用户输入、用户信息上下文 、组织信息上下文 或常量。用户输入型参数仅限在直连数据集使用。有关用户/组织信息上下文以及常量参数的用法示例，请参考行级数据管理。
数据集类型 | 参数类型 |
|---|---|
缓存数据集 |
|
直连数据集 |
|
数据类型： 根据实际需求进行选择，支持数字、字符串、日期时间、日期、布尔和全局唯一标识符等类型。如果查询参数用于过滤器中，数据类型需要与过滤器中字段的数据类型需保持一致。
多值： 仅当参数类型为“用户输入”时，才可勾选多值选项并设置多个默认值（用法与单值相同），但需注意过滤条件必须使用“在”。
上下文字段： 当参数类型为 用户信息上下文 ”或“ 组织信息上下文 ”时，用于选择用户或组织的属性信息。
默认值： 当参数类型为“ 用户输入 ”或“ 常量 ”时，用于设置参数的默认值。
查询参数除了参考上面的操作步骤添加，还可以在需要使用查询参数时再快速添加，这里以自定义表为例。例如，如果在写 SQL 语句时需要用到查询参数，而没有提前在数据集设计器中定义好参数。那么，您也可以直接在当前对话框中添加查询参数。您可通过以下详细步骤完成配置。
步骤一：进入自定义表编写界面
数据准备界面，选择数据源/数据集，单击数据源和数据集列表区域的添加自定义表，进入自定义表设置界面。
步骤二：编写SQL语句/存储过程，引用参数
进入自定义表设置界面，先自定义数据集名称（默认名称customSqlTable），选择Sql语句，编写Sql语句并进行参数引用，参数引用使用@参数名。Sql语句中使用未添加的参数时系统会出现报错提示“Sql语句中包含未定义的参数: @p。请单击参数按钮生成参数，并配置属性”。根据提示单击右下角的参数按钮快速生成参数即可。
参数引用后，单击自定义表设置界面右下角的参数按钮，进入参数设置界面。
根据实际需求对参数进行配置，配置完成后，单击右下角的确定按钮，回到自定义表设置界面，可以继续创建。
如果sql语句编写成功，错误提示将字段取消，单击确定按钮即可保存自定义表。
查看自定义表。
直连数据集参数优化
性能提示： 对于直连数据集，建议通过自定义表集成查询参数实现数据过滤（相比数据过滤器，可显著提升查询效率）。
实现方式： 在SQL语句中直接嵌入参数（例如：Where area= @area）
参数测试验证
预览说明： 数据集预览时需手动输入测试参数值，该设计旨在：
1）验证参数化查询的正确性。
2）模拟终端用户可能输入的各类边界值。
3）确保数据过滤逻辑符合预期。
