主数据库

介绍

部署 NocoBase 配置的数据库，用于存储 NocoBase 的系统表数据，也支持存储用户业务表数据。

主数据库支持的数据库版本和商业版本如下：

数据库	支持版本	社区版	标准版	专业版	企业版
MySQL	>= 8.0.17	✅	✅	✅	✅
PostgreSQL	>= 10	✅	✅	✅	✅
MariaDB	>= 10.9	✅	✅	✅	✅
KingbaseES	>=V9	❌	❌	✅	✅
OceanBase	>=4.3	❌	❌	❌	✅

:::tip 提示

KingbaseES 只支持 PostgreSQL 兼容模式，OceanBase 只支持 MySQL 兼容模式。

:::

插件安装

数据库	对应插件	安装方式
MySQL	无	内置插件，无需单独安装。
PostgreSQL	无	内置插件，无需单独安装。
MariaDB	无	内置插件，无需单独安装。
KingbaseES	@nocobase/plugin-data-source-kingbase	需要商业授权，安装后默认启用插件。
OceanBase	@nocobase/plugin-data-source-oceanbase	需要商业授权，安装后默认启用插件。

访问主数据源

1. 点击系统功能中的数据源菜单，访问数据源主页。
2. 选择数据源列表中的 Main 数据源，点击配置操作，访问主数据库，进行管理。

主数据源管理

主数据库提供数据表管理功能，可以检索、创建、变更、删除数据表，也可以同步数据库中已有数据表的字段；提供数据表字段创建、变更、删除。

• 筛选：检索 NocoBase 主数据库管理的数据表
• 创建数据表：新增业务数据表
• 编辑：变更业务数据表
• 删除：删除业务数据表
• 从数据库同步：同步数据库中已有数据表的结构
• 配置字段：数据表字段创建、变更、删除
• + ：tab页的 + 对数据表分类管理，创建、变更、删除分类

从数据库同步已有表

主数据源的一个重要特性是可以将数据库中已经存在的表同步到 NocoBase 中进行管理。这意味着：

• 保护现有投资：如果你的数据库中已经有大量的业务表，无需重新创建，可以直接同步使用
• 灵活集成：可以将通过其他工具（如 SQL 脚本、数据库管理工具等）创建的表纳入 NocoBase 管理
• 渐进式迁移：支持逐步将现有系统迁移到 NocoBase，而不是一次性重构

通过「从数据库加载」功能，你可以：

1. 浏览数据库中所有的表
2. 选择需要同步的表
3. 自动识别表结构和字段类型
4. 一键导入到 NocoBase 中进行管理

支持多种表结构类型

NocoBase 支持创建和管理多种类型的数据表：

• 普通表：内置了常用的系统字段；
• 继承表：可以创建一个父表，然后从该父表派生出子表，子表会继承父表的结构，同时还可以定义自己的列。
• 树表：树结构表，目前只支持邻接表设计；
• 日历表：用于创建日历相关的事件表；
• 文件表：用于文件存储的管理；
• SQL 表：并不是实际的数据库表，而是快速的将 SQL 查询，结构化的展示出来；
• 视图表：连接已有的数据库视图；

支持数据表的分类管理

提供了丰富的字段类型

灵活的字段类型转换

NocoBase 支持在同种数据库类型基础上进行灵活的字段类型转换。

示例：String 类型字段的转换选项

当数据库中的字段是 String 类型时，可以在 NocoBase 中转换为以下任意形式：

• 基础类型：单行文本、多行文本、手机号码、电子邮箱、URL、密码、颜色、图标
• 选择类型：下拉菜单（单选）、单选框
• 富媒体类型：Markdown、Markdown (Vditor)、富文本、附件（URL）
• 日期时间类型：日期时间（含时区）、日期时间（不含时区）
• 高级类型：自动编码、数据表选择器、加密

这种灵活的转换机制意味着：

• 无需修改数据库结构：字段的底层存储类型保持不变，只是在 NocoBase 中的表现形式发生改变
• 适应业务变化：随着业务需求的变化，可以快速调整字段的展示和交互方式
• 数据安全：转换过程不会影响已有数据的完整性

字段级别的灵活同步

NocoBase 不仅可以同步整个表，还支持字段级别的精细化同步管理：

字段同步的特点：

1. 实时同步：当数据库表结构发生变化时，可以随时同步新增的字段
2. 选择性同步：可以选择性地同步需要的字段，而不是全部字段
3. 类型自动识别：自动识别数据库字段类型并映射到 NocoBase 的字段类型
4. 保持数据完整性：同步过程不会影响已有数据

使用场景：

• 数据库结构演进：当业务需求变化，需要在数据库中添加新字段时，可以快速同步到 NocoBase
• 团队协作：当其他团队成员或 DBA 在数据库中添加了字段，可以及时同步
• 混合管理模式：部分字段通过 NocoBase 管理，部分字段通过传统方式管理，灵活组合

这种灵活的同步机制让 NocoBase 可以很好地融入现有的技术架构，不需要改变原有的数据库管理方式，同时又能享受 NocoBase 带来的低代码开发便利。

更多内容查看「数据表字段 / 概述」章节。