@cubejs-backend/cubestore

中文文档
1.8.21发布于 2026/11/10Apache-2.0TypeScriptCommonJS构建来源已验证近 30 天下载 28.7万

立方体预聚合存储层.

中文使用文档
文档目录11 节
  1. 动机
  2. 方针
  3. 计划
  4. 支助的架构和平台
  5. 使用量
  6. 与立方体
  7. 与 Docker 关系
  8. 用多克编曲
  9. 构建
  10. 发展
  11. 许可证

Cube

网站 二. 支助 文档 二. 支助 实例 二. 支助 博客 二. 支助 偷懒 二. 支助 微博

npm version GitHub Actions FOSSA Status

立方体存储器

立方体预聚合存储层.

动机

在过去的一年里,我们积累了 有关各种用法的反馈 预汇总和如何储存. 我们得知有一套 关系数据库作为存储层具有显著意义的问题 业绩和功能问题.

这些问题包括:

  • 业绩问题,主要股价高(1B及以上)
  • 缺少超日志支持
  • 大项的退化性能 UNION ALL 查询
  • 穷 JOIN 各个滚动表格的业绩
  • 不同数据库类型的表格/名称长度问题
  • SQL 来源和外部数据库之间的类型差异

随着时间的推移,我们意识到,如果我们试图用现有数据库来解决这些问题 引擎,我们最终会修改 这些数据库的代码库 的方式或那样.

我们决定采取另一种方式,写出我们自己实现的OLAP缓存 存储,仅用于存储和提供规模的滚动表.

方针

为了尽可能优化性能,我们采取了本土方法 正在使用 Rust 开发 Cube Store, 使用一系列技术,例如 RocksDB, Apache Parquet, 和箭头, 已经证明有效的解决方案 数据访问问题.

Cube Store完全开源,并以Apache 2.0许可证发布.

计划

我们打算开始发行 Cube Store 与 Cube,并最终制作 Cube 存储 Cube 的默认预聚合存储层 。 支助 MySQL和Postgres作为外部数据库将继续下去,但优先程度较低.

我们还将更新所有关于预汇总的文件,并包括使用情况 和Cube Store的部署指令.

支助的架构和平台

如果您的平台/ architecture 不支持, 您可以启动 Cube Store 使用多克语.

linux-gnulinux-musldarwinwin32
x86不详不详不详不详
x86_64✅✅✅✅
arm64✅[1]

[1] 可以使用Rosetta 2通过 x86_64-apple 二进制.

使用量

与立方体

从开始 v0.26.48,当 CUBEJS_DEV_MODE=true。 。 。 . 你不需要设置任何 CUBEJS_EXT_DB_* 环境变量或 externalDriverFactory 在你体内 cube.js 配置文件 .

之前的版本 v0.26.48,您应该将您的项目升级到最新的 版本并安装 Cube Store 驱动程序 :

yarn add @cubejs-backend/cubestore-driver

启动后, Cube 会打印一个消息 :

🔥 Cube Store (0.26.64) is assigned to 3030 port.

与 Docker 关系

在多克容器中启动 Cube Store并绑定端口 3030 改为 127.0.0.1数字 :

docker run -d -p 3030:3030 cubejs/cubestore:edge

配置 Cube 以通过 .env 文件 :

CUBEJS_EXT_DB_TYPE=cubestore
CUBEJS_EXT_DB_HOST=127.0.0.1

用多克编曲

创建一个 docker-compose.yml 包含以下内容的文件 :

version: '2.2'
services:
  cubestore:
    image: cubejs/cubestore:edge

  cube:
    image: cubejs/cube:latest
    ports:
      - 4000:4000  # Cube API and Developer Playground
      - 3000:3000  # Dashboard app, if created
    env_file: .env
    depends_on:
      - cubestore
    links:
      - cubestore
    volumes:
      - ./schema:/cube/conf/schema

配置 Cube 以通过 .env 文件 :

CUBEJS_EXT_DB_TYPE=cubestore
CUBEJS_EXT_DB_HOST=cubestore

构建

docker build -t cubejs/cubestore:latest .
docker run --rm cubejs/cubestore:latest

发展

Debian 先决条件( 不完整 ) : apt-get install lld libssl-dev pkg-config cmake

当更改数据化或箭头时 :

检查出来 https://github.com/cube-js/arrow-rs/tree/cube 页面存档备份,存于互联网档案馆 财务报告和审定财务报表 https://github.com/cube-js/arrow-datacumpation/tree/cube 互联网档案馆的存檔,存档日期2013-12-22 并添加 跟随当前目录 Cargo.toml. (但记住: 把这个排除在公关之外!)


[patch.'https://github.com/cube-js/arrow-rs']
parquet = { path = "../../../arrow-rs/parquet" }
arrow = { path = "../../../arrow-rs/arrow" }

[patch.'https://github.com/cube-js/arrow-datafusion']
datafusion = { path = "../../../arrow-datafusion/datafusion" }

当然,你可以使用绝对路径或调整路径 选择了退出地点.

箭头数据化的解说 .cargo/config.toml 路径线对你也有用,但如果 您正在修改箭头.

许可证

立方体存储器 Apache 2.0 许可。 。 。 .

版本与发布记录

@cubejs-backend/cubestore 共发布 705 个版本,首次发布于 2021/02/20;过去 12 个月发布了 173 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.8.21latest2026/11/101 天前
1.4.62026/11/101 天前
1.6.772026/11/074 天前
1.8.202026/11/064 天前
1.8.192026/11/065 天前
1.8.182026/11/037 天前

关于 @cubejs-backend/cubestore 的常见问题

@cubejs-backend/cubestore 是什么?

立方体预聚合存储层.

如何安装 @cubejs-backend/cubestore?

在项目目录运行 npm install @cubejs-backend/cubestore,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 cubestore-dev,可以用 npx cubestore-dev 直接运行。

@cubejs-backend/cubestore 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@cubejs-backend/cubestore 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@cubejs-backend/cubestore 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js ^12.0.0 || ^14.0.0 || >=16.0.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@cubejs-backend/cubestore 可以商用吗?

@cubejs-backend/cubestore 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@cubejs-backend/cubestore 的下载量有多少?

根据 npm 官方下载统计,@cubejs-backend/cubestore 在 2026/10/11 – 2026/11/09 这 30 天内被下载 287,358 次,日均约 9,579 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@cubejs-backend/cubestore 还在维护吗?

最新版本 1.8.21 发布于 2026/11/10(1 天前);至今共发布 705 个版本,其中过去 12 个月发布了 173 个;首次发布于 2021/02/20。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。