CloudBase PostgreSQL 云开发
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/tencentcloudbase-skills-postgresql-development-cloudbase。
技能介绍
要解决什么问题
在 CloudBase 里,PostgreSQL 模式与 NoSQL、MySQL 是并行能力,但前端与 MCP 侧调用的入口完全不同。常见失败模式包括:在 PG 任务里写 app.database()、db.collection(...).where(),上传仍用 app.uploadFile(),路由守卫依赖已过时的 getLoginState() 或 auth.getUser()。本技能针对「任务已明确是 CloudBase PG / app.rdb() / RLS / queryPgDatabase」的情形,把实现收敛到 PG 专用 API 与运维流程。
技能如何指导工作
- 先验环境:用
envQuery查看RuntimeBackends.postgresql与RuntimeMode;未开通 PG 时停止写app.rdb(),并区分遗留 NoSQL 桶与 PGstorage桶名。 - Schema 优先:DDL 走
managePgDatabase的planMigration/applyMigration,本地 SQL 放在cloudbase/migrations/,版本号与远程历史一致;建表前用information_schema核对列名,避免CREATE TABLE IF NOT EXISTS静默跳过导致字段不一致。 - 权限模型:理解
anon/authenticated/service_role与 Publishable Key、API Key 的对应关系;表级GRANT、序列权限、ENABLE ROW LEVEL SECURITY与CREATE POLICY与前端 CRUD 同批设计。 - Web 链路:登录用
auth.signInWithPassword+auth.getSession();存储用app.storage.from('bucket').upload与createSignedUrl;需要登录与通用 Web 验证时,按契约转读同级auth-tool-cloudbase、auth-web-cloudbase、web-development等 SKILL。
边界与注意点
- 不要用
queryMysqlDatabase、manageMysqlDatabase或 relational-database MySQL MCP 处理 PG 表。 - 不要把 NoSQL 的
.where()/.orderBy()/.count()照搬到 PG:应使用.match()/.eq()、.order()、.select("*", { count: "exact" })等 PG 模式写法。 - PG 与 NoSQL 可共存于同一环境:仅对任务明确要求落 PG 的新业务数据应用本技能;未要求时不要改写既有 NoSQL 集合与权限规则。
使用场景
- 新建 PG 模式环境后,要用版本化迁移建业务表并一次性配置 GRANT 与 RLS 策略
- 列表筛选页误用了 NoSQL 的 `.where()`,需改为 `app.rdb()` 下的 `.match()` / `.ilike()` 查询
- CMS 要求文章与用户角色进 PostgreSQL,并先确认 `queryAppAuth` 已开启用户名密码登录
- `applyMigration` 返回超时或 pending,需要用 `describeMigrationTask` 查状态而非重复推送同版本
适合人员
- 维护 CloudBase 全栈站点的工程师,要在已开 PG 的环境里交付带登录的业务 CRUD
- 从 NoSQL 示例改需求的前端,需在同一环境中把新模块落到 `app.rdb()` 且不能暴露 service_role
- 用 MCP 管库的后端同学,希望 DDL 只走 `applyMigration` 而不是默认 `execute` 静默建表
- 负责内容后台的产品工程化同学,要为编辑角色配置 RLS 且路由只认 `auth.getSession()`