观远 BI

全局参数

创建于 2022-10-27 / 最近更新于 2024-03-06 / 8161
字体: [默认] [大] [更大]

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中,实现动态查询的效果。

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

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

2.4 在抽取数据集中使用参数

数据库抽取数据集、Web Service 抽取数据集及远程文件抽取数据集支持使用全局参数。

  • 数据库类型抽取数据集创建/修改模型结构/配置增量更新时,示例如下图:

image.png

  • Web Service 类型抽取数据集创建/修改模型结构/配置增量更新时,示例如下图:

image.png

  • 远程文件类型抽取数据集配置增量更新时,示例如下图:

image.png

基础用法:与直连数据集使用全局参数的方法一致,创建 Guan-Index 类型数据集后,在更新数据集时,实时查询使用到的全局参数默认值,并将其替换至查询 SQL 中进行数据抽取。

适用更新场景如下:

  • 手动更新;

  • 定时更新;

  • URL 触发更新;

  • 其他触发数据更新的 Public API 。

适用更新方式如下:

  • 覆盖旧数据;

  • 添加新数据。

注意:

若使用 Guan-Index 数据集制作卡片,且仅在模型结构及数据更新定义时使用了参数,该参数不会被传递给卡片,不支持联动参数筛选器进行动态查询。

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

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

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

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

2.7 使用参数进行动态分析

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

当参数筛选器的条件清空时,会取卡片设置的参数默认值。

在数据集处使用全局参数时,以下情况需要传至卡片:

  • 所有数据集的计算字段;

  • 直连数据集、视图数据集、存储过程数据集使用的所有参数。

在数据集处使用全局参数时,以下情况不传至卡片:

  • FTP/SFTP/ADLS Gen2数据集-增量更新;

  • WebService抽取数据集/数据库抽取数据集-模型结构SQL、增量更新SQL、前置清理规则。


3. 全局参数宏使用案例

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


23 人点赞过