Mongodb-mongodb/node-mongodb-native-行业智能，新时代，新科技，新码农

<p> <a href="https://nodei.co/npm/mongodb/"> <img src="https://nodei.co/npm/mongodb.png?downloads=true&downloadRank=true" alt="npm" /> </a> <a href="https://nodei.co/npm/mongodb/"> <img src="https://nodei.co/npm-dl/mongodb.png?months=6&height=3" alt="npm" /> </a> </p>
 <p> <a href="http://travis-ci.org/mongodb/node-mongodb-native"> <img src="https://secure.travis-ci.org/mongodb/node-mongodb-native.svg?branch=2.1" alt="Build Status" /> </a> <a href="https://coveralls.io/github/mongodb/node-mongodb-native?branch=2.1"> <img src="https://coveralls.io/repos/github/mongodb/node-mongodb-native/badge.svg?branch=2.1" alt="Coverage Status" /> </a> <a href="https://gitter.im/mongodb/node-mongodb-native?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge"> <img src="https://badges.gitter.im/Join%20Chat.svg" alt="Gitter" /> </a> </p>
 <h1>描述</h1>
 <p>用于Node.js的官方<a href="https://www.mongodb.com/"> MongoDB </a>驱动程序。在<a href="https://www.npmjs.com/package/mongodb-core"> mongodb-core </a>之上提供高级API，适用于最终用户。 </p>
 <p> <strong>注意：最近发布了v3.x，其中包含重大的API更改。你可以在这里找到更改列表<a href="CHANGES_3.0.0.md"> </a>。 </strong> </p>
 <h2> MongoDB Node.JS驱动程序</h2>
 <table>
 <thead>
 <tr> <th>什么</th> <th>其中</th> </tr>
 </thead>
 <tbody>
 <tr> <td>文档</td> <td> http://mongodb.github.io/node-mongodb-native </td> </tr>
 <tr> <td> api-doc </td> <td> http://mongodb.github.io/node-mongodb-native/3.1/api </td> </tr>
 <tr> <td>来源</td> <td> https://github.com/mongodb/node-mongodb-native </td> </tr>
 <tr> <td> mongodb </td> <td> http://www.mongodb.org </td> </tr>
 </tbody>
 </table>
 <h3>错误/功能请求</h3>
 <p>认为你发现了一个错误？想要在<code>node-mongodb-native</code>中看到新功能？请在我们的问题管理工具JIRA：</p>中打开一个案例
 <ul>
 <li>创建一个帐户并登录<a href="https://jira.mongodb.org"> jira.mongodb.org </a>。 </li>
 <li>导航到NODE项目<a href="https://jira.mongodb.org/browse/NODE"> jira.mongodb.org/browse/NODE </a>。 </li>
 <li>单击<strong>创建第</strong>期 - 请提供尽可能多的有关问题类型以及如何重现问题的信息。 </li>
 </ul>
 <p> JIRA中针对所有驱动程序项目（即NODE，PYTHON，CSHARP，JAVA）和核心服务器（即SERVER）项目的错误报告是<strong> public </strong>。 </p>
 <h3>支持/反馈</h3>
 <p>有关Node.js驱动程序的问题，疑问或反馈，请查看我们的<a href="http://www.mongodb.org/about/support">支持渠道</a>。请不要直接向任何驱动程序开发人员发送问题或问题 - 您更有可能在Google网上论坛上的<a href="http://groups.google.com/group/mongodb-user>"> mongodb-user </a>列表中获得答案。 </p>
 <h3>更改日志</h3>
 <p>更改历史记录可以在<a href="HISTORY.md"> <code>HISTORY.md</code> </a>中找到。 </p>
 <h3>兼容性</h3>
 <p>有关版本兼容性矩阵，请参阅以下链接：</p>
 <ul>
 <li> <a href="https://docs.mongodb.com/ecosystem/drivers/driver-compatibility-reference/#reference-compatibility-mongodb-node"> MongoDB </a> </li>
 <li> <a href="https://docs.mongodb.com/ecosystem/drivers/driver-compatibility-reference/#reference-compatibility-language-node"> NodeJS </a> </li>
 </ul>
 <h1>安装</h1>
 <p>开始使用Node.js 3.0驱动程序的推荐方法是使用<code>npm</code>（节点包管理器）在项目中安装依赖项。 </p>
 <h2> MongoDB驱动程序</h2>
 <p>鉴于您已使用<code>npm init</code>创建了自己的项目，我们通过执行以下<code>npm</code>命令来安装MongoDB驱动程序及其依赖项。 </p>
 <pre><code class="language-bash">npm install mongodb --save
</code></pre>
 <p>这将下载MongoDB驱动程序并在您的<code>package.json</code>文件中添加依赖项。 </p>
 <p>您也可以使用<a href="https://yarnpkg.com/en"> Yarn </a>包管理器。 </p>
 <h2>故障排除</h2>
 <p> MongoDB驱动程序依赖于其他几个软件包。这些是：</p>
 <ul>
 <li> <a href="https://github.com/mongodb-js/mongodb-core"> mongodb-core </a> </li>
 <li> <a href="https://github.com/mongodb/js-bson"> bson </a> </li>
 <li> <a href="https://github.com/mongodb-js/kerberos"> kerberos </a> </li>
 <li> <a href="https://github.com/nodejs/node-gyp"> node-gyp </a> </li>
 </ul>
 <p> <code>kerberos</code>程序包是C ++扩展，需要在系统上安装构建环境。您必须能够自己构建Node.js才能编译和安装<code>kerberos</code>模块。此外，<code>kerberos</code>模块需要MIT Kerberos包才能在UNIX操作系统上正确编译。有关要安装的库，请咨询UNIX操作系统包管理器。 </p>
 <p> <strong> Windows已包含用于Kerberos身份验证的SSPI API。但是，您需要使用Visual Studio C ++安装完整的编译器工具链才能正确安装Kerberos扩展。 </strong> </p>
 <h3>在UNIX </h3>上进行诊断
 <p>如果您没有build-essentials，则不会构建此模块。对于Linux，你需要gcc，g ++，Node.js以及所有头文件和Python。找出缺少的最简单的方法是尝试构建Kerberos项目。您可以通过执行以下步骤来执行此操作。 </p>
 <pre><code class="language-bash">git clone https://github.com/mongodb-js/kerberos
cd kerberos
npm install
</code></pre>
 <p>如果完成所有步骤，则表明您已安装正确的工具链。如果您收到错误“node-gyp not found，”您需要在全球范围内安装<code>node-gyp</code>：</p>
 <pre><code class="language-bash">npm install -g node-gyp
</code></pre>
 <p>如果它正确编译并运行测试你是金色的。我们现在可以尝试通过执行以下命令安装<code>mongod</code>驱动程序。 </p>
 <pre><code class="language-bash">cd yourproject
npm install mongodb --save
</code></pre>
 <p>如果仍然失败，则下一步是检查npm日志。重新运行命令，但在这种情况下是详细模式。 </p>
 <pre><code class="language-bash">npm --loglevel verbose install mongodb
</code></pre>
 <p>这将打印出在尝试安装模块时npm正在执行的所有步骤。 </p>
 <h3>在Windows </h3>上进行诊断
 <p>已知用于在Windows上编译<code>kerberos</code>的编译器工具链如下所示。 </p>
 <ul>
 <li> Visual Studio C ++ 2010（不要使用更高版本）</li>
 <li> Windows 7 64位SDK </li>
 <li> Python 2.7或更高版本</li>
 </ul>
 <p>打开Visual Studio命令提示符。确保<code>node.exe</code>在您的路径中并安装<code>node-gyp</code>。 </p>
 <pre><code class="language-bash">npm install -g node-gyp
</code></pre>
 <p>接下来，您必须手动构建项目以对其进行测试。克隆存储库，安装依赖项并重建：</p>
 <pre><code class="language-bash">git clone https://github.com/christkv/kerberos.git
cd kerberos
npm install
node-gyp rebuild
</code></pre>
 <p>如果您已正确设置所有内容，则应成功重建驱动程序。 </p>
 <h3>其他可能的问题</h3>
 <p>您的Python安装可能需要进行gyp break。首先通过尝试在有问题的服务器上构建Node.js来测试您的部署环境，因为这应该能够解决破坏软件包的任何问题（并且有很多破解的软件包）。 </p>
 <p>另一个提示是确保您的用户具有对安装Node.js模块的任何位置的写入权限。 </p>
 <h2>快速入门</h2>
 <p>本指南将向您展示如何使用Node.js和MongoDB设置简单的应用程序。它的范围只是如何设置驱动程序和执行简单的CRUD操作。有关更深入的报道，请参阅<a href="docs/reference/content/tutorials/main.md">教程</a>。 </p>
 <h3>创建<code>package.json</code>文件</h3>
 <p>首先，创建一个应用程序所在的目录。 </p>
 <pre><code class="language-bash">mkdir myproject
cd myproject
</code></pre>
 <p>输入以下命令并回答问题以创建新项目的初始结构：</p>
 <pre><code class="language-bash">npm init
</code></pre>
 <p>接下来，安装驱动程序依赖项。 </p>
 <pre><code class="language-bash">npm install mongodb --save
</code></pre>
 <p>您应该看到<strong> NPM </strong>下载了大量文件。完成后，您将在<strong> node_modules </strong>目录下找到所有下载的软件包。 </p>
 <h3>启动MongoDB Server </h3>
 <p>有关完整的MongoDB安装说明，请参见<a href="https://docs.mongodb.org/manual/installation/">手册</a>。 </p>
 <ol>
 <li>从<a href="https://www.mongodb.org/downloads">下载右侧MongoDB版本MongoDB </a> </li>
 <li>创建数据库目录（在本例中为<strong> / data </strong>）。 </li>
 <li>安装并启动<code>mongod</code>进程。 </li>
 </ol>
 <pre><code class="language-bash">mongod --dbpath=/data
</code></pre>
 <p>您应该看到<strong> mongod </strong>进程启动并打印一些状态信息。 </p>
 <h3>连接到MongoDB </h3>
 <p>创建一个新的<strong> app.js </strong>文件并添加以下代码以使用MongoDB驱动程序尝试一些基本的CRUD操作。 </p>
 <p>添加代码以连接到服务器和数据库<strong> myproject </strong>：</p>
 <pre><code class="language-js">const MongoClient = require('mongodb').MongoClient;
const assert = require('assert');

// Connection URL
const url = 'mongodb://localhost:27017';

// Database Name
const dbName = 'myproject';

// Use connect method to connect to the server
MongoClient.connect(url, function(err, client) {
  assert.equal(null, err);
  console.log("Connected successfully to server");

const db = client.db(dbName);

client.close();
});
</code></pre>
 <p>从命令行运行您的应用程序：</p>
 <pre><code class="language-bash">node app.js
</code></pre>
 <p>应用程序应将<strong>已成功连接到服务器</strong>连接到控制台。 </p>
 <h3>插入文档</h3>
 <p>添加到<strong> app.js </strong>以下函数使用<strong> insertMany </strong>方法将3个文档添加到<strong>文档</strong>集合中。 </p>
 <pre><code class="language-js">const insertDocuments = function(db, callback) {
  // Get the documents collection
  const collection = db.collection('documents');
  // Insert some documents
  collection.insertMany([
    {a : 1}, {a : 2}, {a : 3}
  ], function(err, result) {
    assert.equal(err, null);
    assert.equal(3, result.result.n);
    assert.equal(3, result.ops.length);
    console.log("Inserted 3 documents into the collection");
    callback(result);
  });
}
</code></pre>
 <p> <strong> insert </strong>命令返回包含以下字段的对象：</p>
 <ul>
 <li> <strong>结果</strong>包含来自MongoDB </li>的结果文档
 <li> <strong> ops </strong>包含插入的文件，添加了<strong> _id </strong>字段</li>
 <li> <strong>连接</strong>包含用于执行插入的连接</li>
 </ul>
 <p>添加以下代码以调用<strong> insertDocuments </strong>函数：</p>
 <pre><code class="language-js">const MongoClient = require('mongodb').MongoClient;
const assert = require('assert');

// Connection URL
const url = 'mongodb://localhost:27017';

// Database Name
const dbName = 'myproject';

// Use connect method to connect to the server
MongoClient.connect(url, function(err, client) {
  assert.equal(null, err);
  console.log("Connected successfully to server");

const db = client.db(dbName);

insertDocuments(db, function() {
    client.close();
  });
});
</code></pre>
 <p>运行更新的<strong> app.js </strong>文件：</p>
 <pre><code class="language-bash">node app.js
</code></pre>
 <p>该操作返回以下输出：</p>
 <pre><code class="language-bash">Connected successfully to server
Inserted 3 documents into the collection
</code></pre>
 <h3>查找所有文档</h3>
 <p>添加一个返回所有文档的查询。 </p>
 <pre><code class="language-js">const findDocuments = function(db, callback) {
  // Get the documents collection
  const collection = db.collection('documents');
  // Find some documents
  collection.find({}).toArray(function(err, docs) {
    assert.equal(err, null);
    console.log("Found the following records");
    console.log(docs)
    callback(docs);
  });
}
</code></pre>
 <p>此查询返回<strong>文档</strong>集合中的所有文档。将<strong> findDocument </strong>方法添加到<strong> MongoClient.connect </strong>回调：</p>
 <pre><code class="language-js">const MongoClient = require('mongodb').MongoClient;
const assert = require('assert');

// Connection URL
const url = 'mongodb://localhost:27017';

// Database Name
const dbName = 'myproject';

// Use connect method to connect to the server
MongoClient.connect(url, function(err, client) {
  assert.equal(null, err);
  console.log("Connected correctly to server");

const db = client.db(dbName);

insertDocuments(db, function() {
    findDocuments(db, function() {
      client.close();
    });
  });
});
</code></pre>
 <h3>使用查询过滤器查找文档</h3>
 <p>添加查询过滤器以仅查找符合查询条件的文档。 </p>
 <pre><code class="language-js">const findDocuments = function(db, callback) {
  // Get the documents collection
  const collection = db.collection('documents');
  // Find some documents
  collection.find({'a': 3}).toArray(function(err, docs) {
    assert.equal(err, null);
    console.log("Found the following records");
    console.log(docs);
    callback(docs);
  });
}
</code></pre>
 <p>只应返回与<code>'a' : 3</code>匹配的文档。 </p><h3>更新文档</h3>
 <p>以下操作更新<strong>文档</strong>集合中的文档。 </p>
 <pre><code class="language-js">const updateDocument = function(db, callback) {
  // Get the documents collection
  const collection = db.collection('documents');
  // Update document where a is 2, set b equal to 1
  collection.updateOne({ a : 2 }
    , { $set: { b : 1 } }, function(err, result) {
    assert.equal(err, null);
    assert.equal(1, result.result.n);
    console.log("Updated the document with the field a equal to 2");
    callback(result);
  });
}
</code></pre>
 <p>该方法通过向设置为<strong> 1 </strong>的文档添加新字段<strong> b </strong>来更新字段<strong> a </strong>等于<strong> 2 </strong>的第一个文档。接下来，从<strong> MongoClient.connect </strong>更新回调函数以包含更新方法。 </p>
 <pre><code class="language-js">const MongoClient = require('mongodb').MongoClient;
const assert = require('assert');

// Connection URL
const url = 'mongodb://localhost:27017';

// Database Name
const dbName = 'myproject';

// Use connect method to connect to the server
MongoClient.connect(url, function(err, client) {
  assert.equal(null, err);
  console.log("Connected successfully to server");

const db = client.db(dbName);

insertDocuments(db, function() {
    updateDocument(db, function() {
      client.close();
    });
  });
});
</code></pre>
 <h3>删除文档</h3>
 <p>删除字段<strong> a </strong>等于<strong> 3 </strong>的文档。 </p>
 <pre><code class="language-js">const removeDocument = function(db, callback) {
  // Get the documents collection
  const collection = db.collection('documents');
  // Delete document where a is 3
  collection.deleteOne({ a : 3 }, function(err, result) {
    assert.equal(err, null);
    assert.equal(1, result.result.n);
    console.log("Removed the document with the field a equal to 3");
    callback(result);
  });
}
</code></pre>
 <p>将新方法添加到<strong> MongoClient.connect </strong>回调函数。 </p>
 <pre><code class="language-js">const MongoClient = require('mongodb').MongoClient;
const assert = require('assert');

// Connection URL
const url = 'mongodb://localhost:27017';

// Database Name
const dbName = 'myproject';

// Use connect method to connect to the server
MongoClient.connect(url, function(err, client) {
  assert.equal(null, err);
  console.log("Connected successfully to server");

const db = client.db(dbName);

insertDocuments(db, function() {
    updateDocument(db, function() {
      removeDocument(db, function() {
        client.close();
      });
    });
  });
});
</code></pre>
 <h3>索引收藏</h3>
 <p> <a href="https://docs.mongodb.org/manual/indexes/">索引</a>可以提高应用程序的性能。以下函数在<strong>文档</strong>集合中的<strong> a </strong>字段上创建索引。 </p>
 <pre><code class="language-js">const indexCollection = function(db, callback) {
  db.collection('documents').createIndex(
    { "a": 1 },
      null,
      function(err, results) {
        console.log(results);
        callback();
    }
  );
};
</code></pre>
 <p>将<code>indexCollection</code>方法添加到您的应用程序：</p>
 <pre><code class="language-js">const MongoClient = require('mongodb').MongoClient;
const assert = require('assert');

// Connection URL
const url = 'mongodb://localhost:27017';

const dbName = 'myproject';

// Use connect method to connect to the server
MongoClient.connect(url, function(err, client) {
  assert.equal(null, err);
  console.log("Connected successfully to server");

const db = client.db(dbName);

insertDocuments(db, function() {
    indexCollection(db, function() {
      client.close();
    });
  });
});
</code></pre>
 <p>有关更多详细信息，请参阅<a href="docs/reference/content/tutorials/main.md">教程</a>。 </p>
 <h2>后续步骤</h2>
 <ul>
 <li> <a href="http://mongodb.org"> MongoDB文档</a> </li>
 <li> <a href="http://learnmongodbthehardway.com">阅读Schemas </a> </li>
 <li> <a href="https://github.com/mongodb/node-mongodb-native"> Star on GitHub </a> </li>
 </ul>
 <h2>许可证</h2>
 <p> <a href="LICENSE.md"> Apache 2.0 </a> </p>
 <p>©2009-2012 Christian Amor Kvalheim <br />
©2012-present MongoDB <a href="CONTRIBUTORS.md">撰稿人</a> </p>