• The hostname for the MS SQL database server
  • The username/password for the MS SQL database server
  • The name of the database to use within the MS SQL database server

Add the following to a .env file in your Cube project:


Environment VariableDescriptionPossible ValuesRequiredSupports multiple data sources?
CUBEJS_DB_HOSTThe host URL for a databaseA valid database host URL
CUBEJS_DB_PORTThe port for the database connectionA valid port number
CUBEJS_DB_NAMEThe name of the database to connect toA valid database name
CUBEJS_DB_USERThe username used to connect to the databaseA valid database username
CUBEJS_DB_PASSThe password used to connect to the databaseA valid database password
CUBEJS_DB_DOMAINA domain name within the database to connect toA valid domain name within a MSSQL database
CUBEJS_DB_SSLIf true, enables SSL encryption for database connections from Cubetrue, false
CUBEJS_CONCURRENCYThe number of concurrent connections each queue has to the database. Default is 2A valid number
CUBEJS_DB_MAX_POOLThe maximum number of concurrent database connections to pool. Default is 8A valid number


Measures of type countDistinctApprox can not be used in pre-aggregations when using MSSQL as a source database.

To learn more about pre-aggregation build strategies, head here.

FeatureWorks with read-only mode?Is default?
Export Bucket--

By default, MSSQL uses a simple strategy to build pre-aggregations.


No extra configuration is required to configure simple pre-aggregation builds for MSSQL.


MSSQL does not support batching.

Export Bucket

MSSQL does not support export buckets.

To enable SSL-encrypted connections between Cube and MS SQL, set the CUBEJS_DB_SSL environment variable to true. For more information on how to configure custom certificates, please check out Enable SSL Connections to the Database.

To connect to a MSSQL database using Windows Authentication (also sometimes known as trustedConnection), instantiate the driver with trustedConnection: true in your cube.js configuration file:

const MssqlDriver = require('@cubejs-backend/mssql-driver');
module.exports = {
  driverFactory: ({ dataSource }) =>
    new MssqlDriver({ database: dataSource, trustedConnection: true }),

Did you find this page useful?