Skip to content

DATABASE_SETUP.md

Latest commit

 

History

History
267 lines (194 loc) · 5.87 KB

DATABASE_SETUP.md

File metadata and controls

267 lines (194 loc) · 5.87 KB

MySQL数据库日志系统配置说明

概述

系统已升级为使用MySQL数据库存储已处理文件的日志记录,相比纯文本日志具有以下优势:

  • ✅ 更高的查询效率 - 使用索引快速检索记录
  • ✅ 并发安全 - 支持多进程同时访问
  • ✅ 数据完整性 - 事务支持和约束保护
  • ✅ 统计分析 - 方便进行数据统计和报表生成
  • ✅ 扩展性强 - 易于添加新字段和功能

1. 安装MySQL数据库

Windows系统

  1. 下载MySQL安装包: https://dev.mysql.com/downloads/mysql/
  2. 运行安装程序,选择"Developer Default"配置
  3. 设置root密码(建议设置为强密码)
  4. 完成安装后,MySQL服务将自动启动

验证安装

打开命令提示符,执行:

mysql --version

2. 创建数据库和表

方法一: 使用SQL脚本(推荐)

  1. 登录MySQL:
mysql -u root -p
  1. 执行项目中的SQL脚本:
source D:/MyPlan/MusicDemo/src/main/resources/schema.sql

方法二: 手动创建

-- 创建数据库
CREATE DATABASE IF NOT EXISTS music_demo 
DEFAULT CHARACTER SET utf8mb4 
DEFAULT COLLATE utf8mb4_unicode_ci;

USE music_demo;

-- 创建表(表结构会由程序自动创建)

验证数据库创建

-- 查看数据库
SHOW DATABASES;

-- 使用数据库
USE music_demo;

-- 查看表结构
SHOW TABLES;
DESC processed_files;

3. 配置应用程序

编辑 config.properties 文件:

# 数据库类型(使用mysql)
db.type=mysql

# MySQL数据库连接配置
db.mysql.host=localhost          # 数据库服务器地址
db.mysql.port=3306              # 端口号
db.mysql.database=music_demo    # 数据库名称
db.mysql.username=root          # 用户名
db.mysql.password=your_password # 密码(请修改为实际密码)

# 连接池配置
db.mysql.pool.maxPoolSize=10        # 最大连接数
db.mysql.pool.minIdle=2             # 最小空闲连接数
db.mysql.pool.connectionTimeout=30000  # 连接超时时间(毫秒)

重要提示:

  • 请将 db.mysql.password 修改为你的MySQL root密码
  • 如果MySQL运行在其他服务器,请修改 db.mysql.host

4. 更新Maven依赖

已添加以下依赖到 pom.xml:

<!-- MySQL驱动 -->
<dependency>
    <groupId>com.mysql</groupId>
    <artifactId>mysql-connector-j</artifactId>
    <version>8.2.0</version>
</dependency>

<!-- HikariCP - 数据库连接池 -->
<dependency>
    <groupId>com.zaxxer</groupId>
    <artifactId>HikariCP</artifactId>
    <version>5.1.0</version>
</dependency>

执行以下命令下载依赖:

mvn clean install

5. 运行测试

启动应用程序

mvn compile exec:java -Dexec.mainClass="com.lux032.musicautotagger.Main"

查看日志记录

在MySQL中查询已处理的文件:

USE music_demo;

-- 查看所有已处理文件
SELECT * FROM processed_files ORDER BY processed_time DESC;

-- 查看最近24小时处理的文件
SELECT * FROM recent_processed_files;

-- 查看统计信息
SELECT * FROM processing_statistics;

-- 按艺术家统计
SELECT artist, COUNT(*) as file_count 
FROM processed_files 
GROUP BY artist 
ORDER BY file_count DESC;

-- 按专辑统计
SELECT album, COUNT(*) as file_count 
FROM processed_files 
GROUP BY album 
ORDER BY file_count DESC;

6. 数据库表结构

processed_files 表

字段 类型 说明
id BIGINT 自增主键
file_hash VARCHAR(64) 文件哈希值(唯一)
file_name VARCHAR(500) 文件名
file_path VARCHAR(1000) 文件完整路径
file_size BIGINT 文件大小(字节)
processed_time DATETIME 处理时间
recording_id VARCHAR(100) MusicBrainz录音ID
artist VARCHAR(500) 艺术家
title VARCHAR(500) 曲目标题
album VARCHAR(500) 专辑名称
created_at TIMESTAMP 记录创建时间
updated_at TIMESTAMP 记录更新时间

索引

  • idx_file_hash - 文件哈希索引(快速查重)
  • idx_processed_time - 处理时间索引(时间范围查询)
  • idx_recording_id - 录音ID索引
  • idx_artist - 艺术家索引(搜索和统计)
  • idx_title - 标题索引
  • idx_album - 专辑索引

7. 常见问题

Q1: 连接数据库失败

错误信息: Unable to connect to database

解决方案:

  1. 检查MySQL服务是否启动
  2. 验证用户名和密码是否正确
  3. 确认数据库 music_demo 已创建
  4. 检查防火墙是否阻止了3306端口

Q2: 找不到表

错误信息: Table 'music_demo.processed_files' doesn't exist

解决方案: 程序会自动创建表结构。如果未自动创建,请手动执行:

mysql -u root -p music_demo < src/main/resources/schema.sql

Q3: 字符编码问题

问题: 中文乱码

解决方案: 确保MySQL配置使用UTF-8编码:

-- 查看数据库编码
SHOW CREATE DATABASE music_demo;

-- 如果不是utf8mb4,重新创建
DROP DATABASE music_demo;
CREATE DATABASE music_demo CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

8. 性能优化建议

  1. 定期清理旧记录

    -- 删除90天前的记录
DELETE FROM processed_files WHERE processed_time < DATE_SUB(NOW(), INTERVAL 90 DAY);

  2. 优化表

    OPTIMIZE TABLE processed_files;

  3. 监控连接池

    • 根据实际并发量调整 maxPoolSize
    • 监控数据库连接数: SHOW PROCESSLIST;

9. 数据备份

备份数据库

mysqldump -u root -p music_demo > backup_$(date +%Y%m%d).sql

恢复数据库

mysql -u root -p music_demo < backup_20231201.sql

10. 从文本日志迁移

如果你之前使用文本日志,可以编写脚本导入到MySQL:

// 读取旧的文本日志文件
// 解析每一行
// 插入到MySQL数据库

完整的迁移工具可以根据需要开发。

技术支持: 如有问题请查看项目文档或提交Issue