数据迁移
基础版及以上商业版功能
校对日期:2026-11-05。需要商业版基础版及以上。
系统 → 数据迁移 用 SQL 从其它系统的数据库里读取栏目和文章,写入当前站点。该功能默认关闭,需由管理员在 配置文件里开启 ujcms.;迁移完成后请再关掉。
下文先说明迁移页面的用法,再说明两条 SQL 的写法,并给出从 Jspxcms 和 JEECMS 迁移时的示例,供参照改写。
一、迁移页面的用法
页面从上到下分三块:
- 源数据库:选数据库类型(MySQL / MariaDB、PostgreSQL、达梦、瀚高,以发行包自带的驱动为准),填主机、端口、 数据库名(达梦填模式名)、用户名、密码,点"连接测试",连上后会显示数据库的产品和版本。"连接参数"一般留空, 需要时照输入框里随数据库类型变化的灰色示例填时区、字符集、SSL 一类的参数;其它参数不接受。 密码只在本页内存里,刷新页面后要重新输入。
- 迁移栏目数据:写一条 SELECT,把源库的列取成"字段说明"里列出的别名(展开"字段说明"可以看每个字段的含义, "填入示例 SQL"会生成一份模板,改成自己的表名、列名即可)。先点"预览":只读取前 20 行,告诉你认出了哪些列、 哪些列不认识会被忽略、缺了哪些必填列、总共多少行。确认无误再点"开始迁移"。
- 迁移文章数据:同样先预览再开始。"默认栏目"是源库栏目没有迁入过的文章落到的栏目;不选的话,这些文章会被 列为有问题的行、不会迁入。
迁移在后台执行,页面上有进度条,可以随时"停止"(已迁入的保留)。结束后会写明新迁入几条、跳过已迁入的几条、 有问题的几条,有问题的行逐条列出原因(缺标题、源库栏目没迁入……),其余的行不受影响。刷新页面后,正在执行的 任务会显示在页面顶部,接着看进度;系统 → 生成管理 的任务列表里也能看到它。一次只能执行一个迁移任务。
- 先迁移栏目,再迁移文章:文章按源库的栏目 ID 找到迁入后的栏目。栏目按源库的上下级关系迁入,同级顺序与 SQL 的顺序一致。
- 系统会记下每个栏目、每篇文章迁到了哪里(文章 SQL 要带上
id_,即源库的文章 ID):同一条 SQL 再执行一次, 已经迁入的会被跳过,不会一变二。文章 SQL 不带id_则无法识别,每执行一次都会新建一遍。 - 源库的创建时间、修改时间会保留;迁入的文章不进审核流程,也不推送搜索引擎、不发通知。
- 页面顶部显示本站已记录的对应关系条数。导出对应关系 得到一份 CSV(表、原 ID、原上级 ID、本库 ID),可以 用来做旧链接到新链接的跳转表。删除对应关系 只在打算全新迁移一遍时才需要;删除之后再执行迁移,已迁入的 栏目和文章会再迁入一份;有迁移任务在执行时不能删。
- 导出迁移方案 / 导入迁移方案:把连接信息(不含密码)和两条 SQL 存成一个 JSON 文件,在测试环境调好后拿到 正式环境直接用。
- 图片、附件的地址和正文原样照搬,文件本身不会被复制。旧站的上传目录要另行拷贝到新站能访问到的位置, 并保持地址不变,或者迁移后再批量替换地址。
二、SQL 的写法
- 后面的示例不是可以原样执行的脚本。 两套系统不同版本的表结构并不一样,示例里的表名、列名按其中一个版本、 MySQL 数据库写成,没有逐个版本核对。使用时对照自己旧库的实际结构修改。
- SQL 的写法只有一条规则:把旧库的列取成数据迁移页面“字段说明”里列出的别名(
id_、name_、title_……)。 认识哪些别名以页面上的“字段说明”为准;不认识的列会被忽略,缺了必填列会在预览时指出。 - 语句在旧库上执行,用的是旧库的 SQL 语法;下面的
IF、GROUP_CONCAT、JSON_ARRAYAGG是 MySQL 的写法, 旧库是其它数据库时换成对应的函数。
状态 status_ 的取值:0 已发布,1 已归档,10 草稿,20 已删除,21 已下线。旧系统的状态值要用 CASE WHEN 换算成这几个值,示例里的换算关系同样需要按旧库的实际取值核对。
三、从 Jspxcms 迁移
Jspxcms 的栏目在 cms_node、cms_node_detail,正文等大字段在 cms_node_clob;文章在 cms_info、 cms_info_detail、cms_info_clob。
栏目:
sql
SELECT
t.f_node_id AS id_,
t.f_parent_id AS parent_id_,
t.f_name AS name_,
t.f_number AS alias_,
td.f_meta_keywords AS seo_keywords_,
td.f_meta_description AS seo_description_,
td.f_link AS link_url_,
td.f_small_image AS image_,
tt.f_value AS text_,
tm.f_value AS markdown_,
t.f_views AS views_,
t.f_creation_date AS created_,
td.f_is_new_window AS target_blank_,
IF(t.f_is_hidden = '0', TRUE, FALSE) AS nav_
FROM cms_node t
JOIN cms_node_detail td ON t.f_node_id = td.f_node_id
LEFT JOIN cms_node_clob tt ON t.f_node_id = tt.f_node_id AND tt.f_key = 'text'
LEFT JOIN cms_node_clob tm ON t.f_node_id = tm.f_node_id AND tm.f_key = 'text_markdown'文章:
sql
SELECT
t.f_info_id AS id_,
t.f_node_id AS channel_id_,
td.f_title AS title_,
td.f_subtitle AS subtitle_,
td.f_full_title AS full_title_,
t.f_publish_date AS publish_date_,
td.f_link AS link_url_,
td.f_is_new_window AS target_blank_,
(SELECT GROUP_CONCAT(tag.f_name SEPARATOR ',')
FROM cms_info_tag tia JOIN cms_tag tag ON tag.f_tag_id = tia.f_tag_id
WHERE tia.f_info_id = t.f_info_id) AS tag_names_,
td.f_meta_description AS seo_description_,
td.f_source AS source_,
td.f_small_image AS image_,
td.f_video AS video_,
td.f_doc_pdf AS doc_,
td.f_doc AS doc_orig_,
td.f_doc_name AS doc_name_,
t.f_views AS views_,
tt.f_value AS text_,
tm.f_value AS markdown_,
(CASE WHEN t.f_status = 'A' THEN 0 WHEN t.f_status = 'B' THEN 10 ELSE 20 END) AS status_
FROM cms_info t
JOIN cms_info_detail td ON t.f_info_id = td.f_info_id
LEFT JOIN cms_info_clob tt ON t.f_info_id = tt.f_info_id AND tt.f_key = 'text'
LEFT JOIN cms_info_clob tm ON t.f_info_id = tm.f_info_id AND tm.f_key = 'text_markdown'说明:
markdown_有值的栏目和文章按 Markdown 编辑器保存,没有值的按text_的 HTML 正文保存。- 示例把状态
A当作已发布、B当作草稿,其余一律当作已删除。不想迁入回收站里的内容,加上WHERE t.一类的条件。f_ status IN ('A', 'B') - Jspxcms 是多站点系统,只迁移其中一个站点时按站点 ID 过滤(
WHERE t.)。f_ site_id = …
四、从 JEECMS 迁移
JEECMS 的栏目在 jc_channel、jc_channel_ext、jc_channel_txt;文章在 jc_content、jc_content_ext、 jc_content_txt,附件在 jc_content_。
栏目:
sql
SELECT
t.channel_id AS id_,
t.parent_id AS parent_id_,
ext.channel_name AS name_,
t.channel_path AS alias_,
ext.keywords AS seo_keywords_,
ext.description AS seo_description_,
txt.txt AS text_,
IF(txt.txt IS NULL, 1, 2) AS type_,
ext.is_blank AS target_blank_,
t.is_display AS nav_
FROM jc_channel t
JOIN jc_channel_ext ext ON t.channel_id = ext.channel_id
LEFT JOIN jc_channel_txt txt ON t.channel_id = txt.channel_id文章:
sql
SELECT
t.content_id AS id_,
t.channel_id AS channel_id_,
ext.title AS title_,
ext.release_date AS publish_date_,
ext.link AS link_url_,
ext.description AS seo_description_,
txt.txt AS text_,
(SELECT JSON_ARRAYAGG(JSON_OBJECT('name', attach.attachment_name, 'url', attach.attachment_path))
FROM jc_content_attachment attach
WHERE attach.content_id = t.content_id) AS file_list_json_,
(SELECT GROUP_CONCAT(tag.tag_name SEPARATOR ',')
FROM jc_contenttag ct JOIN jc_content_tag tag ON ct.tag_id = tag.tag_id
WHERE ct.content_id = t.content_id) AS tag_names_,
CASE
WHEN t.status = 0 THEN 10
WHEN t.status = 3 THEN 20
WHEN t.status = 5 THEN 1
ELSE 0
END AS status_
FROM jc_content t
JOIN jc_content_ext ext ON t.content_id = ext.content_id
LEFT JOIN jc_content_txt txt ON t.content_id = txt.content_id说明:
- 栏目类型
type_:1常规栏目,2单页栏目,3链接栏目。示例把有正文的栏目当作单页栏目。 file_list_json_是文件集,格式为 JSON 数组,每项有name、url,可以再带length(字节数)。JSON_ARRAYAGG需要 MySQL 5.7.22 及以上;旧库版本更低时先不迁移文件集,或把旧库导入到新一些的 MySQL 再迁移。- 示例把状态
0当作草稿、3当作已删除、5当作已归档,其余当作已发布。
五、常见问题
- 预览时提示某一列不认识。 别名写错了,或者用的是旧版本的别名(如
keywords_、description_,现在是seo_keywords_、seo_)。对照页面上的“字段说明”改正。description_ - 文章提示“源库栏目没有迁入”。 这篇文章所在的栏目没有出现在栏目 SQL 的结果里(例如被条件过滤掉了)。 补迁栏目,或者在迁移文章时选一个 默认栏目 接收这些文章。
- 旧链接怎么跳到新地址。 迁移后用 导出对应关系 得到旧 ID 与新 ID 的对照表(CSV),据此在 Nginx 或 网关上配置跳转。