nocodb

通过 REST API 访问和管理 NocoDB 数据库、表和记录。当用户想要查看库、列出表、检查列模式、查询或筛选行数据或将新记录插入自托管 NocoDB 实例时使用。还用于电子表格样式的数据库查找和数据输入。

## 概述（中文）

通过 REST API 访问和管理 NocoDB 数据库、表和记录。当用户想要查看库、列出表、检查列模式、查询或筛选行数据或将新记录插入自托管 NocoDB 实例时使用。还用于电子表格样式的数据库查找和数据输入。

## 原文

# NocoDB

Manage bases, tables, and rows on a self-hosted NocoDB instance via REST API.

## Setup

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

Get your API token: NocoDB → Team & Settings → API Tokens → Add New Token.

## Commands

### List bases

```bash
{baseDir}/scripts/nocodb.sh bases
```

### List tables in a base

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

Base and table args accept names (case-insensitive) or IDs.

### Show columns (schema)

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

### Query rows

```bash
{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 rows --base "Library" --table "Books" --limit 5 --offset 10
```

Sort: prefix with `-` for descending. Where: NocoDB filter syntax `(Field,op,value)`.

### Get single row

```bash
{baseDir}/scripts/nocodb.sh row --base "Library" --table "Books" --id 1
```

### Insert a row

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

Pass field values as a JSON object. Check columns first to see available fields.

## Filter Operators

Common NocoDB where operators: `eq`, `neq`, `like`, `gt`, `lt`, `gte`, `lte`, `is`, `isnot`, `null`, `notnull`.

Combine filters: `(Field1,eq,val1)~and(Field2,gt,val2)`