1. 内容概述
使用查询参数可以帮助我们在数据集中实现各种数据过滤,系统中支持四种参数类型:用户输入型参数、用户上下文参数、组织上下文参数和常量参数。
2. 参数使用范围
用户输入型参数
仪表板数据集中:不允许使用。
报表数据集中:可以被用于自定义表的查询语句、SQL表达式、计算字段、过滤器。
用户上下文参数 / 组织上下文参数 / 常量参数
仪表板数据集中:仅允许在数据集过滤器中使用。
报表数据集中:可以被用于自定义表的查询语句、SQL表达式、计算字段、过滤器。
3. 设置查询参数
选择“参数”,单击“添加参数”,添加即可查询参数。
![](/download/attachments/71017190/image2020-10-16_15-20-34.png?version=1&modificationDate=1647594873000&api=v2)
查询参数设置项目介绍如下:
名称: 新添加的查询参数名称。默认为Parameter1、2、3...,单击可以进行修改。
参数类型:可选择“用户输入”、“用户信息上下文”、“组织信息上下文”或“常量”。仪表板数据集中不能使用“用户输入”型参数。有关用户/组织信息上下文以及常量参数的用法示例,请参考行级数据管理。
![](/download/attachments/71017190/image2020-4-23_11-34-40.png?version=1&modificationDate=1647594873000&api=v2)
数据类型:根据实际应用进行选择,支持数字、字符串、日期时间、日期、布尔和全局唯一标识符等类型。如果查询参数用于过滤器中,数据类型需要与过滤器中字段的数据类型需保持一致。
多值: 详见多值参数。
上下文字段: 当参数类型为“用户信息上下文”或“组织信息上下文”时,用于选择用户或组织的属性信息。
默认值:当参数类型为“用户输入”或“常量”时,用于设置参数的默认值。
4. 在使用场景中添加查询参数
您也可以在需要使用查询参数时再进行添加,这里以自定义表为例。
如果在写SQL语句时需要用到查询参数,而没有提前在数据集设计器中定义好参数。那么,您也可以直接在当前对话框中添加查询参数。
方法是:直接在SQL语句中照常引用参数,然后单击右下角的“参数” 按钮,即可将该参数添加。
![](/download/attachments/71017190/image2020-8-24_17-39-51.png?version=1&modificationDate=1647594873000&api=v2)
接下来会弹出参数设置界面,根据需要对参数进行设置即可。
设置完毕以后,单击右下角的“关闭”按钮,回到自定义表界面继续创建自定义表。
![](/download/attachments/71017190/image2020-8-24_17-56-25.png?version=1&modificationDate=1647594873000&api=v2)
5. 查询参数使用提示与建议
- 如果数据集为报表数据集,建议您设计自定义表并使用带查询参数进行数据查询,而非在数据集过滤器上使用查询参数。此举能够提升运算效率。
- 在数据集中添加查询参数后预览时需要您手动填写虚构的参数值,这是为了方便您测试有可能被浏览者输入的参数值是否能够在数据集内正常工作。
- 查询参数可以定义一次被多次使用。例如同时在自定义表、计算字段和过滤器中使用。