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
14 changes: 14 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,20 @@
All notable changes to this project will be documented in this file.
See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.

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

### Bug Fixes

- **cubestore:** transmit the router's planning flags with the query ([#11628](https://github.com/cube-js/cube/issues/11628)) ([d48a64e](https://github.com/cube-js/cube/commit/d48a64ee7a9c1f00cbab243ff303ee66fabcbc87))
- **tesseract:** keep time_shift when a pre-aggregation serves the query ([#11599](https://github.com/cube-js/cube/issues/11599)) ([23255e2](https://github.com/cube-js/cube/commit/23255e27d6ba2e04d23819bf3a0d8b30102347bb))
- **tesseract:** parenthesize member SQL spliced into filter templates ([#11502](https://github.com/cube-js/cube/issues/11502)) ([e9f5407](https://github.com/cube-js/cube/commit/e9f540774f049e329b8133ee2451686b34684991))
- **tesseract:** resolve pre-agg refs interpolating the cube ([#11602](https://github.com/cube-js/cube/issues/11602)) ([cc16c17](https://github.com/cube-js/cube/commit/cc16c17bb06700f28ebc2882420d723cc88c5c05))

### Features

- **cube-cli:** run and follow a dbt sync from the CLI ([#11612](https://github.com/cube-js/cube/issues/11612)) ([f5ee250](https://github.com/cube-js/cube/commit/f5ee250cb5874a53a8da7b4114b085ac8629f741)), closes [#11562](https://github.com/cube-js/cube/issues/11562)
- Queue - support fast track feature ([#11618](https://github.com/cube-js/cube/issues/11618)) ([749e0ab](https://github.com/cube-js/cube/commit/749e0abe7b59db7c2a71a2e781361bf0ce2c3edb))

## [1.7.25](https://github.com/cube-js/cube/compare/v1.7.24...v1.7.25) (2026-08-21)

### Bug Fixes
Expand Down
21 changes: 21 additions & 0 deletions docs-mintlify/reference/configuration/environment-variables.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -184,6 +184,27 @@ The port of the Cube Store deployment.
| ------------------- | ---------------------- | --------------------- |
| A valid port number | `3030` | `3030` |

## `CUBEJS_QUEUE_FAST_TRACK`

<Warning>

The fast-track path is experimental and off by default. Its behavior may still change,
and we don't recommend enabling it in production yet.

</Warning>

Enables the preview fast-track path for Cube Store query queues. When enabled,
Cube can atomically enqueue and retrieve a query when queue concurrency is
available, reducing queue coordination round trips. It applies to queries at
queue priority 10 and above, which is where user-facing queries and the
pre-aggregation builds a request waits on are submitted; background refresh runs
below that and keeps using the regular path. This requires Cube Store
1.7.25 or newer; against an older version Cube keeps using the regular path.

| Possible Values | Default in Development | Default in Production |
| --------------- | ---------------------- | --------------------- |
| `true`, `false` | `false` | `false` |

## `CUBEJS_DATASOURCES`

A comma-separated list of data source names. Data sources defined here can be
Expand Down
75 changes: 75 additions & 0 deletions docs-mintlify/reference/core-data-apis/sql-api/reference.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -186,6 +186,80 @@ SET TIME ZONE 'UTC';
Use `DEFAULT` to reset the time zone to its default. The `LOCAL` form
(`SET TIME ZONE LOCAL`) is not supported.

### `CREATE TEMPORARY TABLE`

Synopsis:

```sql
CREATE TEMPORARY TABLE table_name AS query
CREATE TEMPORARY TABLE table_name ( column_name data_type [, ...] )
```

Creates a table that lives for the duration of the session, either filled by a
query or empty, to be filled by [`COPY`](#copy). Temporary tables can be joined
with cubes, and are dropped with `DROP TABLE`.

Column types are limited to those `COPY` can load:

- `boolean`
- `smallint`, `integer`, `bigint`
- `real`, `double precision`, `numeric` (up to a precision of 38)
- `varchar`, `text`, and the other variable-width character types (`character
varying`, `nvarchar`, `string`), as well as `uuid`, `json` and `jsonb`, all of
which are stored as text
- `date`, `timestamp` (and `datetime`) without a time zone

A `numeric` without a precision holds `numeric(38, 10)`, so values are rounded to
ten decimal places. Give the precision and scale to keep more of them.

Fixed-width `character`/`char` columns are not accepted: PostgreSQL pads their
values to the declared width and ignores trailing blanks when comparing them, which
a text column does not do. Use `varchar` or `text` instead.

The amount of data held is capped per session and per server, by the
`CUBESQL_TEMP_TABLE_SESSION_MEM` (10 MiB) and `CUBESQL_TEMP_TABLE_TOTAL_MEM`
(100 MiB) environment variables.

### `COPY`

Synopsis:

```sql
COPY table_name [ ( column_name [, ...] ) ]
FROM STDIN
[ [ WITH ] ( option [, ...] ) ]
```

Loads data sent by the client into a [temporary
table](#create-temporary-table). Only `FROM STDIN` is supported: cubes are a
read-only data source, so a temporary table is the only place data can go, and
a file or a program target would read on the Cube host rather than on the
machine running the client.

Columns not listed in the statement are left `NULL`. Repeating the command
appends more rows to the table.

Supported options: `FORMAT` (`text` or `csv`), `DELIMITER`, `NULL`, `HEADER`,
`QUOTE`, `ESCAPE`, `FORCE_NOT_NULL`, `FORCE_NULL`, and `ENCODING` (`UTF8`
only). They behave as [in PostgreSQL][link-postgres-copy], including their
defaults. The pre-9.0 syntax (e.g. `CSV HEADER`) is supported as well; the
`BINARY` format is not.

Example, using the `\copy` command of `psql` to load a CSV file:

```sql
CREATE TEMPORARY TABLE targets (city text, target numeric(10, 2));
CREATE TABLE

\copy targets FROM 'targets.csv' WITH (FORMAT csv, HEADER)
COPY 42

SELECT city, SUM(count), MAX(target)
FROM orders CROSS JOIN targets
WHERE orders.city = targets.city
GROUP BY 1;
```

## SQL functions and operators

SQL API currently implements a subset of functions and operators [supported by
Expand Down Expand Up @@ -534,6 +608,7 @@ See the [XIRR recipe](/recipes/data-modeling/xirr) for more details.
[ref-rest-api]: /reference/core-data-apis/rest-api
[ref-graphql-api]: /reference/core-data-apis/graphql-api
[link-postgres-funcs]: https://www.postgresql.org/docs/current/functions.html
[link-postgres-copy]: https://www.postgresql.org/docs/current/sql-copy.html
[link-github-sql-api]: https://github.com/cube-js/cube/issues?q=is%3Aopen+is%3Aissue+label%3Aapi%3Asql
[link-github-new-sql-api-issue]: https://github.com/cube-js/cube/issues/new?assignees=&labels=&projects=&template=sql_api_query_issue.md&title=
[link-xirr]: https://support.microsoft.com/en-us/office/xirr-function-de1242ec-6477-445b-b11b-a303ad9adc9d
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.25",
"version": "1.7.26",
"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.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

## [1.7.25](https://github.com/cube-js/cube/compare/v1.7.24...v1.7.25) (2026-08-21)

**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.25",
"version": "1.7.26",
"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.25",
"@cubejs-backend/query-orchestrator": "1.7.25",
"@cubejs-backend/shared": "1.7.25",
"@cubejs-backend/native": "1.7.26",
"@cubejs-backend/query-orchestrator": "1.7.26",
"@cubejs-backend/shared": "1.7.26",
"@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.25",
"@cubejs-backend/linter": "1.7.26",
"@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.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

## [1.7.25](https://github.com/cube-js/cube/compare/v1.7.24...v1.7.25) (2026-08-21)

**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.25",
"version": "1.7.26",
"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.25",
"@cubejs-backend/shared": "1.7.25"
"@cubejs-backend/base-driver": "1.7.26",
"@cubejs-backend/shared": "1.7.26"
},
"devDependencies": {
"@cubejs-backend/linter": "1.7.25",
"@cubejs-backend/testing-shared": "1.7.25",
"@cubejs-backend/linter": "1.7.26",
"@cubejs-backend/testing-shared": "1.7.26",
"@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.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

## [1.7.25](https://github.com/cube-js/cube/compare/v1.7.24...v1.7.25) (2026-08-21)

**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.25",
"version": "1.7.26",
"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.25",
"@cubejs-backend/linter": "1.7.26",
"@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.25",
"@cubejs-backend/shared": "1.7.26",
"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.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

## [1.7.25](https://github.com/cube-js/cube/compare/v1.7.24...v1.7.25) (2026-08-21)

**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.25",
"version": "1.7.26",
"license": "Apache-2.0",
"repository": {
"type": "git",
Expand Down Expand Up @@ -31,12 +31,12 @@
"dist/src/*"
],
"dependencies": {
"@cubejs-backend/shared": "1.7.25",
"@cubejs-backend/shared": "1.7.26",
"source-map-support": "^0.5.19",
"xmlbuilder2": "^2.4.0"
},
"devDependencies": {
"@cubejs-backend/linter": "1.7.25",
"@cubejs-backend/linter": "1.7.26",
"@types/jest": "^29",
"@types/node": "^22",
"jest": "^29",
Expand Down
4 changes: 4 additions & 0 deletions packages/cubejs-backend-native/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.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

## [1.7.25](https://github.com/cube-js/cube/compare/v1.7.24...v1.7.25) (2026-08-21)

**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.25",
"version": "1.7.26",
"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.25",
"@cubejs-backend/linter": "1.7.26",
"@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.25",
"@cubejs-backend/shared": "1.7.25",
"@cubejs-backend/cubesql": "1.7.26",
"@cubejs-backend/shared": "1.7.26",
"@cubejs-infra/post-installer": "^0.1.2"
},
"resources": {
Expand Down
6 changes: 6 additions & 0 deletions packages/cubejs-backend-shared/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.26](https://github.com/cube-js/cube/compare/v1.7.25...v1.7.26) (2026-08-24)

### Features

- Queue - support fast track feature ([#11618](https://github.com/cube-js/cube/issues/11618)) ([749e0ab](https://github.com/cube-js/cube/commit/749e0abe7b59db7c2a71a2e781361bf0ce2c3edb))

## [1.7.25](https://github.com/cube-js/cube/compare/v1.7.24...v1.7.25) (2026-08-21)

**Note:** Version bump only for package @cubejs-backend/shared
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.25",
"version": "1.7.26",
"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.25",
"@cubejs-backend/linter": "1.7.26",
"@types/bytes": "^3.1.5",
"@types/cli-progress": "^3.9.1",
"@types/jest": "^29",
Expand Down
1 change: 1 addition & 0 deletions packages/cubejs-backend-shared/src/env.ts
Original file line number Diff line number Diff line change
Expand Up @@ -2025,6 +2025,7 @@ const variables: Record<string, (...args: any) => any> = {
.default('true')
.asBoolStrict(),
queueExternalId: () => get('CUBEJS_QUEUE_EXTERNAL_ID').default('false').asBool(),
queueFastTrack: () => get('CUBEJS_QUEUE_FAST_TRACK').default('false').asBool(),
scheduledRefreshDefault: () => get(
'CUBEJS_SCHEDULED_REFRESH_DEFAULT'
).default('true').asBoolStrict(),
Expand Down
6 changes: 6 additions & 0 deletions packages/cubejs-base-driver/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.26](https://github.com/cube-js/cube/compare/v1.7.25...v1.7.26) (2026-08-24)

### Features

- Queue - support fast track feature ([#11618](https://github.com/cube-js/cube/issues/11618)) ([749e0ab](https://github.com/cube-js/cube/commit/749e0abe7b59db7c2a71a2e781361bf0ce2c3edb))

## [1.7.25](https://github.com/cube-js/cube/compare/v1.7.24...v1.7.25) (2026-08-21)

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