OOMOL NocoDB 数据操作
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_15292d5a/yjkj-oo-nocodb。
技能介绍
要解决什么问题
团队在 NocoDB 里维护业务表、视图和记录时,常见痛点是:既要走 API,又不想在脚本或对话里散落 API Key。本技能面向已接入 OOMOL 的环境:通过 oo CLI 调用 nocodb connector,凭据由 OOMOL 在服务端注入,代理侧只负责按契约组 payload、执行动作。
技能如何工作
执行前应先 oo connector schema 查看当前 action 的输入/输出 schema,再用 --data 传入与 schema 一致的 JSON(可为对象字符串或 @path/to/file.json)。响应形如 { "data": ..., "meta": { "executionId": "..." } },追踪执行可用 meta.executionId。
能力面覆盖 24 个 action,大致包括:
- 元数据:
list_bases、get_base_schema、list_tables、create_table、字段/视图增删改等(含 v3 metadata API) - 数据:
list_records/list_table_records、read_record、create_records、update_records、upsert_table_records、delete_records及计数类接口
文档约定:用户已安装 oo、已登录且已连接 NocoDB 时,不要主动跑 oo auth login 或打开连接页;仅在命令因鉴权/连接失败时再走首次配置。
适用边界与注意点
- 只读类(get / list / count)可直接执行。
- 创建、更新等会改库状态的操作:先与用户确认 payload 与影响范围。
- 删除类为破坏性操作:必须明确目标并取得确认后再跑。
- 计费或额度问题(如 HTTP 402)需在 OOMOL 控制台处理后再重试,属平台侧约束而非 NocoDB 本身逻辑。
使用场景
- 对话里要先按 `where` 条件统计某张业务表的行数,再决定是否触发下游流程,用 `count_records` 或 `count_table_records` 直接查库。
- 新需求要在已有 Base 里加表、加字段或建视图,需走 v3 元数据接口(如 `create_table`、`create_table_field`、`create_table_view`)并先拉 schema 对齐 payload。
- 从外部系统同步客户或订单行时,用 `upsert_table_records` 按最多三个匹配字段做创建或更新,避免在脚本里手写 API Key。
- 排查数据问题时让助手 `list_table_records` 带 filter/sort 分页拉取,再用 `read_table_record` 按 ID 核对单条记录内容。
适合人员
- 已用 OOMOL 连接 NocoDB、希望用自然语言查表列数据却不想把 Token 贴进对话的后端工程师
- 负责维护 NocoDB Base 结构(表/字段/视图)且需要助手先读 `get_base_schema` 再改元数据的实施或数据管理员
- 写自动化集成、要在 Agent 里执行增删改但坚持凭据只走 OOMOL 注入的集成开发
- 用 NocoDB 当轻量业务库、需对删除类 action 做人工确认后再执行的运营或风控协作角色