NocoDB数据管理

技能简介

通过REST API连接并管理自托管NocoDB实例，支持查看数据库、浏览表结构、查询筛选行数据及插入新记录。

能做什么

• 列出所有数据库（bases）
• 查看指定数据库中的表列表
• 获取表的列结构（schema）
• 按条件查询、排序、分页读取行数据
• 根据ID获取单条记录详情
• 向表中插入新行数据

使用说明

1. 环境配置

export NOCODB_URL="https://your-nocodb-instance.com"
export NOCODB_TOKEN="your-api-token"

获取API令牌：登录NocoDB → Team & Settings → API Tokens → Add New Token。

2. 常用命令示例

列出所有数据库：

{baseDir}/scripts/nocodb.sh bases

列出某数据库的表（支持名称或ID）：

{baseDir}/scripts/nocodb.sh tables --base "Library"
{baseDir}/scripts/nocodb.sh tables --base pz38oanbzcaqfae

查看表列结构：

{baseDir}/scripts/nocodb.sh columns --base "Library" --table "Books"

查询行数据（支持排序、筛选、分页）：

{baseDir}/scripts/nocodb.sh rows --base "Library" --table "Books" --limit 10
{baseDir}/scripts/nocodb.sh rows --base "Library" --table "Books" --sort "-CreatedAt"
{baseDir}/scripts/nocodb.sh rows --base "Library" --table "Books" --where "(Title,like,%Preparation%)"

插入新行：

{baseDir}/scripts/nocodb.sh insert --base "Library" --table "Books" --json '{"Title": "New Book", "Publish Date": 2026}'

筛选语法：使用NocoDB过滤格式(Field,op,value)，可用运算符包括eq、neq、like、gt、lt等；多条件用~and连接。

输入与输出

见下方输入与输出表格。

项目	内容
输入	NOCODB_URL（实例地址）、NOCODB_TOKEN（API令牌）、base（数据库名/ID）、table（表名/ID）、查询参数（limit/offset/sort/where）、单条ID、JSON格式行数据
输出	数据库列表、表列表、列结构、行数据集合、单条记录、插入确认信息
适用人群	使用自托管NocoDB的团队、低代码平台用户、需要API化数据管理的开发者、业务数据分析人员
不包含	可视化UI编辑、复杂SQL查询、跨库关联、自动备份、细粒度权限控制

 

风险提示

• API令牌需妥善保管，避免泄露导致数据被未授权访问
• 插入操作前务必确认列结构，防止字段类型不匹配
• 生产环境建议启用HTTPS并限制IP白名单
• 大批量查询时注意设置合理的limit/offset，避免超时

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/nickian/nocodb/SKILL.md
来源类型：GitHub仓库