摘要：回調(diào)函數(shù)只在連接建立成功或失敗時調(diào)用。如果你愿意的話，可以不傳入回調(diào)函數(shù)，而是監(jiān)聽事件。問題排除如果你在連接數(shù)據(jù)庫的時候遇到了如下錯誤你可以嘗試添加參數(shù)

譯者：飛龍
來源：Connecting to Database

在連接之前，你需要一個受支持的驅(qū)動。下面是一些測試過的驅(qū)動及其版本，把你所需要的加入到package.json中。

[1] 如果你要連接到Heroku，請使用版本2.5.0。

這些是測試過的版本，使用其它的版本（新的或者舊的）帶來的風(fēng)險由你自己承擔(dān)。

例如，使用MySQL要這樣做：

$ npm install --save [email protected]

你可以傳遞一個URL字符串來連接數(shù)據(jù)庫，其中scheme為受支持的驅(qū)動，或者你可以傳遞一個帶有連接參數(shù)的Object。

var orm = require("orm");

orm.connect("mysql://root:password@localhost/test", function(err, db) {
  if (err) return console.error("Connection error: " + err);

  // connected
  // ...
});

回調(diào)函數(shù)只在連接建立成功（或失敗）時調(diào)用。如果你愿意的話，可以不傳入回調(diào)函數(shù)，而是監(jiān)聽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..

可選參數(shù)為：

debug（默認(rèn)為false）：將連接輸出到控制臺；

pool（默認(rèn)為false）：使用驅(qū)動內(nèi)建的組件管理連接池（僅對mysql和postgres有效）；

strdates（默認(rèn)為false）：以字符串形式保存日期（僅對sqlite有效）；

timezone（默認(rèn)為local）：在數(shù)據(jù)庫中使用指定的時區(qū)儲存日期（僅對mysql和postgres有效）；

debug和pool也可以使用settings對象來設(shè)置。

ORM模型受數(shù)據(jù)庫連接約束，所以如果你需要“多租戶”，即連接到不同的服務(wù)器或數(shù)據(jù)庫，你可以使用像下面這樣的方法：

// 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) {
    // ...
  });
});

連接是被緩存的，所以模型在每個服務(wù)器+數(shù)據(jù)庫上面只會定義一次。由于我們使用了連接池，我們并不需要擔(dān)心用完所有的連接，而且我們可以一次性執(zhí)行多個查詢。

如果你在連接MySQL數(shù)據(jù)庫的時候遇到了如下錯誤：

Error: connect ECONNREFUSED
    at errnoException (net.js:670:11)
    at Object.afterConnect [as oncomplete] (net.js:661:19)

你可以嘗試添加socketPath參數(shù)：

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}
});