1. 计算列

已有的数据中缺少分析所需的数据，需要对数据进行二次加工；

例如：用户想要判断当前的合同金额属于「大订单」还是「小订单」，但是现在的数据中并没有该类型的字段。

例如：当前模型中的字段名称不符合业务使用诉求，想修改成其他的名字进行展示。

业务集市的「计算字段」提供了添加计算列的功能，实现对已存在的字段再计算的能力，从而可以得到新的字段，可以方便实现目标字段。支持添加维度计算列和指标计算列。

例如：用户使用计算列增加一个新的维度字段，当「合同金额」大于1000000 时是大订单。

1.1.1. 支持类型

以下来源的业务模型支持新建计算列的能力，支持范围如下：

  • 指标分析
  • 事件分析
    • 标准聚合模式
    • 结果表模式
  • session分析
    • 标准聚合模式
    • 结果表模式
  • 漏斗分析-结果表模式
  • 留存分析-结果表模式
  • session分析-结果表模式
  • 自定义查询
  • 数据表

1.1.2. 添加入口

1.1.2.1. 业务模型计算列入口

业务模型计算列的添加入口如下图所示：

  • 业务模型详情页展示「计算字段」入口；
  • 此功能受「管理权限」控制，需要有当前模型的协同管理权限，才支持使用此功能。

1.1.2.2. 图表计算列入口

业务模型计算列的添加入口如下图所示，整体制作可视化组件请参考：制作可视化组件

1.1.3. 管理计算列

进入计算列的页面后，可对当前的计算列进行管理：

  1. 搜索：支持对计算列的名称进行搜索，快速定位目标的计算列；
  2. 新建：支持新建，每个模型有新建的个数限制，如有需要，可联系运维调整个数限制；
  3. 计算列名称：当前计算列的名称，每个模型中的计算列不可重复
  4. 类型：该计算列的类型
  5. 操作-编辑：进入该计算列的编辑界面，修改该字段的名称、函数、语句等
    操作-删除：删除此字段

1.1.4. 编辑计算列

进入计算列的编辑界面，界面介绍如下：

  1. 编辑/修改计算列名称；
  2. 快捷添加常用的运算符；
  3. 公式输入区；
  4. 计算列支持的函数；
  5. 该模型中的基础字段与计算列；
  6. 函数或字段解释区，支持解析当前语句是否正确，并展示语句错误原因。

1.1.5. 函数组成

函数计算列由4个部分组成：


内容说明
1函数用于对字段中的值或内容进行转换的语句
2字段 用户数据表中的维度或指标
3运算符指明运算的符号
4文本表达式按照写入内容表示的常量值


例如，假设有以下计算列：IF(合同金额>2000,"大订单","小订单")；对应计算列内容如下所示：


内容说明
1函数IF
2字段

合同金额

3运算符>
4文本表达式
  • 字符串文本："大订单"、"小订单"
  • 数字文本：2000


1.1.6. 函数格式与支持清单

函数在使用的过程中需要满足目标格式，例如下图：

区域1 是函数名称，区域2是参数数据类型，隐含返回的数据类型，主要函数说明如下：

函数分类函数名称语法说明（界面名称语法备注区域）示例参数数据类型返回数据类型
聚合函数SUM

sum(number）
返回表达式中所有值的总和

示例：
sum([sales])

numbernumber
聚合函数AVG

avg(number）
返回表达式中所有值的平均值

示例:
avg([sales])

numbernumber
聚合函数COUNT

count(exp）
返回表达式中所有值的计数

示例:
count([id])

number；

string；

datetime；

(bool)

number
聚合函数DISTINCT COUNT

distinctcount(exp）
返回表达式中所有值的去重计数


示例:
distinctcount([userid])

number；

string；

datetime；

(bool)

number
聚合函数MAX

max(exp）
返回表达式中所有值的最大值


示例:
max([sales])

numbernumber
聚合函数MIN

min(exp）
返回表达式中所有值的最小值


示例:
min([sales])

numbernumber
逻辑函数CASE

case <expr> when <value1> then <return1> when <value2> then <return2> ... [else <else>] end
执行逻辑测试并返回相应的值。case 函数可评估 expr，并将其与一系列值（value1、 value2 等）比较，然后返回结果。

case when <condition1> then <return1> when <condition2> then <return2> ... [else <else>] end：执行逻辑测试并返回相应的值。case 函数根据 condition 执行为 true，返回结果。 

示例：

case when [City]="上海" then [City] else null end

 

根据exp而定根据exp而定
逻辑函数WHEN

case <expr> when <value1> then <return1> when <value2> then <return2> ... [else <else>] end
执行逻辑测试并返回相应的值。case 函数可评估 expr，并将其与一系列值（value1、 value2 等）比较，然后返回结果。

case when <condition1> then <return1> when <condition2> then <return2> ... [else <else>] end：执行逻辑测试并返回相应的值。case 函数根据 condition 执行为 true，返回结果。

示例：

case when [City]="上海" then [City] else null end

 

根据exp而定根据exp而定
逻辑函数THEN

case <expr> when <value1> then <return1> when <value2> then <return2> ... [else <else>] end
执行逻辑测试并返回相应的值。case 函数可评估 expr，并将其与一系列值（value1、 value2 等）比较，然后返回结果。

case when <condition1> then <return1> when <condition2> then <return2> ... [else <else>] end：执行逻辑测试并返回相应的值。case 函数根据 condition 执行为 true，返回结果。

示例：

case when [City]="上海" then [City] else null end

 

根据exp而定根据exp而定
逻辑函数ELSE

case <expr> when <value1> then <return1> when <value2> then <return2> ... [else <else>] end
执行逻辑测试并返回相应的值。case 函数可评估 expr，并将其与一系列值（value1、 value2 等）比较，然后返回结果。

case when <condition1> then <return1> when <condition2> then <return2> ... [else <else>] end：执行逻辑测试并返回相应的值。case 函数根据 condition 执行为 true，返回结果。


示例：

case when [City]="上海" then [City] else null end

 

根据exp而定根据exp而定
逻辑函数OR

case when <expr1> or <expr2> then <then1> [else <else>] end
对两个表达式执行或者的条件判断。


示例：

case when ([Sales] < 0 or [Sales] = 0) then "没有盈利"
else "盈利良好" end

 

根据exp而定根据exp而定
逻辑函数AND

case when <expr1> and <expr2> then <then1> [else <else>] end
对两个表达式执行并且的条件判断。


示例：

case when(['Profit'] >100 and ['Profit'] <500） then "一般盈利"
else "盈利未知"
end

 

根据exp而定根据exp而定
逻辑函数IIF

iif(condition, true,false)
检查某个条件是否得到满足，如果为 true 则返回一个值，如果为 false 则返回另一个值。

示例：
iif (sales>6,1,0)，如果此列销售额的值大于6就返回1，否则返回0

bool，exp1，exp2

number

string

datetime

(bool)

逻辑函数IFNULL

ifnull(exp1, exp2)
如果 <expr1> 不为 null，则返回该表达式expr1，否则返回 <expr2>。

示例：
ifnull([Profit], 0)

根据exp而定

exp1或exp2

其他mod

mod(number1,number2)
用于计算 x 与 y 相除的余数

示例:
MOD(number1, number2)

number

number

其他floor

FLOOR(number)
向下取整数

示例:
FLOOR(3.1415926)=3

number

number

其他ceil

ceil（number）

向上取整数

示例:
CEIL(10.1)=11

number

number

其他coalesce

coalesce(expression1, expression2, expressionN)
获取多个表达式中的第一个非 NULL 值，输入参数类型与函数输出类型仅支持 number，string，date，且所有输入参数类型需保持一致

示例:
COALESCE(column1, column2) 

根据exp而定

根据exp而定

其他round

round(double a, int d)

round(double a, int d) 返回指定精度 d 的 double 类型，维度最大保留 d 位，数值最大保留 4 位

示例：

round(6.66667,4)=6.6667, round(6.123)=6.0

number

number

日期date_sub

date_sub(date/date startdate, int/bigint days)
减少指定天数

示例:
执行时间北京时间：2023-02-04 08:46:27；days_sub(now(), 1)=2023-02-03 08:46:27

date

date

日期date_add

DATE_ADD(date/date startdate, int/bigint days)
增加指定天数

示例:
执行时间北京时间：2023-02-04 08:46:27；days_add(now(), 1)=2023-02-05 08:46:27

date

date

日期minutes_add

MINUTES_ADD(date date, int/bigint minutes)
增加指定分钟

示例:
执行时间北京时间：2023-02-04 08:46:27；minutes_add(now(),1)=2023-02-04 08:47:27

date

date

日期minutes_sub

MINUTES_SUB(date date, int/bigint minutes)
减少指定分钟

示例:
执行时间北京时间：2023-02-04 08:46:27；minutes_sub(now(),1)=2023-02-04 08:45:27

date

date

日期hours_add

HOURS_ADD(date date, int/bigint hours)
增加指定小时

示例:
执行时间北京时间：2023-02-04 08:46:27；hours_add(now(),1)=2023-02-04 09:46:27

date

date

日期hours_sub

HOURS_SUB(date date, int/bigint hours)
减少指定小时

示例:
执行时间北京时间：2023-02-04 08:46:27；hours_sub(now(),1)=2023-02-04 07:46:27

date

date

日期weeks_add

WEEKS_ADD(date date, int/bigint hours)
增加指定周数

示例:
执行时间北京时间：2023-02-04 08:46:27；weeks_add(now(), 1)=2023-02-11 08:46:27

date

date

日期weeks_sub

WEEKS_SUB(date date, int/bigint hours)
减少指定周数

示例:
执行时间北京时间：2023-02-04 08:46:27；weeks_sub(now(), 1)=2023-01-28 08:46:27

date

date

日期years_add

YEARS_ADD
增加指定年数

示例:
执行时间北京时间：2023-02-04 08:46:27；years_add(now(),1)=2024-02-04 08:46:27

date

date

日期years_sub

YEARS_SUB
增加指定年数

示例:
执行时间北京时间：2023-02-04 08:46:27；years_sub(now(),1)=2022-02-04 08:46:27

date

date

1.1.7. 使用计算列

完成计算列的创建后，可在详情页界面预览使用，如下图所示：

  • 指标类型的计算列在指标「展示项」中设置；
  • 维度/分组类型的计算列在维度/分组的「展示项」中设置；
  • 确认勾选后，在右侧数据展示区即可预览目标计算列。