数据迁移

如何将旧网站的数据导入到新网站中，从来都是一个重要且麻烦的问题。新旧网站的系统不一样，数据库表结构不一样，甚至连数据库类型都可能不一样。

UJCMS 提供数据迁移功能，能够一定程度上简化这个过程。但需要有专业的知识，能够写 SQL 语句，且对旧系统的表结构足够了解。

本迁移功能只可迁移栏目和文章数据，其它数据需要手动录入。数据迁移为一次性迁移，不可多次迁移或同步，多次迁移可能导致数据重复。

开启数据迁移功能

数据迁移功能默认是关闭的。需要使用时开启，使用完毕后关闭，以免误操作。

打开 /WEB-INF/classes/application.yaml 文件，开启数据迁移功能：

ujcms.dataMigrationEnabled: true

修改完成后，重启 tomcat。

数据迁移界面

点击 系统 - 数据迁移 功能，即可进入数据迁移功能界面。如未发现此功能，请检测当前用户是否拥有该功能的权限、配置文件是否修改成功以及是否重启 tomcat。

旧数据库地址

数据库地址：旧数据库的地址。不同数据库有不同的地址格式，请参考相应数据库的官方文档，并填写正确地址。

• MySQL8：jdbc:mysql://localhost:3306/ujcms?serverTimezone=Asia/Shanghai&characterEncoding=UTF-8&nullCatalogMeansCurrent=true

• MariaDB：jdbc:mariadb://localhost:3306/ujcms?serverTimezone=Asia/Shanghai&characterEncoding=UTF-8&nullCatalogMeansCurrent=true

• PostgreSQL：jdbc:postgresql://localhost:5432/ujcms

• 人大金仓数据库：jdbc:postgresql://localhost:54321/ujcms

• 达梦数据库：jdbc:dm://localhost:5236/UJCMS

数据库用户名：数据库的登录用户名。

数据库密码：数据库的登录密码。

数据库驱动类名：不同数据库的驱动类名不一样。如系统中没有相应数据库的驱动，应将驱动 jar 文件复制到程序的 lib 目录下。

• MySQL8：com.mysql.cj.jdbc.Driver

• MariaDB：org.mariadb.jdbc.Driver

• PostgreSQL：org.postgresql.Driver

• 人大金仓数据库：org.postgresql.Driver

• 达梦数据库：dm.jdbc.driver.DmDriver

点击 连接测试，检测数据库连接是否正确。

迁移栏目数据

编写 SQL 从旧数据库中获取栏目数据。如：

select t.old_id as id_, t.old_name as name_ from old_channel t

如果数据在多个表中，可以使用表连接等 SQL 语句（数据库支持的语法都可使用）。

数据迁移比较耗时，特别是数据量大的情况下，请耐心等待。

栏目字段列表

将旧数据库中的字段，通过 as 关键词对应到以下字段中，注意字段结尾的下划线 _ 不可省略。带 * 标记的为必须字段。

• id_：* 栏目ID

• parent_id_：上级栏目ID

• name_：* 栏目名称

• alias_：栏目别名

• seo_title_：SEO标题

• seo_keywords_：SEO关键词

• seo_description_：SEO描述

• link_url_：跳转链接

• image_：栏目图片

• text_：正文

• markdown_：Markdown

• views_：浏览次数

• created_：创建时间

• modified_：修改时间

• target_blank_：是否新窗口打开

• nav_：是否导航菜单

• type_：栏目类型 1:常规,2:单页,3:链接

迁移文章数据

需要先迁移栏目数据，再迁移文章数据，否则文章无法对应到栏目。

编写 SQL 从旧数据库中获取文章数据。如：

select t.old_id as id_, t.old_chanel_id as channel_id_, t.old_title as title_ from old_article t

如果数据在多个表中，可以使用表连接等 SQL 语句（数据库支持的语法都可使用）。如果希望进行测试迁移，查看迁移效果，且原数据库数据量较大的，可在 SQL 语句中加上限制条数，如 MySQL 的 limit 语句。

数据迁移比较耗时，特别是数据量大的情况下，请耐心等待。

文章字段列表

将旧数据库中的字段，通过 as 关键词对应到以下字段中，注意字段结尾的下划线 _ 不可省略。带 * 标记的为必须字段。

• id_：* 栏目ID

• parent_id_：上级栏目ID

• channel_id_：* 栏目ID

• created_：创建时间

• modified_：修改时间

• publish_date_：发布时间

• status_：状态（0:已发布,1:已归档,10:草稿,20:已删除,21:已下线）

• title_：* 标题

• subtitle_：副标题

• full_title_：完整标题

• link_url_：跳转链接

• target_blank_：是否新窗口打开

• seo_keywords_：SEO关键字

• seo_description_：SEO描述

• source_：来源

• image_list_json_：图片列表集（name:名称,url:图片URL,description:描述）

• file_list_json_：文件集（name:名称,url:文件URL,length:长度）

• image_：图片URL

• video_：视频URL

• video_orig_：原视频URL

• video_duration_：视频时长（单位：秒）

• audio_：音频URL

• audio_orig_：原音频URL

• audio_duration_：音频时长（单位：秒）

• file_：附件URL

• file_name_：附件名称

• file_length_：附件大小（单位：字节）

• doc_：文库URL

• doc_orig_：原文库URL

• doc_name_：文库名称

• doc_length_：文库大小（单位：字节）

• text_：正文

• markdown_：Markdown

• views_：浏览次数

删除新旧对应数据

导入栏目数据时，系统会记录旧数据库的栏目ID与新数据库的ID对应关系，方便下一步导入文章时找到对应的新栏目。

要进行全新迁移，且之前迁移过数据，应先 删除新旧对应数据。

如迁移数据后，发现未能符合预期，可将已迁移的栏目和文章数据删除，并删除新旧对应数据，再重新进行迁移。