cube-js/cube · warning

The CUBEJS_DB_BQ_EXPORT_BUCKET is deprecated. Please, use th

Error message

The CUBEJS_DB_BQ_EXPORT_BUCKET is deprecated. Please, use the CUBEJS_DB_EXPORT_BUCKET instead.

What it means

The BigQuery export bucket variable CUBEJS_DB_BQ_EXPORT_BUCKET was superseded by the generic CUBEJS_DB_EXPORT_BUCKET, which works across drivers. Reading the deprecated var triggers this warning; the value is still returned.

Source

Thrown at packages/cubejs-backend-shared/src/env.ts:1269

  /**
   * BigQuery location.
   */
  bigqueryLocation: ({
    dataSource,
    preAggregations,
  }: DataSourceOpts) => (
    get(keyByDataSource('CUBEJS_DB_BQ_LOCATION', dataSource, preAggregations)).asString()
  ),

  /**
   * BigQuery export bucket.
   * @deprecated
   */
  bigqueryExportBucket: ({
    dataSource,
    preAggregations,
  }: DataSourceOpts) => {
    console.warn(
      'The CUBEJS_DB_BQ_EXPORT_BUCKET is deprecated. ' +
      'Please, use the CUBEJS_DB_EXPORT_BUCKET instead.'
    );
    return get(keyByDataSource('CUBEJS_DB_BQ_EXPORT_BUCKET', dataSource, preAggregations)).asString();
  },

  /** ****************************************************************
   * ClickHouse Driver                                               *
   ***************************************************************** */

  /**
   * ClickHouse read only flag.
   */
  clickhouseReadOnly: ({
    dataSource,
    preAggregations,
  }: DataSourceOpts) => (
    get(keyByDataSource('CUBEJS_DB_CLICKHOUSE_READONLY', dataSource, preAggregations))

View on GitHub (pinned to 7d981676b3)

Solutions

1. Set CUBEJS_DB_EXPORT_BUCKET instead of CUBEJS_DB_BQ_EXPORT_BUCKET
2. Remove the deprecated variable once the new one is confirmed
3. Re-run export-based pre-aggregations to verify uploads still target the expected bucket

Example fix

// before
CUBEJS_DB_BQ_EXPORT_BUCKET=my-export-bucket
// after
CUBEJS_DB_EXPORT_BUCKET=my-export-bucket

if (process.env.CUBEJS_DB_BQ_EXPORT_BUCKET) console.warn('Use CUBEJS_DB_EXPORT_BUCKET instead of deprecated CUBEJS_DB_BQ_EXPORT_BUCKET');

When it happens

Trigger: bigqueryExportBucket env accessor is called (during BigQuery pre-aggregation export configuration) and CUBEJS_DB_BQ_EXPORT_BUCKET is set in the environment.

Common situations: Older BigQuery pre-aggregation export setups upgraded to newer Cube; docs/configs from before the unified export-bucket variable existed.

Related errors

• Worker thread transpilation is enabled by default and cannot
• The ${keyByDataSource('CUBEJS_DB_SCHEMA', dataSource)} is de
• The ${keyByDataSource('CUBEJS_DATABASE', dataSource)} is dep
• The CUBEJS_DB_CATALOG is deprecated. Please, use the CUBEJS_
• No job description provided

AI-assisted analysis of cube-js/cube@7d981676b3 (2026-09-02). Data as JSON: /api/errors/1d7e801241a8d97e. Report an issue: GitHub.