# 連接到數據庫
> 譯者:[飛龍](https://github.com/wizardforcel)
> 來源:[Connecting to Database](https://github.com/dresende/node-orm2/wiki/Connecting-to-Database)
在連接之前,你需要一個受支持的驅動。下面是一些測試過的驅動及其版本,把你所需要的加入到`package.json`中。
| 驅動 | npm 包 | 版本 |
| --- | --- | --- |
| mysql | mysql | 2.0.0-alpha9 |
| postgres<br />redshift | pg | 2.6.2 \[1\] |
| sqlite | sqlite3 | 2.1.7 |
| mongodb | mongodb | 1.3.19 |
\[1\] 如果你要連接到**Heroku**,請使用版本**2.5.0**。
這些是測試過的版本,使用其它的版本(新的或者舊的)帶來的風險由你自己承擔。
例如,使用MySQL要這樣做:
```
$ npm install --save mysql@2.0.0-alpha8
```
你可以傳遞一個URL字符串來連接數據庫,其中scheme為受支持的驅動,或者你可以傳遞一個帶有連接參數的`Object`。
```
var orm = require('orm');
orm.connect('mysql://root:password@localhost/test', function(err, db) {
if (err) return console.error('Connection error: ' + err);
// connected
// ...
});
```
回調函數只在連接建立成功(或失敗)時調用。如果你愿意的話,可以不傳入回調函數,而是監聽`connect`事件。
```
var orm = require('orm');
var db = orm.connect('mysql://root:password@localhost/test');
db.on('connect', function(err) {
if (err) return console.error('Connection error: ' + err);
// connected
// ...
});
```
連接URL遵循下面的語法:`driver://username:password@hostname/database?option1=value1&option2=value2..`
可選參數為:
+ `debug`(默認為`false`):將連接輸出到控制臺;
+ `pool`(默認為`false`):使用驅動內建的組件管理連接池(僅對`mysql`和`postgres`有效);
+ `strdates`(默認為`false`):以字符串形式保存日期(僅對`sqlite`有效);
+ `timezone`(默認為`local`):在數據庫中使用指定的時區儲存日期(僅對`mysql`和`postgres`有效);
`debug`和`pool`也可以使用`settings`對象來[設置](2. Settings.md)。
## 連接到多個數據庫
ORM模型受數據庫連接約束,所以如果你需要“多租戶”,即連接到不同的服務器或數據庫,你可以使用像下面這樣的方法:
```
// db.js
var connections = {};
function setup(db) {
var User = db.define('user', ...);
var Shirt = db.define('shirt', ...);
Shirt.hasOne('user', User, ...);
}
module.exports = function(host, database, cb) {
if (connections[host] && connections[host][database]) {
return connections[host][database];
}
var opts = {
host: host,
database: database,
protocol: 'mysql',
port: '3306',
query: {pool: true}
};
orm.connect(opts, function(err, db) {
if (err) return cb(err);
connections[host] = connections[host] || {};
connections[host][database] = db;
setup(db);
cb(null, db);
});
};
// somewhere else, eg, middleware
var database = require('./db');
database('dbserver1', 'main', function(err, db) {
if (err) throw err;
db.models.user.find({foo: 'bar'}, function(err, rows) {
// ...
});
});
```
連接是被緩存的,所以模型在每個服務器+數據庫上面只會定義一次。由于我們使用了連接池,我們并不需要擔心用完所有的連接,而且我們可以一次性執行多個查詢。
## 問題排除
如果你在連接MySQL數據庫的時候遇到了如下錯誤:
```
Error: connect ECONNREFUSED
at errnoException (net.js:670:11)
at Object.afterConnect [as oncomplete] (net.js:661:19)
```
你可以嘗試添加`socketPath`參數:
```
var db = orm.connect({
host: 'localhost',
database: 'database',
user: 'user',
password: 'pass',
protocol: 'mysql',
socketPath: '/var/run/mysqld/mysqld.sock',
port: '3306',
query: {pool: true, debug: true}
});
```