SuperAPI AI 工具集

cloudbase-document-database-in-wechat-miniprogram

数据与分析

查看项目

更新于 10-16 01:28

技能介绍

用途:本技能用于微信小程序端通过 wx.cloud.database() 访问 CloudBase 文档数据库,适用于小程序页面或小程序侧逻辑中的集合 CRUD、查询组合与分页、聚合、地理位置查询,以及依赖内置用户身份、_openid 或小程序侧权限的场景。它不适用于浏览器/Web 端 @cloudbase/js-sdk、服务端或云函数数据库访问,以及 MySQL 等关系型数据库任务。

主要能力:覆盖集合增删改查、复杂查询、分页、聚合与地理位置查询,并涉及安全规则与归属字段的处理方式。初始化示例:const db = wx.cloud.database(); const _ = db.command; 指定环境时可用 wx.cloud.database({ env: "test" })。集合访问如 db.collection("todos").where({ completed: false }).get(),文档引用如 db.collection("todos").doc("todo-id").get()。

使用方式:先确认调用方为小程序页面/组件或小程序侧逻辑,正确初始化 wx.cloud,再按操作类型查阅 ./crud-operations.md、./complex-queries.md、./pagination.md、./aggregation.md、./geolocation.md、./security-rules.md。相关兄弟技能以本地相对路径引用,如 ../auth-tool-cloudbase/SKILL.md;若缺失,应请用户安装完整 CloudBase 插件,不要把远程技能或协议 markdown 抓取进上下文。小程序项目规则见 ../miniprogram-development/SKILL.md,认证与身份流程见 ../auth-wechat-miniprogram/SKILL.md。

限制与注意事项:不要将 Web SDK 代码复制到小程序页面;不要手动写入或覆盖 _openid,_openid 由 SDK 写入时系统管理,禁止在 .add()、.set()、.update() 中手动设置;内置身份不等于可忽略安全规则,数据库操作仍受集合权限与安全规则约束;若规则要求归属条件,查询形状须匹配该规则模型,权限错误通常意味着规则与查询关系不匹配,而非仅用户未登录;特权全局访问应走后台工具或云函数,不要暴露在小程序客户端路径;避免无界大读取,改用分页;集合规则是否依赖 auth.openid / _openid 需先确认。其他收费、价格与具体平台细节暂未提供。