OceanBase

介绍

OceanBase 可以作为 NocoBase 的主数据库使用,用于存储 NocoBase 系统表数据和主数据源中的业务数据。主数据库在部署 NocoBase 时配置,应用运行后不可删除。

配置项说明
支持版本>= 4.3。
商业版本企业版支持。
数据库类型MySQL 兼容模式。
注意

OceanBase 作为主数据库时只支持 MySQL 兼容模式。

插件安装

OceanBase 由 @nocobase/plugin-data-source-oceanbase 提供,需要商业授权。

使用说明

  1. 部署 NocoBase 时,在数据库连接配置中选择或填写 OceanBase 对应的连接参数。
  2. 启动 NocoBase 后,在「数据源管理」中进入「Main」数据源,可以管理主数据库中的数据表和字段。
  3. 如需接入数据库中已经存在的表,可以在主数据库管理页使用「从数据库同步」。
  4. 配置数据表字段时,可以参考数据表字段目录选择字段类型和字段组件。

字段类型映射

在主数据库中,通过 NocoBase 页面创建字段时,NocoBase 会根据字段配置创建对应的 OceanBase 字段。通过「从数据库同步」接入已有表时,NocoBase 会按 MySQL 兼容逻辑识别 OceanBase 字段类型,自动映射到合适的 Field type 和 Field interface。你可以在字段配置中调整界面展示方式。

常见映射如下:

OceanBase 字段类型NocoBase Field type可选 Field interface
TINYINTSMALLINTMEDIUMINTintegerbooleansortInteger、Sort、Checkbox、Switch、Select、Radio group。
INTINTEGERintegerunixTimestampsortInteger、Sort、Unix timestamp、Select、Radio group。
BIGINTbigIntsnowflakeIdunixTimestampsortInteger、Sort、Unix timestamp、Created at、Updated at。
FLOATDOUBLEfloatNumber、Percent。
DECIMALdecimalNumber、Percent、Currency。
CHARVARCHARstringuuidnanoidencryptionInput、Email、Phone、Password、Color、Icon、Select、Radio group、UUID、Nano ID。
TEXTtextTextarea、Markdown、Vditor、Rich text、URL。
DATEdateOnlyDate。
TIMEtimeTime。
DATETIMEdatetimeNoTzdatetimeTzdateDate、Time、Created at、Updated at。
TIMESTAMPdatetimeTzdateDate、Time、Created at、Updated at。
JSONjsonarrayJSON。
注意

不支持的 OceanBase 字段类型会在字段配置中单独展示。这类字段需要开发适配后才能在 NocoBase 中作为普通字段使用。

更多通用配置见主数据源介绍