用途:该技能面向 Web 应用开发者,说明如何使用 CloudBase 文档数据库 Web SDK(@cloudbase/js-sdk)对云数据库执行查询、新增、更新和删除,并覆盖复杂查询、分页、聚合与地理位置查询。
主要能力:通过 db.collection('名称') 引用集合;用 doc(id).get() 按 ID 查询单条,用 where(条件).get() 查询多条;支持 where、orderBy、limit、skip、field 等方法链式组合。查询操作符由 db.command(别名 _)提供,包括 gt、gte、lt、lte、eq、neq、in、nin。参考资料还分别覆盖 CRUD、复杂查询、分页、聚合、地理位置查询与安全规则等主题。
使用方式:先以同步方式初始化并登录,示例如 const app = cloudbase.init({ env: "your-env-id" }); const db = app.database(); const _ = db.command;。执行数据库操作前必须完成登录鉴权。操作均为异步,需用 try-catch 包裹;返回结构含 data 数组。
限制与注意:初始化须使用同步模式,不要用 import("@cloudbase/js-sdk") 懒加载,也不要封装成带 initPromise 缓存的异步初始化函数;UMD 版本需参考官方文档获取最新版本。get() 默认返回 100 条,最多 1000;地理位置查询需要正确的索引。需替换实际的 CloudBase 环境 ID。建议在应用启动时初始化一次并复用实例、对大数据集分页、只选必要字段并创建索引。
适用场景:Web 前端应用对接 CloudBase 云数据库的数据读写、列表分页、条件筛选、统计聚合及基于距离的地理查询。计费与价格信息暂未提供。