数据源与结构运维插件
Maven 模块：mms-plugin-datasource。提供本插件表前缀下的 受限 DDL、数据读写 HTTP、MySQL 逻辑备份/还原（全库或指定表），以及可选的 定时备份（本地 / 阿里云 OSS / SMTP 邮件）。宿主契约须 v5，且 plugin.json 声明 backupOperator: true 方可使用 PluginBackupAccess。
白话理解
适合 运维与迁移：在插件白名单内执行 DDL、查改声明表、导出导入逻辑 SQL；不要把它当成业务用户的通用 SQL 控制台。详细边界以主仓需求文档为准。
标识与契约
| 项 | 值 |
|---|---|
| 插件 ID | mms.plugin.datasource |
| runtimeMode | HOST_MVC |
| hostServicesContractVersion | 5 |
| backupOperator | true |
| 表前缀 | plugin_ds_（见 plugin.json） |
HTTP 前缀
对外路径：/plugin/mms.plugin.datasource/ds/...。
结构与备份（节选）
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /ds/ping | 存活探测 |
| POST | /ds/schema/ddl | 受限 DDL（须权限 plugin:datasource:schema_ddl） |
| GET | /ds/schema/tables | 本插件前缀表列举 |
| GET | /ds/backup/catalog-tables | 当前库物理表（备份勾选） |
| POST | /ds/backup/export | 逻辑导出，body 含 tables、gzip |
| POST | /ds/backup/import | 原始字节导入 |
权限常量见 DatasourcePermissions 与 script/install.sql。
定时备份（backup.schedule）
- 配置后缀：
backup.schedule，值为 JSON（轮询周期、间隔、local / oss / email 等）。 - 说明：无 Web 上下文时读配置的租户按宿主默认（常见
000000）；细则见主仓version/v2.0.9-插件数据源与宿主契约v4.md§3.1。
Demo：构建与权限
bash
cd mms-plus/mms-plugins/mms-plugin-datasource
mvn -DskipTests package安装 JAR、执行 install.sql（含备份权限 0305/0306），并按需执行迁移 migrate/order.txt（由插件 onLoad 触发，以代码为准）。
延伸阅读
- 宿主契约与备份语义：主仓
version/v2.0.9-插件数据源与宿主契约v4.md - JAR 插件分册总览
- JAR 开发指南
文档修订
本节随插件与宿主契约更新；结构化修订见 日志。