CubeJS original_sql预聚合报错：dev_pre_aggregations.product_base不存在

问题场景 #

我在CubeJS的Product Cube中配置了original_sql类型的预聚合：

pre_aggregations: {
    base: {
      type: `original_sql`,
      external: false,
    },

    main: {
      dimensions: [
          Product.product_sid,
          Product.amount,
      ],
      use_original_sql_pre_aggregations: true,
      refresh_key: {
        every: `1 day`,
      },
    },
  },

在Playground执行查询时，报错提示relation "dev_pre_aggregations.product_base" does not exist。检查PostgreSQL存储发现：

• dev_pre_aggregations schema和预聚合表已创建，但表名带有随机后缀（如product_base_ery3312）
• 即便设置了refresh_key.every: '1 day'，表仍每隔几分钟就会重新创建

问题原因 #

• 当original_sql类型的预聚合未指定sql语句时，CubeJS无法确定预聚合的数据源逻辑，会自动生成带随机后缀的临时表，并且因为无法判断数据是否需要更新，频繁触发表重建。
• main预聚合开启了use_original_sql_pre_aggregations: true，会尝试引用无后缀的product_base表，但实际生成的表带随机后缀，导致找不到表的报错。

解决办法 #

1. 给original_sql预聚合添加明确的SQL语句 #

必须为base预聚合指定sql字段，明确预聚合要查询的数据逻辑，这样CubeJS才能生成稳定的无后缀表名，同时根据refresh_key规则刷新。示例配置：

pre_aggregations: {
    base: {
      type: `original_sql`,
      external: false,
      // 替换为你的实际业务SQL，需包含后续预聚合用到的所有维度字段
      sql: `SELECT product_sid, amount FROM products`
    },

    main: {
      dimensions: [
          Product.product_sid,
          Product.amount,
      ],
      use_original_sql_pre_aggregations: true,
      refresh_key: {
        every: `1 day`,
      },
    },
  },

2. 验证预聚合表状态 #

重启CubeJS服务后，检查PostgreSQL的dev_pre_aggregations schema：

• 确认product_base表不带随机后缀
• 观察表的重建频率，应该按照refresh_key设置的1天周期执行，而非频繁重建

3. 确认查询正常执行 #

在Playground重新执行查询，查看CubeJS生成的SQL日志，确认已经正确引用dev_pre_aggregations.product_base表，报错应该消失。

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