Merge branch 'master' into drill-down-custom-granularities

Author: paco-valdez

.github/workflows/drivers-tests.yml

@@ -241,6 +241,13 @@ jobs:
       # secrets as job-level environment variables, then referencing the environment variables
       # to conditionally run steps in the job.
       DRIVERS_TESTS_ATHENA_CUBEJS_AWS_KEY: ${{ secrets.DRIVERS_TESTS_ATHENA_CUBEJS_AWS_KEY }}
+
+    # redshift Test Serverless Instance is so tiny that it can't serve a few test suites at once,
+    # so we constrain it to 1 test suite at time.
+    concurrency:
+      group: ${{ contains(matrix.database, 'redshift') && 'redshift-global' || format('drivers-tests-{0}-{1}', matrix.database, github.run_id) }}
+      cancel-in-progress: false
+
     strategy:
       matrix:
         database:

.github/workflows/push.yml

@@ -50,6 +50,29 @@ env:
   PYTHON_VERSION_CURRENT: 3.11
 
 jobs:
+  latest-tag-sha:
+    runs-on: ubuntu-24.04
+    outputs:
+      sha: ${{ steps.get-tag.outputs.sha }}
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - id: git-log
+        run: git log HEAD~30..HEAD
+      - id: get-tag-test
+        run: echo "$SHA $(git rev-list -n 1 "$(git tag --contains "$SHA")")"
+        env:
+          SHA: ${{ github.sha }}
+      - id: get-tag
+        run: echo "sha=$(git rev-list -n 1 "$(git tag --contains "$SHA")")" >> "$GITHUB_OUTPUT"
+        env:
+          SHA: ${{ github.sha }}
+      - id: get-tag-out
+        run: echo "$OUT"
+        env:
+          OUT: ${{ steps.get-tag.outputs.sha }}
+
   unit:
     runs-on: ubuntu-24.04
     timeout-minutes: 60
@@ -63,11 +86,8 @@ jobs:
         node-version: [22.x]
         # Don't forget to update build-native-release
         python-version: [3.11]
-        transpile-worker-threads: [false, true]
       fail-fast: false
 
-    env:
-      CUBEJS_TRANSPILATION_WORKER_THREADS: ${{ matrix.transpile-worker-threads }}
     steps:
       - id: get-tag-out
         run: echo "$OUT"
@@ -121,16 +141,16 @@ jobs:
       - name: Lerna test
         run: yarn lerna run --concurrency 1 --stream --no-prefix unit
       - name: Fix lcov paths
-        if: (matrix.node-version == '22.x' && matrix.transpile-worker-threads == true)
+        if: (matrix.node-version == '22.x')
         run: |
           ./.github/actions/codecov-fix.sh
       - name: Combine all fixed LCOV files
-        if: (matrix.node-version == '22.x' && matrix.transpile-worker-threads == true)
+        if: (matrix.node-version == '22.x')
         run: |
           echo "" > ./combined-unit.lcov
           find ./packages -type f -name lcov.fixed.info -exec cat {} + >> ./combined-unit.lcov || true
       - name: Upload coverage artifact
-        if: (matrix.node-version == '22.x' && matrix.transpile-worker-threads == true)
+        if: (matrix.node-version == '22.x')
         uses: actions/upload-artifact@v4
         with:
           name: coverage-unit
@@ -505,7 +525,7 @@ jobs:
       - name: Combine all fixed LCOV files
         run: |
           echo "" > ./combined-integration-${{ matrix.db }}-${{ matrix.use_tesseract_sql_planner }}.lcov
-          find ./packages -type f -name lcov.fixed.info -exec cat {} + >> ./combined-integration-${{ matrix.db }}.lcov || true
+          find ./packages -type f -name lcov.fixed.info -exec cat {} + >> ./combined-integration-${{ matrix.db }}-${{ matrix.use_tesseract_sql_planner }}.lcov || true
       - name: Upload coverage artifact
         uses: actions/upload-artifact@v4
         with:
@@ -598,29 +618,6 @@ jobs:
         env:
           GITHUB_SHA: ${{ github.sha }}
 
-  latest-tag-sha:
-    runs-on: ubuntu-24.04
-    outputs:
-      sha: ${{ steps.get-tag.outputs.sha }}
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-      - id: git-log
-        run: git log HEAD~30..HEAD
-      - id: get-tag-test
-        run: echo "$SHA $(git rev-list -n 1 "$(git tag --contains "$SHA")")"
-        env:
-          SHA: ${{ github.sha }}
-      - id: get-tag
-        run: echo "sha=$(git rev-list -n 1 "$(git tag --contains "$SHA")")" >> "$GITHUB_OUTPUT"
-        env:
-          SHA: ${{ github.sha }}
-      - id: get-tag-out
-        run: echo "$OUT"
-        env:
-          OUT: ${{ steps.get-tag.outputs.sha }}
-
   docker-dev:
     needs: [latest-tag-sha, build-native-linux]
     if: (needs['latest-tag-sha'].outputs.sha != github.sha)

CHANGELOG.md

@@ -3,6 +3,22 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.5.0](https://github.com/cube-js/cube/compare/v1.4.0...v1.5.0) (2025-10-29)
+
+**Note:** Version bump only for package cubejs
+
+# [1.4.0](https://github.com/cube-js/cube/compare/v1.3.86...v1.4.0) (2025-10-29)
+
+### Bug Fixes
+
+- **cubesql:** Always repartition joins when right side has multiple partitions ([#10105](https://github.com/cube-js/cube/issues/10105)) ([ae32748](https://github.com/cube-js/cube/commit/ae327483caabba974e271fb52f4ccc5fd5fa5789))
+
+## [1.3.86](https://github.com/cube-js/cube/compare/v1.3.85...v1.3.86) (2025-10-29)
+
+### Features
+
+- **tesseract:** Bucketing ([#10095](https://github.com/cube-js/cube/issues/10095)) ([2dacac4](https://github.com/cube-js/cube/commit/2dacac406815285a82ee07d125d8519b93be9f4a))
+
 ## [1.3.85](https://github.com/cube-js/cube/compare/v1.3.84...v1.3.85) (2025-10-28)
 
 ### Bug Fixes

README.md

@@ -1,7 +1,4 @@
 ![]()
-<p align="center">
-  <a href="https://cube.registration.goldcast.io/events/a6a3b4b8-a99f-489a-b740-060182dbce7b"><img src="https://lgo0ecceic.ucarecd.net/cd698180-3d96-4644-9c9e-daf299ecf3ea/" alt="Agentic Analytics Summit" width="100%"></a>
-</p>
 <p align="center">
   <a href="https://cube.dev?ref=github-readme"><img src="https://raw.githubusercontent.com/cube-js/cube/master/docs/content/cube-logo-with-bg.png" alt="Cube — Semantic Layer for Data Applications" width="300px"></a>
 </p>

docs/pages/product/apis-integrations/rest-api/query-format.mdx

@@ -34,13 +34,31 @@ The default value is `false`.
 - `offset`: The number of initial rows to be skipped for your query. The default
   value is `0`.
 - `order`: An object, where the keys are measures or dimensions to order by and
-  their corresponding values are either `asc` or `desc`. The order of the fields
-  to order on is based on the order of the keys in the object. If not provided,
-  [default ordering][ref-default-order] is applied. If an empty object (`[]`) is
-  provided, no ordering is applied.
+  their corresponding values are either `asc` or `desc`. For [time dimensions][ref-default-granularities],
+  a granularity can be optionally provided, e.g., `orders.created_at.month`.
+  The order of the fields to order on is based on the order of the keys in the object.
+  If not provided, the [default ordering][ref-default-order] is applied.
+  If an empty object (`[]`) is provided, no ordering is applied.
 - `timezone`: A [time zone][ref-time-zone] for your query. You can set the
 desired time zone in the [TZ Database Name](https://en.wikipedia.org/wiki/Tz_database)
 format, e.g., `America/Los_Angeles`.
+- `renewQuery`: If `renewQuery` is set to `true`, Cube will renew all
+  [`refreshKey`][ref-schema-ref-preaggs-refreshkey] for queries and query
+  results in the foreground. However, if the
+  [`refreshKey`][ref-schema-ref-preaggs-refreshkey] (or
+  [`refreshKey.every`][ref-schema-ref-preaggs-refreshkey-every]) doesn't
+  indicate that there's a need for an update this setting has no effect. The
+  default value is `false`.
+
+<InfoBox>
+
+Cube provides only eventual consistency guarantee. Using a small
+[`refreshKey.every`][ref-schema-ref-preaggs-refreshkey-every] value together
+with `renewQuery` to achieve immediate consistency can lead to endless
+refresh loops and overall system instability.
+
+</InfoBox>
+
 - `ungrouped`: If set to `true`, Cube will run an [ungrouped
 query][ref-ungrouped-query].
 - `joinHints`: Query-time [join hints][ref-join-hints], provided as an array of
@@ -673,4 +691,4 @@ refer to its documentation for more examples.
 [ref-default-granularities]: /product/data-modeling/concepts#time-dimensions
 [ref-custom-granularities]: /product/data-modeling/reference/dimensions#granularities
 [wiki-iso-8601]: https://en.wikipedia.org/wiki/ISO_8601
-[ref-join-hints]: /product/data-modeling/concepts/working-with-joins#join-hints
+[ref-join-hints]: /product/data-modeling/concepts/working-with-joins#join-hints

docs/pages/product/caching/recipes/non-additivity.mdx

@@ -165,8 +165,7 @@ cube(`users`, {
 
 ### Decomposing into a formula with additive measures
 
-Non-additive `avg` measures can be rewritten as
-[calculated measures](/product/data-modeling/reference/measures#calculated-measures)
+Non-additive `avg` measures can be rewritten as [calculated measures][ref-calculated-measures]
 that reference additive measures only. Then, this additive measures can be used
 in pre-aggregations. Please note, however, that you shouldn't include `avg_age`
 measure in your pre-aggregation as it renders it non-additive.
@@ -245,4 +244,5 @@ or run it with the `docker-compose up` command. You'll see the result, including
 queried data, in the console.
 
 
-[ref-percentile-recipe]: /product/data-modeling/recipes/percentiles
+[ref-percentile-recipe]: /product/data-modeling/recipes/percentiles
+[ref-calculated-measures]: /product/data-modeling/concepts/calculated-members#calculated-measures

docs/pages/product/configuration/data-sources/databricks-jdbc.mdx

@@ -52,7 +52,9 @@ docker run -it -p 4000:4000 --env-file=.env cube-jdk
 | `CUBEJS_DB_NAME`                     | The name of the database to connect to                                                          | A valid database name |    ✅    |
 | `CUBEJS_DB_DATABRICKS_URL`           | The URL for a JDBC connection                                                                   | A valid JDBC URL      |    ✅    |
 | `CUBEJS_DB_DATABRICKS_ACCEPT_POLICY` | Whether or not to accept the license terms for the Databricks JDBC driver                       | `true`, `false`       |    ✅    |
-| `CUBEJS_DB_DATABRICKS_TOKEN`         | The [personal access token][databricks-docs-pat] used to authenticate the Databricks connection | A valid token         |    ✅    |
+| `CUBEJS_DB_DATABRICKS_OAUTH_CLIENT_ID` | The OAuth client ID for [service principal][ref-databricks-m2m-oauth] authentication | A valid client ID | ❌ |
+| `CUBEJS_DB_DATABRICKS_OAUTH_CLIENT_SECRET` | The OAuth client secret for [service principal][ref-databricks-m2m-oauth] authentication | A valid client secret | ❌ |
+| `CUBEJS_DB_DATABRICKS_TOKEN`         | The [personal access token][databricks-docs-pat] used to authenticate the Databricks connection | A valid token         |    ❌    |
 | `CUBEJS_DB_DATABRICKS_CATALOG`       | The name of the [Databricks catalog][databricks-catalog] to connect to                                                | A valid catalog name  |    ❌    |
 | `CUBEJS_DB_EXPORT_BUCKET_MOUNT_DIR`  | The path for the [Databricks DBFS mount][databricks-docs-dbfs] (Not needed if using Unity Catalog connection)         | A valid mount path    |    ❌    |
 | `CUBEJS_DB_MAX_POOL`                 | The maximum number of concurrent database connections to pool. Default is `8`                   | A valid number        |    ❌    |
@@ -201,3 +203,4 @@ bucket][self-preaggs-export-bucket] **must be** configured.
 [databricks-docs-approx-agg-fns]: https://docs.databricks.com/en/sql/language-manual/functions/approx_count_distinct.html
 [self-preaggs-simple]: #simple
 [self-preaggs-export-bucket]: #export-bucket
+[ref-databricks-m2m-oauth]: https://docs.databricks.com/aws/en/dev-tools/auth/oauth-m2m

docs/pages/product/configuration/data-sources/duckdb.mdx

@@ -72,8 +72,8 @@ deployment][ref-demo-deployment] in Cube Cloud.
 | `CUBEJS_DB_DUCKDB_S3_USE_SSL`              | Use SSL for connection                                                                                                | A boolean                                                     |    ❌     |
 | `CUBEJS_DB_DUCKDB_S3_URL_STYLE`            | To choose the S3 URL style(vhost or path)                                                                             | `vhost` or `path`                                             |    ❌     |
 | `CUBEJS_DB_DUCKDB_S3_SESSION_TOKEN`        | The token for the S3 session                                                                                          | A valid Session Token                                         |    ❌     |
-| `CUBEJS_DB_DUCKDB_EXTENSIONS`              | A comma-separated list of DuckDB extensions	to install and load                                                       | A comma-separated list of DuckDB extensions                   |    ❌     |
-| `CUBEJS_DB_DUCKDB_COMMUNITY_EXTENSIONS`    | A comma-separated list of DuckDB community extensions	to install and load                                             | A comma-separated list of DuckDB community extensions         |    ❌     |
+| `CUBEJS_DB_DUCKDB_EXTENSIONS`              | A comma-separated list of DuckDB extensions to install and load                                                       | A comma-separated list of DuckDB extensions                   |    ❌     |
+| `CUBEJS_DB_DUCKDB_COMMUNITY_EXTENSIONS`    | A comma-separated list of DuckDB community extensions to install and load                                             | A comma-separated list of DuckDB community extensions         |    ❌     |
 | `CUBEJS_DB_DUCKDB_S3_USE_CREDENTIAL_CHAIN` | A flag to use credentials chain for secrets for S3 connections                                                        | `true`, `false`. Defaults to `false`                          |    ❌     |
 | `CUBEJS_CONCURRENCY`                       | The number of [concurrent queries][ref-data-source-concurrency] to the data source                                    | A valid number                                                |    ❌     |
 

docs/pages/product/configuration/data-sources/presto.mdx

@@ -30,6 +30,7 @@ CUBEJS_DB_SCHEMA=my_presto_schema
 | `CUBEJS_DB_USER`           | The username used to connect to the database                                        | A valid database username                     |    ✅    |
 | `CUBEJS_DB_PASS`           | The password used to connect to the database                                        | A valid database password                     |    ✅    |
 | `CUBEJS_DB_PRESTO_CATALOG` | The catalog within Presto to connect to                                             | A valid catalog name within a Presto database |    ✅    |
+| `CUBEJS_DB_PRESTO_AUTH_TOKEN` | The authentication token to use when connecting to Presto/Trino. It will be sent in the `Authorization` header. | A valid authentication token |    ❌    |
 | `CUBEJS_DB_SCHEMA`         | The schema within the database to connect to                                        | A valid schema name within a Presto database  |    ✅    |
 | `CUBEJS_DB_SSL`            | If `true`, enables SSL encryption for database connections from Cube                | `true`, `false`                               |    ❌    |
 | `CUBEJS_DB_MAX_POOL`       | The maximum number of concurrent database connections to pool. Default is `8`       | A valid number                                |    ❌    |

docs/pages/product/configuration/data-sources/trino.mdx

@@ -30,6 +30,7 @@ CUBEJS_DB_SCHEMA=my_trino_schema
 | `CUBEJS_DB_USER`           | The username used to connect to the database                                        | A valid database username                     |    ✅    |
 | `CUBEJS_DB_PASS`           | The password used to connect to the database                                        | A valid database password                     |    ✅    |
 | `CUBEJS_DB_PRESTO_CATALOG` | The catalog within Presto to connect to                                             | A valid catalog name within a Presto database |    ✅    |
+| `CUBEJS_DB_PRESTO_AUTH_TOKEN` | The authentication token to use when connecting to Presto/Trino. It will be sent in the `Authorization` header. | A valid authentication token |    ❌    |
 | `CUBEJS_DB_SCHEMA`         | The schema within the database to connect to                                        | A valid schema name within a Presto database  |    ✅    |
 | `CUBEJS_DB_SSL`            | If `true`, enables SSL encryption for database connections from Cube                | `true`, `false`                               |    ❌    |
 | `CUBEJS_DB_MAX_POOL`       | The maximum number of concurrent database connections to pool. Default is `8`       | A valid number                                |    ❌    |