apaas-object-skill
Installation
SKILL.md
aPaaS 数据对象管理
管理 aPaaS 平台数据对象(表)的创建、更新、删除。通过 Node SDK 的 client.schema.* 接口操作。
快速导航
必读陷阱 | 前置条件 | 核心 API | 创建对象(两步走) | 字段类型映射 | 字段 settings 模板 | SQL 转换 | 多对象分阶段创建 | 错误处理 | 完整示例
必读陷阱清单
先看完这 5 条再动手,每条都是真实踩坑总结。
schema.create静默忽略 fields — 传了字段定义也返回成功,但字段不会被创建。必须两步走:先 create 空壳,再 update 添加字段。text/multilingual缺multiline= 整批静默失败 — API 返回code: "0"+data: null,看似成功但所有字段都没创建。始终用完整 settings 模板。- metadata type ≠ schema type —
number要写float,option要写enum,file要写attachment。用错直接报类型不识别。 - 系统字段
_id/_createdBy等不能手动创建 — 新建对象自动生成 5 个系统字段,重复定义会冲突报错。 - 批量上限 10 个对象 —
schema.create/update/delete每次最多 10 个,超过需分批。