Database scheme

本手册旨在指导用户通过数据管理后台高效创建数据库表，并完成数据上传。适用于古地理平台相关数据的标准化管理流程。

数据库建库流程概览

1. 设计数据库表

2. 准备建表文件

3. 在数据管理后台中新建表

4. 准备数据文件

5. 使用 Navicat 远程连接数据库

6. 上传数据库数据

---

1. 设计数据库表

建库字段规范及要求

数据管理后台是支撑古地理平台中数据中枢，支持数据库表的快速构建，数据表关系快速构建等快捷操作。在数据管理后台中执行表的快速构建，需要遵循相关的字段类型要求和字段名命名规范，以下是数据库字段类型要求。数据管理后台支持的数据字段类型目前只包括基本数据类型的 MySQL 关系型数据库，未来将陆续支持多边形的数据存储和 PostgreSQL 数据库。

字段类型要求

序号	字段类型名称	字段类型	字段值示范	值域/长度
1	Bool	布尔类型	是/否；1/0	0 或 1（通常占 1 字节）
2	Int32	整数型	0,1,2,-1,-100..	-2,147,483,648 到 2,147,483,647
3	Int64	整数型	0,1,2,-1,-100..	-9,223,372,036,854,775,808 到 9,223,372,036,854,775,807
4	Float32	浮点型	3.14, -0.01, 100.0	~ ±3.4E38，精度约 6~7 位小数
5	Float64	浮点型	2.718281828459045	~ ±1.8E308，精度约 15~16 位小数
6	String	字符串型	"hello", "用户001"	默认 256，用户可指定限制长度
7	DateTime	时间型	2025-06-13 15:30:00	一般表示范围 1970-01-01 至 9999-12-31
8	FKey	外键	外键表的主键，具有唯一性	一般是外键表的主键

字段名命名规范

• 数据库字段名禁止使用数字开头

• 字段命名均为小写命名，若字段名有多个单词组成，采用下划线 _ 分割，例如 lithology_parttern

• 保持命名简洁明了，能清洗表达字段含义

2. 准备建库文件

数据库建库示例

可通过官方提供的建库模板文件进行表结构编辑：

• 下载建表模板（建议使用 Excel 或 CSV）

• 配置每一列的字段名、字段类型、长度、是否为主键等

• 完成后保存为 Excel 或 CSV 格式，用于在后台上传导入

10KB

DbTemplate.xlsx

Open

3. 在数据管理后台中新建表

步骤如下：

1. 登录数据管理后台

登录方式联系 程汉 [email protected]

1. 进入【表格】模块，点击【Create Table】

在管理后台中新建数据库表

1. 配置新数据库表的表名、字段名、字段类型、长度限制、主键等。

数据库建库配置页面

Group： 学科数据统一选择 d_planet__table 这个分组下。

Name： 数据库的表名，代表了该数据库的名称，建议使用驼峰命名法对数据库进行命名。例如 NewPBDBCollectionEntity 。

UUKey：数据库的唯一标识，自动生成，无需填写。

TableName：在 MySQL 数据库中的表的名称，自动生产，无需填写

Description：数据库的描述信息，对数据库进行简单描述，可选字段。

FieldList：配置数据库的字段名、字段值类型、长度限制和主键等。

1. 或上传步骤 2 中准备的建表文件，自动完成字段配置

4. 准备数据文件

数据文件建议使用 Excel（.xlsx）、CSV 或其他结构化格式进行编辑和保存，确保字段与建库结构严格一致。

数据准备建议：

• 表头需与数据库字段完全一致（字段名、顺序）

• 确保字段值类型正确，例如日期字段使用 YYYY-MM-DD 格式

• 检查数据完整性，避免空值、重复值或非法字符

• 可使用 Excel 或 WPS 表格工具进行编辑

5. 使用 Navicat 远程数据库

前提条件：

• 已获取目标数据库的连接信息（IP、端口、数据库名、用户名、密码）

• 安装 Navicat（或其他支持 MySQL 的数据库管理工具）

操作步骤：

1. 打开 Navicat，新建连接，选择 MySQL

2. 输入连接信息并测试连接

3. 成功连接后，在左侧找到对应数据库

4. 可进行以下操作：

   • 查看刚创建的表结构

   • 手动修改表结构（如有需要）

   • 导入数据文件（见下一步）

6. 上传数据库表

通过 Navicat 上传

• 右键目标表，选择【导入向导】

• 选择本地数据文件（Excel/CSV）

• 配置字段映射关系，确保列对齐

• 确认导入设置，开始上传

• 完成后，可通过查询语句确认导入成功

---

• 本手册将持续更新，确保同步平台功能迭代

• 如需获取建库模板或技术支持，请联系： 📧 [email protected]