文档菜单
文档首页
/
MongoDB 手册
/ / /

配置副本集标签集

本页

  • 在读取偏好中使用标签集
  • 自定义多数据中心写关注

副本集成员或成员可以配置为标签:

{ "<tag1>": "<string1>", "<tag2>": "<string2>",... }

对于读取操作,您可以在读取偏好中指定一个标签集,以帮助将读取操作直接导向具有特定标签的成员。

对于写入操作,您可以使用标签创建自定义的写入关注点

如果一个副本集成员或成员与tags关联,您可以在读取偏好中指定一个标签集来定位这些成员。标签集是一个文档数组,每个文档包含标签和值对。按照顺序尝试指定,直到找到匹配项。一旦找到,就使用该指定来查找所有符合条件的匹配成员。

注意

当指定读取偏好模式primary时,不能指定标签集。

例如,一个副本集具有以下副本集配置(为了简洁,省略了一些字段)

{
"_id" : "rs0",
"version" : 1,
"protocolVersion" : NumberLong(1),
"writeConcernMajorityJournalDefault" : true,
"members" : [
{ "_id" : 0, "host" : "mongodb0.example.net:27017", ..., "tags": { }, ... },
{ "_id" : 1, "host" : "mongodb1.example.net:27017", ..., "tags": { }, ... },
{ "_id" : 2, "host" : "mongodb2.example.net:27017", ..., "tags": { }, ... }
],
"settings" : {
...
}
}
  1. 向成员添加标签。

    连接mongosh到副本集,并使用rs.reconfig()向成员添加标签

    conf = rs.conf();
    conf.members[0].tags = { "dc": "east", "usage": "production" };
    conf.members[1].tags = { "dc": "east", "usage": "reporting" };
    conf.members[2].tags = { "dc": "west", "usage": "production" };
    rs.reconfig(conf);
  2. 验证副本集配置。

    运行rs.conf()以验证副本集配置(为了简洁,省略了一些字段)。rs.conf()返回一个类似于以下文档的文档

    {
    "_id" : "rs0",
    "version" : 2,
    "protocolVersion" : NumberLong(1),
    "writeConcernMajorityJournalDefault" : true,
    "members" : [
    {
    "_id" : 0,
    "host" : "mongodb0.example.net:27017",
    ...
    "tags" : {
    "dc": "east",
    "usage": "production"
    },
    ...
    },
    {
    "_id" : 1,
    "host" : "mongodb1.example.net:27017",
    ...
    "tags" : {
    "dc": "east",
    "usage": "reporting"
    },
    ...
    },
    {
    "_id" : 2,
    "host" : "mongodb2.example.net:27017",
    ...
    "tags" : {
    "dc": "west",
    "usage": "production"
    },
    ...
    }
    ],
    "settings" : {
    ...
    }
    }
  3. 在读取偏好中指定标签集。

    要将读取操作直接导向带有特定标签的副本,在连接到副本集的mongo shell中,您可以使用readPref()方法来指定读取偏好模式标签集。例如,

    • 要将读取操作直接导向带有同时 "dc": "east""usage": "production"标签的副本,请包含以下标签集

      db.collection.find({}).readPref( "secondary", [ { "dc": "east", "usage": "production" } ] )
    • 将读取操作导向带有"dc": "east"标签的副本,如果没有找到,则导向带有"usage": "production"标签的副本,请包含以下标签集

      db.collection.find({}).readPref( "secondary", [ { "dc": "east"}, { "usage": "production" } ] )

    提示

    另请参阅

如果一个副本集成员或成员与tags相关联,您可以配置副本集的settings.getLastErrorModes设置来创建一个自定义写入关注。

假设有一个五成员的副本集,成员位于两个数据中心

  1. 一个标记为VA的设施dc_va

  2. 一个标记为CA的设施dc_ca

{
"_id" : "rs0",
"version" : 1,
"protocolVersion" : NumberLong(1),
"writeConcernMajorityJournalDefault" : true,
"members" : [
{ "_id" : 0, "host" : "mongodb0.example.net:27017", ..., "tags": { }, ... },
{ "_id" : 1, "host" : "mongodb1.example.net:27017", ..., "tags": { }, ... },
{ "_id" : 2, "host" : "mongodb2.example.net:27017", ..., "tags": { }, ... }
{ "_id" : 3, "host" : "mongodb3.example.net:27017", ..., "tags": { }, ... }
{ "_id" : 4, "host" : "mongodb4.example.net:27017", ..., "tags": { }, ... }
],
"settings" : {
...
}
}
  1. 向副本集成员添加标签。

    连接到mongosh副本集,并使用rs.reconfig()添加标签到成员

    conf = rs.conf();
    conf.members[0].tags = { "dc_va": "rack1"};
    conf.members[1].tags = { "dc_va": "rack2"};
    conf.members[2].tags = { "dc_ca": "rack1"};
    conf.members[3].tags = { "dc_ca": "rack2"};
    conf.members[4].tags = { "dc_va": "rack1"};
    rs.reconfig(conf);
  2. 创建一个自定义写入关注。

    在副本集配置中,在settings.getLastErrorModes设置中定义一个自定义写入关注。例如,以下定义了自定义写入关注MultipleDC,该关注要求写入传播到具有不同dc_va标签值的两个成员和具有任何dc_ca标签值的一个成员。

    conf = rs.conf();
    conf.settings = { getLastErrorModes: { MultipleDC : { "dc_va": 2, "dc_ca": 1 } } };
    rs.reconfig(conf);

    注意

    如果写入传播到具有相同"dc_va"标签的两个成员,则MultipleDC写入关注不满足。例如,如果写入只传播到members[0]members[4],则"dc_va": 2不满足,因为它们具有相同的标签值"rack1"

  3. 使用自定义写入关注。

    要使用自定义写入关注,请在写入关注中传递写入关注名称到w选项

    db.collection.insertOne(
    { id: "xyz", status: "A" },
    { writeConcern: { w: "MultipleDC" } }
    )

返回

标签集