cube-js/cube · error

Unknown queue driver: ${cacheAndQueueDriver}

Error message

Unknown queue driver: ${cacheAndQueueDriver}

What it means

The default branch of factoryQueueDriver's switch: the cacheAndQueueDriver value is neither 'memory' nor 'cubestore', so no queue driver implementation exists for it. This is fail-fast validation of the queue driver name at orchestrator startup. The input at fault is an unknown/unmisspelled cacheAndQueueDriver string.

Source

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

  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;

  protected orphanedTimeout: number;

  protected heartBeatInterval: number;

  protected readonly sendProcessMessageFn: SendProcessMessageFn;

  protected readonly sendCancelMessageFn: SendCancelMessageFn;

View on GitHub (pinned to 7d981676b3)

Solutions

1. Set cacheAndQueueDriver to 'memory' or 'cubestore' — the only implemented queue drivers
2. Fix typos in CUBEJS_CACHE_AND_QUEUE_DRIVER or the orchestrator options
3. Add a new case returning a custom QueueDriverInterface if you extend factoryQueueDriver

When it happens

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