↑

CloudBase 文档型数据库 Web SDKv1.0.0

cloudbase-references-no-sql-web-sdk28 KB

在 Web 应用中集成 CloudBase 文档数据库,提供增删改查、复杂条件查询、分页、聚合统计与地理位置查询等完整数据操作指导。适用于需要调用云开发数据库、配置安全规则或实现实时数据同步的前端开发场景。

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

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

概述

本 Skill 面向使用 CloudBase(腾讯云开发)文档型数据库的 Web 前端开发者,提供从 SDK 初始化、身份鉴权到完整数据生命周期管理的系统化操作指南。涵盖基础 CRUD、链式查询构造、分页与聚合管道、基于地理位置的附近搜索、实时数据监听(watch)以及安全规则配置六大核心模块,并附带类型化建模建议与统一错误处理范式,帮助开发者在浏览器端快速搭建健壮、可维护的云数据库应用。

技能包含

  • SKILL.md(本文件):技能主说明,含 SDK 初始化、查询操作符、链式方法、错误处理与最佳实践
  • crud-operations.md:创建、更新、删除文档的完整操作,含批量写入与软删除示例
  • complex-queries.md:多条件组合查询、字段筛选、排序与结果限制
  • pagination.md:基于 skip/limit 的分页、游标分页与无限滚动实现
  • aggregation.md:分组统计、聚合管道与时间维度数据汇总
  • geolocation.md:地理索引配置、距离搜索与区域范围查询
  • realtime.md:实时数据同步监听、变更回调与性能优化
  • security-rules.md:数据库权限配置、自定义安全规则语法与业务策略映射

核心能力

  • SDK 初始化与鉴权:指导环境 ID 配置、数据库实例获取及登录态要求
  • 链式查询构造:通过 where、orderBy、limit、skip、field 组合复杂筛选与排序
  • 完整 CRUD 操作:单条/批量增删改查,含部分更新操作符与软删除模式
  • 分页与聚合:支持传统分页、游标分页及分组统计、管道聚合计算
  • 地理位置查询:实现基于坐标距离的附近搜索与地理围栏检索
  • 实时数据监听:通过 watch 方法订阅文档变更,适配即时通讯与协同编辑场景
  • 安全规则配置:按业务逻辑设定读写权限,结合类型定义编写规则表达式
  • 规范化错误处理:强制校验返回码,输出带友好提示的统一错误处理模式

应用场景

用户怎么说本技能做什么
"我想在网页里接入 CloudBase 数据库做增删改查"提供 SDK 初始化到 CRUD 完整代码,含批量操作与软删除示例
"需要做多条件筛选和排序,还要分页加载"给出 where 链式组合、orderBy/limit/skip 用法,以及游标分页与无限滚动方案
"要做附近的人/店铺搜索功能"指导地理索引创建,提供距离查询与区域范围检索的完整实现
"希望数据变动时页面自动更新"提供 watch 监听器配置、变更回调处理及实时场景性能优化建议
"怎么防止用户越权访问别人的数据"讲解安全规则语法,协助按业务模型配置细粒度读写权限