One API数据迁移：不同数据库间转移完全指南
项目地址: https://gitcode.com/GitHub_Trending/on/one-api 为什么需要数据库迁移？
你是否还在为One API从SQLite迁移到MySQL时数据丢失而烦恼？是否在更换数据库类型时面对复杂的配置感到无从下手？本文将提供一套完整的One API数据迁移解决方案，帮助你在SQLite、MySQL和PostgreSQL之间安全、高效地转移数据，解决多数据库环境下的数据兼容问题。
读完本文你将掌握：
- 不同数据库类型的迁移准备工作
- 完整的迁移流程和操作步骤
- 数据验证与问题排查方法
- 迁移后的性能优化建议
支持的数据库类型
One API目前支持三种主流数据库类型，其配置方式如下：
| 数据库类型 | 环境变量 | 连接示例 | 适用场景 |
|---|---|---|---|
| SQLite | SQL_DSN 未设置 | one-api.db?_busy_timeout=3000 | 开发环境、单机部署 |
| MySQL | SQL_DSN 设置为MySQL连接串 | user:password@tcp(localhost:3306)/oneapi?charset=utf8mb4&parseTime=True&loc=Local | 生产环境、中大型部署 |
| PostgreSQL | SQL_DSN 以postgres://开头 | postgres://user:password@localhost:5432/oneapi?sslmode=disable | 企业级部署、高并发场景 |
迁移前准备工作
环境检查
在开始迁移前，请确保目标数据库环境满足以下要求：
# 检查MySQL版本 (5.7+)
mysql --version
# 检查PostgreSQL版本 (10+)
psql --version
# 检查One API版本 (确保使用最新版)
./one-api --version
数据备份
无论采用何种迁移方式，迁移前必须进行数据备份：
# SQLite数据库备份
cp one-api.db one-api-backup-$(date +%Y%m%d).db
# MySQL数据库备份
mysqldump -u root -p oneapi > oneapi-backup-$(date +%Y%m%d).sql
# PostgreSQL数据库备份
pg_dump -U postgres oneapi > oneapi-backup-$(date +%Y%m%d).sql
迁移工具选择
根据源数据库和目标数据库的不同组合，推荐使用以下工具：
详细迁移步骤
1. SQLite迁移到MySQL
步骤1: 导出SQLite数据
使用DB Browser for SQLite或命令行工具导出数据：
# 安装sqlite3工具
sudo apt-get install sqlite3
# 导出数据为SQL文件
sqlite3 one-api.db .dump > sqlite-data.sql
步骤2: 修改SQL文件兼容MySQL
使用sed命令进行批量替换：
# 移除SQLite特定语法
sed -i '/BEGIN TRANSACTION/d' sqlite-data.sql
sed -i '/COMMIT/d' sqlite-data.sql
sed -i '/PRAGMA/d' sqlite-data.sql
sed -i '/sqlite_sequence/d' sqlite-data.sql
# 修改数据类型兼容MySQL
sed -i 's/INTEGER PRIMARY KEY AUTOINCREMENT/INT PRIMARY KEY AUTO_INCREMENT/g' sqlite-data.sql
sed -i 's/TEXT/VARCHAR(255)/g' sqlite-data.sql
sed -i 's/DATETIME/DATETIME/g' sqlite-data.sql
步骤3: 创建MySQL数据库并导入数据
# 创建数据库
mysql -u root -p -e "CREATE DATABASE oneapi CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"
# 导入数据
mysql -u root -p oneapi < sqlite-data.sql
步骤4: 配置One API使用MySQL
# 设置环境变量
export SQL_DSN="user:password@tcp(localhost:3306)/oneapi?charset=utf8mb4&parseTime=True&loc=Local"
# 启动One API
./one-api
2. MySQL迁移到PostgreSQL
推荐使用pgloader工具进行迁移，它能自动处理数据类型转换：
# 安装pgloader
sudo apt-get install pgloader
# 创建迁移配置文件 mysql2pg.load
cat > mysql2pg.load << EOF
LOAD DATABASE
FROM mysql://user:password@localhost/oneapi
INTO postgresql://user:password@localhost/oneapi
WITH include drop, create tables, create indexes, reset sequences,
workers = 4, concurrency = 1
CAST type datetime to timestamp without time zone using zero-dates-to-null,
type timestamp to timestamp without time zone,
type tinyint to boolean using tinyint-to-boolean;
EOF
# 执行迁移
pgloader mysql2pg.load
3. PostgreSQL迁移到SQLite
由于SQLite的功能限制，此迁移仅推荐用于开发环境：
# 导出PostgreSQL数据
pg_dump -U postgres --data-only --column-inserts oneapi > pg-data.sql
# 创建SQLite数据库并导入
sqlite3 one-api-new.db < pg-data.sql
# 修改表结构兼容SQLite
sqlite3 one-api-new.db "ALTER TABLE users ADD COLUMN id INTEGER PRIMARY KEY AUTOINCREMENT;"
迁移后验证
数据完整性检查
迁移完成后，执行以下查询验证数据完整性：
-- 检查关键表记录数
SELECT 'channels' AS table_name, COUNT(*) FROM channels
UNION ALL
SELECT 'tokens', COUNT(*) FROM tokens
UNION ALL
SELECT 'users', COUNT(*) FROM users
UNION ALL
SELECT 'logs', COUNT(*) FROM logs;
功能验证
启动One API并验证核心功能：
# 启动One API
./one-api
# 使用curl验证API
curl http://localhost:3000/v1/models \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
常见问题解决
1. 数据类型不兼容
问题：迁移过程中出现数据类型转换错误。
解决方案：手动修改迁移脚本中的数据类型映射：
-- PostgreSQL到MySQL的TEXT类型转换
ALTER TABLE channels MODIFY COLUMN config TEXT;
2. 索引冲突
问题：MySQL迁移到PostgreSQL时出现索引名称冲突。
解决方案：重命名冲突的索引：
-- PostgreSQL中重命名索引
ALTER INDEX idx_channels_key RENAME TO idx_channels_key_new;
3. 大批量数据迁移超时
问题：迁移大量日志数据时超时。
解决方案：分批次迁移并禁用索引：
-- 禁用索引
ALTER TABLE logs DISABLE TRIGGER ALL;
-- 迁移完成后重新启用索引
ALTER TABLE logs ENABLE TRIGGER ALL;
迁移后的性能优化
数据库优化建议
根据目标数据库类型，应用以下优化：
MySQL优化配置
[mysqld]
max_connections = 1000
innodb_buffer_pool_size = 1G
query_cache_size = 64M
slow_query_log = ON
PostgreSQL优化配置
max_connections = 1000
shared_buffers = 1GB
work_mem = 32MB
maintenance_work_mem = 128MB
总结与展望
One API的数据迁移工作虽然涉及多个步骤，但按照本文提供的方法操作，可以确保数据安全、完整地转移到目标数据库。迁移过程中，关键是做好充分的准备工作，选择合适的迁移工具，并进行严格的迁移后验证。
随着One API的不断发展，未来版本可能会内置更便捷的数据迁移工具，支持一键导出/导入功能。建议定期关注项目更新，及时应用新的迁移方案。
记住，无论何时进行数据库迁移，都应该先在测试环境验证整个流程，再应用到生产环境，以最小化风险。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
