↑

CloudBase 小程序文档数据库 SDKv1.0.0

cloudbase-references-no-sql-wx-mp-sdk15 KB

面向微信小程序 CloudBase 文档数据库开发,提供增删改查、复杂条件查询、分页、聚合运算及地理位置查询的完整 SDK 用法指引。适合在小程序端直接操作云开发数据库或编写云函数时使用。

0 0 0 0 更新于 2026-10-28 18:24

免责声明:本站部分 Skill 来源于公开渠道,使用前请注意识别相关风险,内容版权归原作者所有,如 Skill 涉及版权问题,请在线反馈,核实后予以下架处理。

概述

本 Skill 聚焦微信小程序 CloudBase 文档数据库 SDK 的实际开发场景,覆盖从小程序端初始化数据库实例、获取集合引用,到完成完整数据生命周期管理的全流程。具体包括基础 CRUD、组合条件过滤、分页游标、聚合管道运算以及地理位置查询等高频操作,同时强调为每个集合建立类型定义与统一命名前缀的工程规范,帮助开发者在小程序或云函数中写出类型安全、可维护的数据库代码。

技能包含

  • SKILL.md:技能主说明,含初始化方式、编码规范与核心概念(本文件)
  • crud-operations.md:增删改查基础操作细则
  • pagination.md:分页查询与游标使用
  • complex-queries.md:多条件组合查询与操作符用法
  • aggregation.md:聚合管道与统计运算
  • geolocation.md:地理位置数据查询(如附近的人、范围搜索)

核心能力

  • 一键初始化:自动识别默认环境或指定环境 ID 获取数据库实例,无需额外登录
  • 类型安全规范:强制建议为每个集合建立 TypeScript 类型定义与模型层,统一集合命名前缀
  • 完整 CRUD:覆盖文档的创建、读取、更新、删除及单条 doc 引用操作
  • 高级查询:支持链式条件组合、逻辑操作符嵌套、聚合统计与地理坐标范围检索
  • 分页与性能:提供游标分页方案,避免大数据集一次性加载

应用场景

用户怎么说本技能做什么
"小程序里怎么连 CloudBase 数据库?"给出 wx.cloud.database() 初始化代码,区分默认环境与指定环境
"要查附近 5 公里内的门店"调用 geolocation.md 中的地理位置查询方案,构造点坐标与半径条件
"订单列表分页加载怎么做?"提供 pagination.md 的游标分页实现,避免 skip 深翻页性能问题
"需要按月份统计销售额"使用 aggregation.md 的聚合管道,按时间字段分组求和
"数据库安全规则怎么配?"提示先通过 writeSecurityRule MCP 工具配置规则,再执行写操作