SuperAPI AI 工具集

cloudbase-document-database-web-sdk

数据与分析

查看项目

更新于 10-16 07:22

技能介绍

用途:该技能面向浏览器或 Web 应用,通过 @cloudbase/js-sdk 读写 CloudBase 文档数据库(NoSQL 集合),涵盖 CRUD、复杂查询、分页、聚合、watch() 实时监听和地理位置查询。

主要能力与用法:初始化需保持单一共享实例,示例为 import cloudbase from "@cloudbase/js-sdk"; const app = cloudbase.init({ env: "your-env-id" }); const db = app.database(); const _ = db.command;。集合权限要求身份时须先登录再查询。创建文档的返回 ID 位于 result._id,不是 result.id。常用写法包括 db.collection(...).where(...).get()、.add(...)、.orderBy(...).skip(...).limit(...)、.field(...)。

适用场景:仅限浏览器端 NoSQL 集合操作;不适用于小程序 wx.cloud.database()、服务端/云函数访问、SQL/MySQL 操作,以及无浏览器 SDK 代码的纯权限管理。若任务明确要求新建业务表存于 CloudBase PostgreSQL(app.rdb()、PG 行级安全、app.storage.from(...).upload(...)),应改用 postgresql-development-cloudbase 技能;同一环境中已有 NoSQL 集合仍用本技能。

限制:安全规则是请求校验器而非结果过滤器;CUSTOM 规则更新后后端缓存 2–5 分钟,首次写入可能失败或被拒,须核实 result.code/result.message 并做 get() 往返验证;get() 目标文档缺失会返回 HTTP 500 而非 false;需注意分页与索引,避免无界读取;数据库错误应转为可读错误,写入后不能仅凭 promise resolved 判定成功。