配置增删改查操作

客户端配置

此示例演示如何通过将 MongoClientOptions对象传递给构造函数来设立MongoClient实例的读取偏好（read preference）、读关注（read concern）和写关注（write concern）。该代码配置以下设置：

• SECONDARY 读取偏好（read preference）：读取操作从从节点(secondary node from replica set)副本集成员检索数据

• local 读关注（read concern）：读取操作返回实例的最新数据，但不保证该数据已写入大多数副本集成员

• 2 写关注（write concern）：主节点 (primary node in the replica set)和一个从从节点(secondary node from replica set)副本集成员必须确认写入操作

const clientOptions = {
  readPreference: ReadPreference.SECONDARY,
  readConcern: { level: "local" },
  writeConcern: { w: 2 },
};
const client = new MongoClient("mongodb://localhost:27017", clientOptions);

或者，您可以在连接 URI 中指定读取和写入设置，该 URI 作为参数传递给MongoClient构造函数：

const uri = "mongodb://localhost:27017/?readPreference=secondary&readConcernLevel=local&w=2";
const clientWithUri = new MongoClient(uri);

事务配置

此示例演示如何通过将 TransactionOptions对象传递给 startTransaction() 方法来设立ACID 事务的读取偏好（read preference）、读关注（read concern）和写关注（write concern）。该代码配置以下设置：

• PRIMARY 读取偏好（read preference）：读取操作从主节点 (primary node in the replica set)副本集成员检索数据

• majority 读关注（read concern）：读取操作返回实例已写入大多数副本集成员的最新数据

• 1 写关注（write concern）：主节点 (primary node in the replica set)副本集成员必须确认写入操作

const transactionOptions = {
  readPreference: ReadPreference.PRIMARY,
  readConcern: { level: "majority" },
  writeConcern: { w: 1 },
};
const session = client.startSession();
session.startTransaction(transactionOptions);

数据库配置

此示例设立如何通过将 DbOptions对象传递给 db() 方法来设置名为 test_database 的数据库的读取偏好（read preference）、读关注（read concern）和写关注（write concern）。该代码配置以下设置：

• PRIMARY_PREFERRED 读取偏好（read preference）：读取操作从主节点 (primary node in the replica set)副本集成员检索数据，如果从节点(secondary node from replica set)主节点 (primary node in the replica set)不可用，则从节点成员检索数据

• available 读关注（read concern）：读取操作返回实例的最新数据，但不保证该数据已写入大多数副本集成员

• majority 写关注（write concern）：所有副本集成员中的大多数必须确认写入操作

const dbOptions = {
  readPreference: ReadPreference.PRIMARY_PREFERRED,
  readConcern: { level: "available" },
  writeConcern: { w: "majority" },
};
const db = client.db("test_database", dbOptions);

集合配置

此示例演示如何通过将 CollectionOptions对象传递给 collection() 方法来设立名为 test_collection 的集合的读取偏好（read preference）、读关注（read concern）和写关注（write concern）。该代码配置以下设置：

• SECONDARY_PREFERRED 读取偏好（read preference）：读取操作从节点副本集成员检索数据，如果没有可用的从节点，则从从节点(secondary node from replica set)主节点 (primary node in the replica set)成员检索数据

• available 读关注（read concern）：读取操作返回实例的最新数据，但不保证该数据已写入大多数副本集成员

• 0 写关注（write concern）：不请求确认写入操作

const collOptions = {
  readPreference: ReadPreference.SECONDARY_PREFERRED,
  readConcern: { level: "available" },
  writeConcern: { w: 0 },
};
const collection = db.collection("test_collection", collOptions);

排序规则字段

排序规则对象包含以下字段：

collation: {
  locale: <string>,
  caseLevel: <bool>,
  caseFirst: <string>,
  strength: <int>,
  numericOrdering: <bool>,
  alternate: <string>,
  maxVariable: <string>,
  backwards: <bool>
}

设置 collation 选项时，必须指定 locale 字段。所有其他字段都是可选的。有关支持的区域设置以及 locale 字段默认值的完整列表，请参阅 MongoDB Server手册中的支持的语言和区域设置。

排序规则示例

要指定排序规则，请创建一个 collation对象并将其 locale字段设立为要使用的语言排序规则。然后，将此对象作为选项参数传递给与目标排序规则级别对应的方法。

本节包括在集合、索引和操作级别设立排序规则的示例。

const db = client.db("db")
db.createCollection("names", {
  collation: { locale: "fr_CA" },
});

const coll = db.collection("names");
coll.createIndex(
  { "last_name" : 1 },
  { "collation" : { "locale" : "en_US" } });

{ "_id" : 1, "first_name" : "Hans", "last_name" : "Muller" }
{ "_id" : 2, "first_name" : "Gunter", "last_name" : "Braun" }
{ "_id" : 3, "first_name" : "Günter", "last_name" : "Krause" }
{ "_id" : 4, "first_name" : "Jürgen", "last_name" : "Weber" }

coll.findOneAndUpdate(
  { first_name: { $lt: "Gunter" } },
  { $set: { verified: true } },
  { collation: { locale: "de@collation=phonebook" } },
);

{ lastErrorObject: { updatedExisting: true, n: 1 },
  value: { _id: 3, first_name: 'Günter', last_name: 'Krause' },
  ok: 1 }