Datastores represent the data sources configured for your app. A datastore usually represents a particular database; whether that's a database running within a locally installed MySQL server, a remote PostgreSQL database running in your company's data center, or a remote MongoDB database hosted by a cloud provider.
Datastores are configured in
Sails apps start out with an implicit datastore which is used by all of your models by default. For many apps, this is sufficient-- but if you are building an app that needs to work with multiple databases, you may also find it helpful to configure additional, named datastores like
Every model in a Sails app is wired up to a particular datastore-- so every time you call a built-in model method, the model communicates with its configured datastore implicitly.
But sometimes, it's helpful to be able to communicate with a datastore outside of the context of any particular model. So, when your app lifts, Sails automatically instantiates objects called registered datastore instances for each of your configured datastores. To access one of these at runtime, call either
sails.getDatastore() or the
.getDatastore() model method.
Registered datastores expose some methods and properties of their own, like
.manager, which provide an easy way to talk directly to the underlying database. (The rest of the pages in this section of the documentation are devoted to covering these datastore methods and properties in detail.)