• 简体中文

      • MySQL

      数据源：外部 MySQL标准版+

      介绍

      MySQL 可以作为外部数据库接入 NocoBase。接入后，NocoBase 会读取 MySQL 中的数据表、字段和视图，并把它们作为外部数据源中的数据表使用。

      跟主数据库不同，外部 MySQL 的真实表结构仍由原业务系统、数据库客户端或迁移脚本维护。NocoBase 负责读取结构、保存字段元数据、配置页面区块、权限、工作流和 API。

      配置项说明
      支持版本MySQL >= 5.7。
      商业版本标准版、专业版、企业版支持。
      对应插件@nocobase/plugin-data-source-external-mysql。
      兼容协议使用 MySQL 协议连接。

      适合使用外部 MySQL 的场景：

      • 接入已有 ERP、MES、WMS、CRM 等业务系统的 MySQL 数据库
      • 在不迁移历史数据的情况下，用 NocoBase 搭建管理界面
      • 对已有表做权限控制、流程处理、数据修正或报表展示
      • 数据库结构继续由 DBA、迁移脚本或原系统维护
      注意

      外部 MySQL 不是 NocoBase 的系统数据库。NocoBase 不会接管它的备份、还原、迁移和表结构变更。

      插件安装

      该插件为商业插件，详细的激活方式请参考：商业插件激活指南

      添加数据源

      在「数据源管理」中点击「Add new」，选择 MySQL，然后填写连接信息。

      20240507204820

      常见连接配置如下：

      配置说明
      Data source name数据源标识名称，用于页面区块、权限、工作流和 API 中引用。创建后不能修改。
      Data source display name数据源在界面中显示的名称，建议使用业务人员能理解的名称，比如「ERP MySQL」「订单库」。
      Host / PortMySQL 主机地址和端口。默认端口通常是 3306。
      Database要连接的 MySQL 数据库名称。
      Username / Password用于连接 MySQL 的账号和密码。NocoBase 只能读取这个账号有权限访问的对象，不会授权或读取其他账号私有对象。
      Table prefix表名前缀。配置后，NocoBase 只读取匹配该前缀的数据表和视图，并在 NocoBase 中生成不带前缀的数据表名称。
      Collections / Add all collections控制接入范围。启用「Add all collections」时，NocoBase 会接入当前范围内的全部表和视图；关闭后，只接入你在「Collections」里勾选的对象。
      Enabled the data source是否启用这个数据源。关闭后，数据源配置会保留，但页面区块、权限、工作流和 API 无法继续读取它的数据。
      提示

      如果 MySQL 中对象很多，优先通过 Database、Table prefix 和「Collections」收窄范围。只接入当前应用会用到的表和视图，后续权限配置、页面搭建和同步维护都会更轻。

      选择数据表

      填写连接信息后，可以点击「Load Collections」读取 MySQL 中可用的数据表和视图。读取结果会受到连接账号、Database、Table prefix 和「Collections」配置影响。

      默认会启用「Add all collections」，表示接入当前范围内的全部表和视图。如果只想接入部分对象，可以关闭「Add all collections」，然后在列表中勾选需要的数据表或视图。

      add_new_database_configure_load_collection

      注意

      单个外部数据源一次最多接入 500 张数据表或视图。如果 MySQL 中对象很多，建议先通过 Database、Table prefix 或「Collections」收窄范围。

      同步和配置字段

      外部 MySQL 的表结构由数据库侧维护。NocoBase 不会在外部 MySQL 中创建字段、修改字段类型或删除真实字段。

      当 MySQL 侧表结构发生变化时，可以在数据源中执行「Sync from database」，重新读取表和字段元数据。同步会更新 NocoBase 中保存的数据表、字段、主键、唯一键和字段类型映射信息，但不会删除 MySQL 中的真实表或数据。

      字段同步后，可以在 NocoBase 中配置字段标题、字段类型（Field type）和字段组件（Field interface）。如果需要建立 NocoBase 关系字段，也是在 NocoBase 中保存关系元数据，不会在 MySQL 表里自动新增真实外键字段。

      字段类型映射

      NocoBase 会根据 MySQL 字段类型，自动映射到合适的 Field type 和 Field interface。你可以在字段配置中调整界面展示方式。

      常见映射如下：

      MySQL 字段类型NocoBase Field type可选 Field interface
      TINYINT、SMALLINT、MEDIUMINTinteger、boolean、sortInteger、Sort、Checkbox、Switch、Select、Radio group。
      INT、INTEGERinteger、unixTimestamp、sortInteger、Sort、Unix timestamp、Select、Radio group。
      BIGINTbigInt、snowflakeId、unixTimestamp、sortInteger、Sort、Unix timestamp、Created at、Updated at。
      FLOAT、DOUBLEfloatNumber、Percent。
      DECIMALdecimalNumber、Percent、Currency。
      CHAR、VARCHARstring、uuid、nanoid、encryptionInput、Email、Phone、Password、Color、Icon、Select、Radio group、UUID、Nano ID。
      TINYTEXT、TEXT、MEDIUMTEXT、LONGTEXTtextTextarea、Markdown、Vditor、Rich text、URL。
      DATEdateOnlyDate。
      TIMEtimeTime。
      DATETIMEdatetimeNoTz、datetimeTz、dateDate、Time、Created at、Updated at。
      TIMESTAMPdatetimeTz、dateDate、Time、Created at、Updated at。
      YEARstring、integerInput、Integer、Date。
      JSONjson、arrayJSON。
      注意

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

      主键和记录唯一标识

      用于页面区块展示和编辑的数据表，建议有主键或唯一字段。NocoBase 会优先使用主键作为记录唯一标识。

      如果接入的是视图、无主键表或联合主键表，需要在数据表配置中手动设置「Record unique key」。没有可用唯一标识时，页面区块可能无法正确查看、编辑或删除记录。

      20260709205547 20260709205609