CubeJS用ClickHouse作外部预聚合库时表引擎未指定报错求助

问题描述 #

使用MySQL作为CubeJS内部数据库，ClickHouse作为外部预聚合数据库时，调度器构建外部表时抛出错误：
Unknown error field: Code: 119. DB::Exception: Table engine is not specified in CREATE query. (ENGINE_REQUIRED) (version 22.7.2.1)

查阅资料得知添加ENGINE = MergeTree()可解决该问题，且CubeJS的ClickHouseQuery.js中已包含MergeTree相关代码，但预聚合查询时该代码未被调用。

当前.env配置 #

CUBEJS_DB_TYPE=mysql
CUBEJS_DB_HOST=host
CUBEJS_DB_USER=user
CUBEJS_DB_PASS=password
CUBEJS_DB_NAME=primary_db

CUBEJS_EXT_DB_TYPE=clickhouse
CUBEJS_EXT_DB_HOST=127.0.0.1
CUBEJS_EXT_DB_PORT=8123
CUBEJS_EXT_DB_USER=default

CUBEJS_EXTERNAL_DEFAULT=true
CUBEJS_SCHEDULED_REFRESH_DEFAULT=true
CUBEJS_DEV_MODE=true
CUBEJS_SCHEMA_PATH=model

排查与解决方案建议 #

• 升级CubeJS版本：旧版本可能存在外部预聚合生成ClickHouse表时未正确注入ENGINE的bug，建议升级到最新稳定版。
• 显式指定表引擎：在CubeJS的schema文件中，针对需要预聚合的cube，添加external配置强制指定表引擎。示例：

cube('YourCubeName', {
  // 基础维度、度量配置...
  external: {
    engine: 'MergeTree()',
    // 可选：添加排序键优化性能
    orderBy: 'your_sort_column'
  },
  preAggregations: {
    main: {
      type: 'rollup',
      measures: [YourCubeName.measure1],
      dimensions: [YourCubeName.dimension1],
      scheduledRefresh: true
    }
  }
});

• 验证ClickHouse权限：确保配置的ClickHouse用户拥有创建表的权限，避免因权限问题导致SQL执行异常。
• 开启调试日志：添加CUBEJS_LOG_LEVEL=debug到.env配置，查看调度器生成的CREATE TABLE语句，确认是否包含ENGINE配置，定位问题根源。

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