sails.config.connections

What is this?

Adapters are the middle man between your Sails app and some kind of storage (typically a database)

Adapters are configured in the connections.js file located in your project’s config directory. Here you can create different global “saved settings” that you can mix and match in your models.

Sails adapters have been written for a variety of popular databases such as MySQL, Postgres and Mongo. You can find a list of supported adapters here.

Example

To use the sails-memory adapter (for DEVELOPMENT ONLY), first install the module with npm install sails-memory, then define it in connections.js:

Here is an example adapter configuration file

myApp/config/connections.js

  2. module.exports.connections = {
  3.   // sails-disk is installed by default.
  4.   localDiskDb: {
  5.     adapter: 'sails-disk'
  6.   },
  7.   memory: {
  8.     adapter: 'sails-memory'
  9.   }
  10. };

If you wanted to set memory as the default adapter for your models, you would do this. myApp/config/models.js

  1. module.exports.models = {
  3.   connection: 'memory'
  4. };

Keep in mind that options you define directly in your model definitions will override these settings. Prior to v0.11, adapters were defined in myApp/config/Adapters.js. See v0.9 docs for more info.

Multiple connections for an adapter

You can set up more than one connection using the same adapter. For example, if you had two mysql databases, you could configure them as:

  2. module.exports.connections = {
  3.   localMysql: {
  4.     adapter: 'sails-mysql',
  5.     user: 'root',
  6.     host: 'localhost',
  7.     database: 'someDbase'
  8.   },
  9.   remoteMysql: {
  10.     adapter: 'sails-mysql',
  11.     user: 'remoteUser',
  12.     password: 'remotePassword',
  13.     host: 'http://remote-mysql-host.com',
  14.     database: 'remoteDbase'
  15.   }
  16. };

Note If any connection to an adapter is used by a model, then all connections to that adapter will be loaded on sails.lift, whether or not models are actually using them. In the example above, if a model was configured to use the localMysql connection, then both localMysql and remoteMysql would attempt to connect at run time. It is therefore good practice to comment out any connection configurations that you aren’t using!