cube-js/cube · error

Export bucket is not configured.

Error message

Export bucket is not configured.

What it means

Thrown by unload when it is called to export pre-aggregation data although config.exportBucket is undefined — i.e. isUnloadSupported() would return false because no export bucket was configured for this driver instance.

Source

Thrown at packages/cubejs-snowflake-driver/src/SnowflakeDriver.ts:544

  }

  /**
   * Determines whether export bucket feature is configured or not.
   */
  public async isUnloadSupported() {
    return this.config.exportBucket !== undefined;
  }

  /**
   * Returns to the Cubestore an object with links to unloaded to the
   * export bucket data.
   */
  public async unload(
    tableName: string,
    options: UnloadOptions,
  ): Promise<DownloadTableCSVData> {
    if (!this.config.exportBucket) {
      throw new Error('Export bucket is not configured.');
    }
    if (!SUPPORTED_BUCKET_TYPES.includes(this.config.exportBucket.bucketType as string)) {
      throw new Error(`Unsupported export bucket type: ${
        this.config.exportBucket.bucketType
      }`);
    }

    const { types, exportedCount } = options.query
      ? await this.unloadWithSql(tableName, options)
      : await this.unloadWithTable(tableName, options);
    // Snowflake doesn't produce csv files if no data is exported (no data rows)
    // so it's important not to call getCsvFiles(), because it checks for empty files list
    // and throws an error.
    const csvFile = exportedCount > 0 ? await this.getCsvFiles(tableName) : [];

    return {
      exportBucketCsvEscapeSymbol: this.config.exportBucketCsvEscapeSymbol,
      csvFile,

View on GitHub (pinned to 7d981676b3)

Solutions

1. Configure an export bucket via CUBEJS_DB_EXPORT_BUCKET_TYPE and the related CUBEJS_DB_EXPORT_BUCKET_* variables
2. Check that getExportBucket returns a valid bucket at driver construction instead of undefined
3. Ensure external pre-aggregations are only enabled when the export bucket is actually configured

When it happens

Trigger: Thrown at packages/cubejs-snowflake-driver/src/SnowflakeDriver.ts:544 when the library encounters an invalid state.

Common situations: See trigger scenarios.

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