Apache Kylin 2.3.0 Cube Planner配置及新Cube功能异常咨询

Cube Planner的配置主要依托Kylin核心配置文件kylin.properties来完成，核心步骤和关键参数如下：

• 开启Cube Planner核心开关：这是功能启用的基础，在kylin.properties中添加或修改：

  kylin.cube.cubeplanner.enabled=true
  

• 按需调整采样参数：采样比例直接影响统计数据的精度，可根据自身数据量灵活设置：
  • kylin.cube.cubeplanner.sample-percentage：设置查询的采样比例，默认是10%，数据量较小时可适当调高（比如20%）提升精度：

    kylin.cube.cubeplanner.sample-percentage=20
    

  • kylin.cube.cubeplanner.min-sample-count：设置最小采样行数，避免小数据集下采样不足，默认值是10000行，可按需调整：

    kylin.cube.cubeplanner.min-sample-count=10000
    

• 配置统计数据刷新周期：默认每天凌晨自动刷新统计数据，可通过Cron表达式修改刷新时间：

  kylin.cube.cubeplanner.statistics-refresh-cron=0 0 0 * * ?
  

• 重启Kylin服务：所有配置修改完成后，必须重启Kylin服务才能让配置生效。

先给你明确结论：Cube Planner绝对不是只支持3个月以上的旧Cube，你10天前创建的新Cube完全在支持范围内。你遇到的Cuboid层级颜色无变化、没有统计数据的问题，大概率是某些环节没跑通，我给你梳理几个排查方向：

• 确认查询是否被正确采集：
  Cube Planner只会统计通过Kylin官方查询接口执行的SQL，如果你是直接访问底层HBase或者查询被缓存命中，这些请求不会被纳入统计。你可以去Kylin的查询日志里核对，看看那数千次查询是不是都被记录到了Cube Planner的统计队列中。
• 检查Cube Segment的状态：
  只有**在线（Online）**状态的Segment才会被Cube Planner纳入统计范围。如果你的Segment是离线、未构建完成或者处于其他异常状态，Cube Planner根本拿不到对应的数据。
• 手动触发统计刷新：
  默认的统计刷新是每天凌晨执行，如果你刚跑完大量查询，可能还没到自动刷新的时间。你可以手动触发：
  1. 登录Kylin Web UI，进入目标Cube的详情页
  2. 切换到"Cube Planner"标签页，点击页面顶部的刷新统计数据按钮（2.3.0版本的按钮位置就在标签页上方）
• 验证配置是否生效：
  重启Kylin后，去启动日志里搜kylin.cube.cubeplanner.enabled，确认这个参数确实被加载为true，有没有出现配置冲突的报错信息。
• 查看后台任务状态：
  进入Kylin的"系统"->"任务管理"页面，找找有没有Cube Planner相关的统计任务。如果任务失败，直接看失败日志就能定位问题所在。

内容的提问来源于stack exchange，提问作者Praveenece