如何使用JS从Cloudant数据库中按ID随机拉取指定数量的文档？

方案选型说明 #

因为你的文档ID是连续1-100的整数，优先推荐用「本地生成随机ID批量查询」的方案，性能远高于全库随机排序查询。

方案1：本地生成随机ID+批量查询（推荐） #

实现逻辑 #

• 本地用洗牌算法生成1-100范围内的50个不重复随机数
• 调用Cloudant官方的postBulkGet接口一次性拉取对应ID的文档，避免多次请求开销

完整代码示例 #

// 引入Cloudant官方JS SDK，安装命令：npm install @ibm-cloud/cloudant
const { CloudantV1 } = require('@ibm-cloud/cloudant');

// 初始化Cloudant客户端，替换为你自己的实例认证信息
const cloudant = CloudantV1.newInstance({
  apikey: '你的Cloudant apikey',
  serviceUrl: '你的Cloudant实例服务地址'
});

const DATABASE_NAME = '替换为你的目标数据库名称';

/**
 * 生成指定范围内的不重复随机ID数组
 * @param {number} totalRange 最大ID值，这里固定为100
 * @param {number} needCount 需要的随机ID数量，这里固定为50
 * @returns {string[]} 随机ID字符串数组（Cloudant文档ID默认为字符串类型）
 */
function generateUniqueRandomIds(totalRange = 100, needCount = 50) {
  const idList = Array.from({length: totalRange}, (_, index) => String(index + 1));
  // Fisher-Yates 洗牌算法打乱数组
  for (let i = idList.length - 1; i > 0; i--) {
    const randomIndex = Math.floor(Math.random() * (i + 1));
    [idList[i], idList[randomIndex]] = [idList[randomIndex], idList[i]];
  }
  return idList.slice(0, needCount);
}

/**
 * 拉取随机文档的主方法
 * @returns {object[]} 随机返回的50份文档数组
 */
async function fetchRandomDocuments() {
  const randomIdList = generateUniqueRandomIds();
  const bulkGetResponse = await cloudant.postBulkGet({
    db: DATABASE_NAME,
    docs: randomIdList.map(id => ({id: id}))
  });
  // 过滤查询结果，排除可能的异常文档
  return bulkGetResponse.result.results
    .map(item => item.docs[0]?.ok)
    .filter(Boolean);
}

// 调用示例
fetchRandomDocuments()
  .then(randomDocs => console.log('随机拉取到的文档：', randomDocs))
  .catch(err => console.error('查询失败：', err));

方案2：全库随机排序查询（适配ID不连续的通用场景） #

如果后续你的文档ID不再是连续数值，可以用该方案，不需要提前处理ID逻辑：

实现逻辑 #

• 提前创建查询索引
• 查询时用Cloudant内置的$random排序规则，直接限制返回50条结果

代码示例 #

async function fetchRandomDocsByQuery() {
  // 首次调用可以先创建索引，后续重复调用可以去掉这段逻辑
  await cloudant.postIndex({
    db: DATABASE_NAME,
    ddoc: 'common_index',
    name: 'id_index',
    index: { fields: ['_id'] }
  });
  const queryResponse = await cloudant.postFind({
    db: DATABASE_NAME,
    selector: { _id: { $gte: '0' } }, // 匹配所有文档
    sort: ['$random'], // 随机排序
    limit: 50
  });
  return queryResponse.result.docs;
}

注意：该方案会扫描全库数据，仅适合1000条以内的小数据集使用，数据量大时性能会明显下降。

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