Node.js/Sails.jsでのMongoDBの使用

Sailsは、MongoDBデータベースをsails-mongoアダプターを介してサポートしています。

まず、開発マシンまたはクラウドで実行中のMongoDBサーバーにアクセスできることを確認してください。以下では、'mongodb://root@localhost/foo'は、データベース名として「foo」を使用するローカルにインストールされたMongoDBを指します。その接続URLをデータベースに適切な文字列に置き換えてください。

MongoDBを使用したローカルでの開発

開発中にNode.js/SailsアプリケーションでMongoDBを使用するには

1. アプリケーションフォルダーでnpm install sails-mongoを実行します。

2. config/datastores.jsファイルで、defaultデータストア設定を編集します。

   default: {
      adapter: 'sails-mongo',
      url: 'mongodb://root@localhost/foo'
    }
   

3. config/models.jsファイルで、デフォルトのid属性を編集して、MongoDBのプライマリキーに適切なtypeとcolumnNameを設定します。

   attributes: {
      id: { type: 'string', columnName: '_id' },
      //…
    }
   

これで完了です！ アプリケーションを再び起動すれば、準備完了です。

大文字と小文字の区別

プロジェクトをMongoDBを使用するように設定した後、Waterlineのクエリがデフォルトで大文字と小文字を区別するようになったことに気付くかもしれません。大文字と小文字を区別しないクエリを実行するには、.meta({makeLikeModifierCaseInsensitive: true})を使用できます。

MongoDBを使用したアプリケーションのデプロイ

本番環境でMongoDBを使用するには、config/env/production.jsのアダプター設定を編集します。

adapter: 'sails-mongo',

接続URLも設定できますが、多くの開発者は機密性の高い認証情報をバージョン管理にチェックインしないことを好みます。別のオプションは、環境変数を使用することです。

sails_datastores__default__url=mongodb://heroku_12345678:[email protected]:29017/heroku_12345678

ステージング環境でMongoDBを使用するには、config/env/staging.jsを編集します。アプリケーションによっては、ステージングデータベースの認証情報はセキュリティリスクが低いため、バージョン管理にチェックインすることが許容される場合があります。

低レベルのMongoDBの使用（上級）

すべてのSailsデータベースアダプターと同様に、sails-mongoを使用する場合、Waterlineモデルメソッドを使用してモデルを操作できます。

多くのアプリケーションでは、それがすべてです。「hello world」から本番環境まで。制限に遭遇した場合でも、通常はMongo固有のコードを記述することなく回避できます。ただし、代替手段がない場合は、SailsアプリケーションでMongoドライバーを直接使用することが可能です。

低レベルの「ネイティブ」MongoDBクライアントに直接アクセスするには、データストアインスタンスの.managerプロパティを使用します。

sails-mongo v2.0.0以降、manager.clientを介してMongoClientオブジェクトにアクセスできます。これにより、ClientSessionなどの最新のMongoDBの改善点や、トランザクション、変更ストリーム、その他の新しい機能にアクセスできます。

var mongoClient = Pet.getDatastore().manager.client;

var results = await mongoClient.db('test')
.collection('pet')
.find({}, { name: 1 })
.toArray();

console.log(results);

ネイティブMongoDBクライアントで使用可能なメソッドの完全なリストについては、Node.js MongoDBドライバーAPIリファレンスを参照してください。