cube.js join 的处理

支持join 模式

• 参考格式

joins: {

  TargetCubeName: {

    relationship: `belongsTo` || `hasMany` || `hasOne`,

    sql: `SQL ON clause`

  }

}

• 说明
  注意所有的join 使用的默认是left join ，对于INNER JOIN 语义的支持可以基于检查对应的列是否不为空，可以通过set filter 解决
  参考

 

{

  member: "Posts.authorName",

  operator: "set"

}

参数说明

注意定义join 的relationship必须明确，不然可能会产生不一样的结果

• relationship
  hasOne
  一对一的关联

 

cube("Users", {

  joins: {

    Profile: {

      relationship: `hasOne`,

      sql: `${Users}.id = ${Profile}.user_id`

    }

  }

});

hasMany
定义一对多的场景，比如一个作者有多本书

 

cube("Authors", {

  joins: {

    Books: {

      relationship: `hasMany`,

      sql: `${Authors}.id = ${Books}.author_id`

    }

  }

});

belongsTo
定义多对一的场景，比如一个客户有多个订单,对于order 与客户的关联就是订单属于客户

 

cube("Orders", {

  joins: {

    Customers: {

      relationship: `belongsTo`,

      sql: `${Orders}.customer_id = ${Customers}.id`

    }

  }

});

• sql
  定义关联的条件

 

sql: `${Orders}.customer_id = ${Customers}.id`

设置主键

为了join 的正确处理，很多时候设置正确的主键也很必要，注意主键是在维度定义的

dimensions: {

  authorId: {

    sql: `id`,

    type: `number`,

    primaryKey: true

  }

}

cube 的引用

使用${CUBE} 可以引用当前的cube schema 定义,在处理join 的时候很有必要

dimensions: {

  name: {

    sql: `${CUBE}.name`,

    type: `string`

  }

}

传递join

cube.js 基于Dijkstra's algorithm 算法可以解决a-b,b-c 然后a-c 的关联问题
比如：

 

cube(`A`, {

  // ...

  joins: {

    B: {

      sql: `${A}.b_id = ${B}.id`,

      relationship: `belongsTo`

    }

  },

​

  measures: {

    count: {

      type: `count`

    }

  }

});

​

cube(`B`, {

  // ...

  joins: {

    C: {

      sql: `${B}.c_id = ${C}.id`,

      relationship: `belongsTo`

    }

  }

});

​

cube(`C`, {

  // ...

​

  dimensions: {

    category: {

      sql: `category`,

      type: `string`

    }

  }

}); 

我们可以使用

{

  measures: ['A.count'],

  dimensions: ['C.category']

}

参考资料

https://cube.dev/docs/joins
https://cube.dev/docs/direction-of-joins/