cube.js dimensions 的一些说明
部分参数
- show
控制维度的可见性
dimensions: {
comment: {
type: `string`,
sql: `comments`,
shown: false
}
}
- case
进行case 的支持
cube("caseapp",{
sql: `select * from demoapp`,
measures:{
type_count:{
sql:`type`,
type:`count`
},
name_count:{
sql:`name`,
type:`count`
}
},
dimensions:{
type:{
sql:`type`,
type:`string`
},
myversioninfo: {
type: `string`,
case: {
when: [
{ sql: `${CUBE}.type = 'v1'`, label: `old` },
{ sql: `${CUBE}.type = 'v2'`, label: `not old` },
{ sql: `${CUBE}.type = 'v4'`, label: `new` }
],
else: { label: `Unknown` }
}
},
name:{
sql:`name`,
type:`string`
},
id:{
sql:`id`,
type:`number`,
primaryKey:true
}
}
})
参考生成的sql
SELECT
"caseapp".type "caseapp__type",
CASE
WHEN "caseapp".type = 'v1' THEN 'old'
WHEN "caseapp".type = 'v2' THEN 'not old'
WHEN "caseapp".type = 'v4' THEN 'new'
ELSE 'Unknown'
END "caseapp__myversioninfo",
count("caseapp".type) "caseapp__type_count"
FROM
demoapp AS "caseapp"
GROUP BY
1,
2
ORDER BY
3 DESC
LIMIT
10000
- primaryKey
主键配置,在进行joins 处理的时候很重要
dimensions: {
id: {
sql: `id`,
type: `number`,
primaryKey: true
}
}
- subQuery
可以方便的引用measure 在dimensions中 - propagateFiltersToSubQuery
可以过滤条件应用到子查询中
dimensions: {
usersCount: {
sql: `${Users.count}`,
type: `number`,
subQuery: true,
propagateFiltersToSubQuery: true
}
}
说明
subQuery 还是比较强大的,但是也有一些问题,比如目前能使用subQuery 的都必须是定义好的measure
同时不支持复杂的处理
cube(`Deals`, {
sql: `select * from deals`,
measures: {
amount: {
sql: `amount`,
type: `sum`
}
}
});
cube(`SalesManagers`, {
// ...
dimensions: {
// ...
dealsAmount: {
sql: `sum(${Deals}.amount)`, // !!! Doesn't work!
type: `number`,
subQuery: true
}
}
});
同时subQuery定义的维度也可以在measures中引用
同时subQuery实现是基于join的(join 使用left join)所以需要配置主键,不然会有错误提示
同一个cube 中subQuery定义的维度不能引用measures(这个是目前的一个约定,可能后期会变动)
说明
cube.js 目前的官方文档,好多地方还不是很清晰(有一些隐藏点,目前还好看到有专门的人员在进行更新)