Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 13 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,19 @@
All notable changes to this project will be documented in this file.
See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.

## [1.7.27](https://github.com/cube-js/cube/compare/v1.7.26...v1.7.27) (2026-08-26)

### Bug Fixes

- **backend-native:** treat a client disconnect on /v1/cubesql as a graceful end ([#11649](https://github.com/cube-js/cube/issues/11649)) ([e803c6c](https://github.com/cube-js/cube/commit/e803c6cb58610c5da1a0710664a99d3047a6b3de))
- **cubesql:** Prefer SQL pushdown over limitless post-processing ([#11559](https://github.com/cube-js/cube/issues/11559)) ([b022de1](https://github.com/cube-js/cube/commit/b022de166acefa29766c4760f81241e31cf9ac16))
- **cubestore:** inline aggregate dropped rows past the first partition ([#11631](https://github.com/cube-js/cube/issues/11631)) ([6f3e66d](https://github.com/cube-js/cube/commit/6f3e66d4fcf89733a21d730d3e90fcb493a72dd0))
- **schema-compiler:** a cube that extends another broke the parent's multi-stage measures ([#11641](https://github.com/cube-js/cube/issues/11641)) ([657f4e1](https://github.com/cube-js/cube/commit/657f4e18ae75c69dd4db4057e14867f8a7d91247))

### Features

- **cubesql:** Support `COPY ... FROM STDIN` ([#11538](https://github.com/cube-js/cube/issues/11538)) ([534f839](https://github.com/cube-js/cube/commit/534f8392830df33b7934129cbcbe068984e42903))

## [1.7.26](https://github.com/cube-js/cube/compare/v1.7.25...v1.7.26) (2026-08-24)

### Bug Fixes
Expand Down
36 changes: 36 additions & 0 deletions docs-mintlify/docs/pre-aggregations/cube-store-architecture.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -996,6 +996,42 @@ Because detection is timestamp-based and cancellation is idempotent, it
does not matter which instance notices first: recovery works even if the
failed node never comes back.

### Message size limits

Cube talks to the cache and queue store over a WebSocket connection, and
every cache entry, queue payload, and query result crosses it as one
message. That transport has a hard ceiling:

| Limit | Environment variable | Default | Allowed range |
|---|---|---|---|
| Transport message size | `CUBESTORE_TRANSPORT_MAX_MESSAGE_SIZE` | 64 MiB | 16 MiB — 256 MiB |
| Transport frame size | `CUBESTORE_TRANSPORT_MAX_FRAME_SIZE` | 64 MiB | 4 MiB — 256 MiB |
| Single cache entry | `CUBESTORE_CACHE_MAX_ENTRY_SIZE` | 63 MiB | up to transport message size − 1 MiB |

Query results are the usual reason these limits are reached. A result is
handed to the queue store so that every API instance waiting on that query
can pick it up, and it is written to the cache under its cache key — so a
result set larger than the transport limit cannot be delivered at all,
however fast the query that produced it was.

A cache entry at or above `CUBESTORE_CACHE_MAX_ENTRY_SIZE` is rejected explicitly,
with `Unable to SET cache with '<key>' key, exceeds maximum allowed size for
payload: <size>, max allowed: <limit>`.

<Warning>

**Known limitation.** A message above the *transport* limit is not answered
with an error. The deployment then reports `ConnectionError: CubeStore connection error:
write EPIPE`.

</Warning>

If a query hits this limit, reduce the size of its result set — add filters
or a lower `limit`, drop dimensions, or split it into several queries.
Self-hosted deployments can raise the ceiling instead, but
`CUBESTORE_TRANSPORT_MAX_MESSAGE_SIZE` and `CUBESTORE_TRANSPORT_MAX_FRAME_SIZE`
have to go up together, since a message is sent as a single frame.

### Why it lives in Cube Store

Folding the cache and queue into Cube Store is itself a design decision in
Expand Down
32 changes: 32 additions & 0 deletions docs-mintlify/reference/configuration/environment-variables.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -1870,6 +1870,18 @@ The address/port pair for Cube Store's MySQL-compatible interface.
| ------------------------- | ---------------------- | --------------------- |
| A valid address/port pair | `0.0.0.0:3306` | `0.0.0.0:3306` |

## `CUBESTORE_CACHE_MAX_ENTRY_SIZE`

The maximum size of a single entry in Cube Store's
[cache store](/docs/pre-aggregations/cube-store-architecture#cache-and-queue-store).
Larger entries are rejected. Cannot exceed
[`CUBESTORE_TRANSPORT_MAX_MESSAGE_SIZE`](#cubestore_transport_max_message_size)
minus 1 MiB.

| Possible Values | Default in Development | Default in Production |
| --------------- | ---------------------- | --------------------- |
| A size, e.g. `63MiB` | `63MiB` | `63MiB` |

## `CUBESTORE_DATA_DIR`

A path on the local filesystem to store a local replica of the data. Must be
Expand Down Expand Up @@ -2134,6 +2146,26 @@ If `true`, then sends telemetry to Cube.
| --------------- | ---------------------- | --------------------- |
| `true`, `false` | `true` | `true` |

## `CUBESTORE_TRANSPORT_MAX_MESSAGE_SIZE`

The maximum size of a single message on the WebSocket connection between Cube
and Cube Store. Messages above this size close the connection; see
[message size limits](/docs/pre-aggregations/cube-store-architecture#message-size-limits).

| Possible Values | Default in Development | Default in Production |
| --------------- | ---------------------- | --------------------- |
| A size from `16MiB` to `256MiB` | `64MiB` | `64MiB` |

## `CUBESTORE_TRANSPORT_MAX_FRAME_SIZE`

The maximum size of a single WebSocket frame on the connection between Cube
and Cube Store. A message is split into frames, so this can be smaller than
[`CUBESTORE_TRANSPORT_MAX_MESSAGE_SIZE`](#cubestore_transport_max_message_size).

| Possible Values | Default in Development | Default in Production |
| --------------- | ---------------------- | --------------------- |
| A size from `4MiB` to `256MiB` | `64MiB` | `64MiB` |

## `CUBESTORE_WAL_SPLIT_THRESHOLD`

The maximum number of rows to keep in a single chunk of data right after
Expand Down
2 changes: 1 addition & 1 deletion lerna.json
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
{
"version": "1.7.26",
"version": "1.7.27",
"npmClient": "yarn",
"command": {
"bootstrap": {
Expand Down
4 changes: 4 additions & 0 deletions packages/cubejs-api-gateway/CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,10 @@
All notable changes to this project will be documented in this file.
See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.

## [1.7.27](https://github.com/cube-js/cube/compare/v1.7.26...v1.7.27) (2026-08-26)

**Note:** Version bump only for package @cubejs-backend/api-gateway

## [1.7.26](https://github.com/cube-js/cube/compare/v1.7.25...v1.7.26) (2026-08-24)

**Note:** Version bump only for package @cubejs-backend/api-gateway
Expand Down
10 changes: 5 additions & 5 deletions packages/cubejs-api-gateway/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
"name": "@cubejs-backend/api-gateway",
"description": "Cube API Gateway",
"author": "Cube Dev, Inc.",
"version": "1.7.26",
"version": "1.7.27",
"repository": {
"type": "git",
"url": "https://github.com/cube-js/cube.git",
Expand All @@ -27,9 +27,9 @@
"dist/src/*"
],
"dependencies": {
"@cubejs-backend/native": "1.7.26",
"@cubejs-backend/query-orchestrator": "1.7.26",
"@cubejs-backend/shared": "1.7.26",
"@cubejs-backend/native": "1.7.27",
"@cubejs-backend/query-orchestrator": "1.7.27",
"@cubejs-backend/shared": "1.7.27",
"@ungap/structured-clone": "^0.3.4",
"assert-never": "^1.4.0",
"body-parser": "^1.19.0",
Expand All @@ -53,7 +53,7 @@
"zod": "^4.1.13"
},
"devDependencies": {
"@cubejs-backend/linter": "1.7.26",
"@cubejs-backend/linter": "1.7.27",
"@types/express": "^4.17.21",
"@types/jest": "^29",
"@types/jsonwebtoken": "^9.0.2",
Expand Down
4 changes: 4 additions & 0 deletions packages/cubejs-athena-driver/CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,10 @@
All notable changes to this project will be documented in this file.
See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.

## [1.7.27](https://github.com/cube-js/cube/compare/v1.7.26...v1.7.27) (2026-08-26)

**Note:** Version bump only for package @cubejs-backend/athena-driver

## [1.7.26](https://github.com/cube-js/cube/compare/v1.7.25...v1.7.26) (2026-08-24)

**Note:** Version bump only for package @cubejs-backend/athena-driver
Expand Down
10 changes: 5 additions & 5 deletions packages/cubejs-athena-driver/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
"name": "@cubejs-backend/athena-driver",
"description": "Cube.js Athena database driver",
"author": "Cube Dev, Inc.",
"version": "1.7.26",
"version": "1.7.27",
"repository": {
"type": "git",
"url": "https://github.com/cube-js/cube.git",
Expand Down Expand Up @@ -31,12 +31,12 @@
"dependencies": {
"@aws-sdk/client-athena": "^3.22.0",
"@aws-sdk/credential-providers": "^3.22.0",
"@cubejs-backend/base-driver": "1.7.26",
"@cubejs-backend/shared": "1.7.26"
"@cubejs-backend/base-driver": "1.7.27",
"@cubejs-backend/shared": "1.7.27"
},
"devDependencies": {
"@cubejs-backend/linter": "1.7.26",
"@cubejs-backend/testing-shared": "1.7.26",
"@cubejs-backend/linter": "1.7.27",
"@cubejs-backend/testing-shared": "1.7.27",
"@types/ramda": "^0.27.40",
"typescript": "~5.2.2"
},
Expand Down
4 changes: 4 additions & 0 deletions packages/cubejs-backend-cloud/CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,10 @@
All notable changes to this project will be documented in this file.
See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.

## [1.7.27](https://github.com/cube-js/cube/compare/v1.7.26...v1.7.27) (2026-08-26)

**Note:** Version bump only for package @cubejs-backend/cloud

## [1.7.26](https://github.com/cube-js/cube/compare/v1.7.25...v1.7.26) (2026-08-24)

**Note:** Version bump only for package @cubejs-backend/cloud
Expand Down
6 changes: 3 additions & 3 deletions packages/cubejs-backend-cloud/package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "@cubejs-backend/cloud",
"version": "1.7.26",
"version": "1.7.27",
"description": "Cube Cloud package",
"main": "dist/src/index.js",
"typings": "dist/src/index.d.ts",
Expand Down Expand Up @@ -30,15 +30,15 @@
"devDependencies": {
"@babel/core": "^7.24.5",
"@babel/preset-env": "^7.24.5",
"@cubejs-backend/linter": "1.7.26",
"@cubejs-backend/linter": "1.7.27",
"@types/fs-extra": "^9.0.8",
"@types/jest": "^29",
"jest": "^29",
"typescript": "~5.2.2"
},
"dependencies": {
"@cubejs-backend/dotenv": "^9.0.2",
"@cubejs-backend/shared": "1.7.26",
"@cubejs-backend/shared": "1.7.27",
"chokidar": "^3.5.1",
"env-var": "^6.3.0",
"form-data": "^4.0.0",
Expand Down
4 changes: 4 additions & 0 deletions packages/cubejs-backend-maven/CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,10 @@
All notable changes to this project will be documented in this file.
See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.

## [1.7.27](https://github.com/cube-js/cube/compare/v1.7.26...v1.7.27) (2026-08-26)

**Note:** Version bump only for package @cubejs-backend/maven

## [1.7.26](https://github.com/cube-js/cube/compare/v1.7.25...v1.7.26) (2026-08-24)

**Note:** Version bump only for package @cubejs-backend/maven
Expand Down
6 changes: 3 additions & 3 deletions packages/cubejs-backend-maven/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
"name": "@cubejs-backend/maven",
"description": "Cube.js Maven Wrapper for java dependencies downloading",
"author": "Cube Dev, Inc.",
"version": "1.7.26",
"version": "1.7.27",
"license": "Apache-2.0",
"repository": {
"type": "git",
Expand Down Expand Up @@ -31,12 +31,12 @@
"dist/src/*"
],
"dependencies": {
"@cubejs-backend/shared": "1.7.26",
"@cubejs-backend/shared": "1.7.27",
"source-map-support": "^0.5.19",
"xmlbuilder2": "^2.4.0"
},
"devDependencies": {
"@cubejs-backend/linter": "1.7.26",
"@cubejs-backend/linter": "1.7.27",
"@types/jest": "^29",
"@types/node": "^22",
"jest": "^29",
Expand Down
6 changes: 6 additions & 0 deletions packages/cubejs-backend-native/CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,12 @@
All notable changes to this project will be documented in this file.
See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.

## [1.7.27](https://github.com/cube-js/cube/compare/v1.7.26...v1.7.27) (2026-08-26)

### Bug Fixes

- **backend-native:** treat a client disconnect on /v1/cubesql as a graceful end ([#11649](https://github.com/cube-js/cube/issues/11649)) ([e803c6c](https://github.com/cube-js/cube/commit/e803c6cb58610c5da1a0710664a99d3047a6b3de))

## [1.7.26](https://github.com/cube-js/cube/compare/v1.7.25...v1.7.26) (2026-08-24)

**Note:** Version bump only for package @cubejs-backend/native
Expand Down
8 changes: 4 additions & 4 deletions packages/cubejs-backend-native/package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "@cubejs-backend/native",
"version": "1.7.26",
"version": "1.7.27",
"author": "Cube Dev, Inc.",
"description": "Native module for Cube.js (binding to Rust codebase)",
"main": "dist/js/index.js",
Expand Down Expand Up @@ -39,7 +39,7 @@
"dist/js"
],
"devDependencies": {
"@cubejs-backend/linter": "1.7.26",
"@cubejs-backend/linter": "1.7.27",
"@types/jest": "^29",
"@types/node": "^22",
"cargo-cp-artifact": "^0.1.9",
Expand All @@ -50,8 +50,8 @@
"uuid": "^11.1.1"
},
"dependencies": {
"@cubejs-backend/cubesql": "1.7.26",
"@cubejs-backend/shared": "1.7.26",
"@cubejs-backend/cubesql": "1.7.27",
"@cubejs-backend/shared": "1.7.27",
"@cubejs-infra/post-installer": "^0.1.2"
},
"resources": {
Expand Down
4 changes: 4 additions & 0 deletions packages/cubejs-backend-shared/CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,10 @@
All notable changes to this project will be documented in this file.
See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.

## [1.7.27](https://github.com/cube-js/cube/compare/v1.7.26...v1.7.27) (2026-08-26)

**Note:** Version bump only for package @cubejs-backend/shared

## [1.7.26](https://github.com/cube-js/cube/compare/v1.7.25...v1.7.26) (2026-08-24)

### Features
Expand Down
4 changes: 2 additions & 2 deletions packages/cubejs-backend-shared/package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "@cubejs-backend/shared",
"version": "1.7.26",
"version": "1.7.27",
"description": "Shared code for Cube.js backend packages",
"main": "dist/src/index.js",
"typings": "dist/src/index.d.ts",
Expand All @@ -27,7 +27,7 @@
},
"license": "Apache-2.0",
"devDependencies": {
"@cubejs-backend/linter": "1.7.26",
"@cubejs-backend/linter": "1.7.27",
"@types/bytes": "^3.1.5",
"@types/cli-progress": "^3.9.1",
"@types/jest": "^29",
Expand Down
4 changes: 4 additions & 0 deletions packages/cubejs-base-driver/CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,10 @@
All notable changes to this project will be documented in this file.
See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.

## [1.7.27](https://github.com/cube-js/cube/compare/v1.7.26...v1.7.27) (2026-08-26)

**Note:** Version bump only for package @cubejs-backend/base-driver

## [1.7.26](https://github.com/cube-js/cube/compare/v1.7.25...v1.7.26) (2026-08-24)

### Features
Expand Down
6 changes: 3 additions & 3 deletions packages/cubejs-base-driver/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
"name": "@cubejs-backend/base-driver",
"description": "Cube.js Base Driver",
"author": "Cube Dev, Inc.",
"version": "1.7.26",
"version": "1.7.27",
"repository": {
"type": "git",
"url": "https://github.com/cube-js/cube.git",
Expand Down Expand Up @@ -33,11 +33,11 @@
"@aws-sdk/s3-request-presigner": "^3.49.0",
"@azure/identity": "^4.4.1",
"@azure/storage-blob": "^12.9.0",
"@cubejs-backend/shared": "1.7.26",
"@cubejs-backend/shared": "1.7.27",
"@google-cloud/storage": "^7.13.0"
},
"devDependencies": {
"@cubejs-backend/linter": "1.7.26",
"@cubejs-backend/linter": "1.7.27",
"@types/jest": "^29",
"@types/node": "^22",
"jest": "^29",
Expand Down
4 changes: 4 additions & 0 deletions packages/cubejs-bigquery-driver/CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,10 @@
All notable changes to this project will be documented in this file.
See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.

## [1.7.27](https://github.com/cube-js/cube/compare/v1.7.26...v1.7.27) (2026-08-26)

**Note:** Version bump only for package @cubejs-backend/bigquery-driver

## [1.7.26](https://github.com/cube-js/cube/compare/v1.7.25...v1.7.26) (2026-08-24)

**Note:** Version bump only for package @cubejs-backend/bigquery-driver
Expand Down
Loading
Loading