如何通过Java客户端为Cloudant/CouchDB现有设计文档新增视图？

你的直觉是对的——新增视图根本不需要删除整个设计文档，这种做法反而会带来不少问题：

为什么当前实现方式不可取？ #

• 浪费资源+性能暴跌：Cloudant的视图依赖预构建的索引，删除设计文档会把所有现有视图的索引全部清空。之后重新保存设计文档时，所有4个原有视图加上新视图都得重新构建索引，数据量越大，这个过程耗时越长，期间相关查询会变得极慢，甚至拖垮应用。
• 服务中断风险：如果删除设计文档后，保存新文档的操作失败（比如网络波动、权限问题），那数据库里就没有这个设计文档了，所有依赖原有视图的功能会直接罢工，导致服务不可用。
• 完全不符合Cloudant的设计逻辑：Cloudant本身就支持对设计文档的增量更新，没必要做这种“推倒重来”的操作。

正确的实现方式：增量更新设计文档 #

你只需要获取现有设计文档，把新视图加进去，再保存回去就行，原有视图和它们的索引都会完好保留：

// 1. 获取目标设计文档（替换成你的设计文档ID）
DesignDocument existingDesignDoc = database.getDesignDocumentManager().getDesignDocument("your-design-doc-id");

// 2. 定义你要新增的视图
ViewDefinition newView = new ViewDefinition.Builder()
    .name("your-new-view-name")
    .mapFunction("function(doc) { // 这里写你的map函数逻辑，比如：\n  if(doc.type === 'order') {\n    emit(doc.orderDate, doc.totalAmount);\n  }\n}")
    // 如果需要reduce函数，取消下面的注释
    // .reduceFunction("_sum")
    .build();

// 3. 将新视图添加到设计文档的视图集合中
existingDesignDoc.getViews().put(newView.getName(), newView);

// 4. 保存更新后的设计文档
database.save(existingDesignDoc);

额外注意事项 #

• 确认你使用的设计文档ID没错，避免操作到其他设计文档；
• 如果新视图的名称和现有视图重复，这个操作会覆盖原有视图——如果不想覆盖，保存前可以先检查existingDesignDoc.getViews().containsKey(newView.getName())；
• 增量更新只会触发新视图的索引构建，原有视图的索引不受影响，对数据库性能的影响小很多。

内容的提问来源于stack exchange，提问作者Xavier DSouza