跳到主要内容
版本:5.9.0

全局参数

1. 全局参数概述

全局参数,是指观远数据在数据融合与数据分析的多个环节,如在卡片、数据集计算字段、视图数据集、直连数据集的SQL中,均可灵活使用参数。通过参数的使用,您可以实现复杂的图表动态分析,如切换分析维度、切换分析指标、数据动态分类、跨表动态查询等。

2. 全局参数使用介绍

2.1 创建参数

可以在“管理员设置>资源设置>全局参数”中,设置用户需要用到的全局参数。点击右上角“新增参数”按钮,配置新增参数。

每个参数必须包含参数名称、参数类型、默认值,您可以选择添加一些描述信息来辅助管理参数。如果是文本类型的参数,您还可以设置自定义文本,或是从预定义的下拉列表中选择。

2.2 在卡片计算字段中使用参数

参数创建完成后,便可以在卡片计算字段中使用参数。下图展示了如何通过计算字段中使用参数实现卡片分析维度的切换。其中,计算字段的表达式为:

case when [DYNAMIC_PARAMS.维度钻取示例]="城市" then [城市] else [门店] end

当然,您也可以通过在数值字段中使用参数,来实现分析指标的切换:

case [DYNAMIC_PARAMS.显示指标] when '销量' then [Quantity] when '销售额' then [Sales] when '利润' then [Profit] end

在数值字段中使用参数,还可以实现动态分类计算。例如我们要计算高单价商品的销量,而判断是否为高单价商品的阈值为外部输入参数,则可以定义以下计算字段 [高单价商品销量]:if([Price]>[DYNAMIC_PARAMS.数值参数],[Sales],0)

2.3 在直连数据集中使用参数

在从数据库接入数据的方式中,可以在创建数据集时(也称直连数据集),在SQL中使用参数。点击“添加参数”按钮,便可以使用参数来实现数据分析维度的切换。

例如,我们使用以下SQL创建数据集,通过在卡片或页面上传入日期参数,来实现指定时间区间内的客户订单信息的动态分析。

select * from order_items where customer_id in (select customer_id from customers where create_date >= [DYNAMIC_PARAMS.日期参数] )

2.4 在视图数据集中使用参数

创建视图数据集的时候,在SQL中使用参数:

2.5 存储过程数据集中使用参数

创建存储过程数据集时,可使用参数。

2.6 使用参数进行动态分析

当页面中有卡片使用了参数(不管是来自计算字段还是数据集),可通过新建筛选器卡片来打开参数展示窗口。打开后便能在页面上调整参数值来对相应卡片进行动态分析。全局参数通过筛选器对卡片数据生效时,只能过滤数据行。

3. 全局参数宏使用案例

关于全局参数的具体使用案例,建议前往《全局参数最佳实践》了解。