cube-js/cube · error

cubeStoreDriverFactory is a required option for Cube Store q

Error message

cubeStoreDriverFactory is a required option for Cube Store queue driver

What it means

A startup validation guard in factoryQueueDriver: selecting the 'cubestore' queue driver requires a cubeStoreDriverFactory in queueDriverOptions to create the CubeStore-backed queue driver; it was missing or null. Like the QueryCache counterpart, this fails fast during queue construction. The input at fault is queue driver options lacking cubeStoreDriverFactory while cacheAndQueueDriver is 'cubestore'.

Source

Thrown at packages/cubejs-query-orchestrator/src/orchestrator/QueryQueue.ts:70

  processUid?: string;
  concurrency?: number,
  continueWaitTimeout?: number,
  executionTimeout?: number,
  orphanedTimeout?: number,
  heartBeatInterval?: number,
  redisPool?: any,
  cubeStoreDriverFactory?: any,
  queueDriverFactory?: (cacheAndQueueDriver: string, queueDriverOptions: any) => QueueDriverInterface,
  skipQueue?: boolean,
};

function factoryQueueDriver(cacheAndQueueDriver: string, queueDriverOptions): QueueDriverInterface {
  switch (cacheAndQueueDriver || 'memory') {
    case 'memory':
      return new LocalQueueDriver(queueDriverOptions);
    case 'cubestore':
      if (!queueDriverOptions.cubeStoreDriverFactory) {
        throw new Error('cubeStoreDriverFactory is a required option for Cube Store queue driver');
      }

      return new CubeStoreQueueDriver(
        queueDriverOptions.cubeStoreDriverFactory,
        queueDriverOptions
      );
    default:
      throw new Error(`Unknown queue driver: ${cacheAndQueueDriver}`);
  }
}

export class QueryQueue {
  protected concurrency: number;

  protected continueWaitTimeout: number;

  protected executionTimeout: number;

View on GitHub (pinned to 7d981676b3)

Solutions

1. Pass cubeStoreDriverFactory in queueDriverOptions when cacheAndQueueDriver is 'cubestore' — normally wired by QueryOrchestrator from CUBEJS_CUBESTORE_HOST/PORT
2. Set CUBEJS_CUBESTORE_HOST and CUBEJS_CUBESTORE_PORT so the factory is constructed
3. Use 'memory' queue driver if Cube Store is not deployed

When it happens

Trigger: Thrown at packages/cubejs-query-orchestrator/src/orchestrator/QueryQueue.ts:70 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/a119b5034929f0cd. Report an issue: GitHub.