如何在CouchDB复制过程中应用映射函数？

1. 在源服务器创建裁剪视图 #

在远程CouchDB的目标数据库中，新建一个设计文档，编写映射函数来裁剪每个文档的字段——只保留本地设备需要的内容，必须保留_id和_rev（这两个是CouchDB复制依赖的核心元数据）。

示例设计文档（命名为_design/trimmed_docs）：

{
  "_id": "_design/trimmed_docs",
  "views": {
    "trimmed": {
      "map": "function(doc) {
        // 按需保留字段，示例仅保留name、email及元数据
        var trimmedDoc = {
          _id: doc._id,
          _rev: doc._rev,
          name: doc.name,
          email: doc.email
        };
        emit(doc._id, trimmedDoc);
      }"
    }
  }
}

这个视图会为数据库中所有文档生成裁剪后的版本，确保不会遗漏任何需要复制的文档。

2. 配置以视图为源的复制任务 #

创建复制任务时，将源地址设为上述视图的访问URL，而非整个数据库。复制过程会直接把视图输出的裁剪文档同步到本地设备。

示例复制任务配置（可通过CouchDB的/_replicate端点提交）：

{
  "source": "https://your-cloud-couchdb/your-db/_design/trimmed_docs/_view/trimmed?include_docs=false",
  "target": "local-mobile-db",
  "continuous": true,
  "create_target": true
}

• include_docs=false：禁用默认的完整文档拉取，直接使用视图输出的裁剪文档
• continuous=true：开启持续复制，同步后续的文档更新
• create_target=true：自动创建本地目标数据库（如果不存在）

3. 关键注意事项 #

• 不要在视图中添加文档过滤逻辑：确保映射函数处理所有文档，符合你“复制全部文档但仅保留部分字段”的需求
• 源服务器性能适配：因为视图计算在远程高性能服务器上完成，不会给本地弱设备带来额外负担
• 版本同步：视图会自动跟随源文档的更新重新计算裁剪内容，复制任务会同步这些更新后的精简文档

内容的提问来源于stack exchange，提问作者Alex R