SQLite 转 MySQL 项目技术文档

SQLite 转 MySQL 项目技术文档

1. 安装指南

1.1 环境要求

• 运行中的 MySQL 或 MariaDB 实例（测试环境为 MariaDB 5.5，CentOS 6）
• Python 2.7

1.2 安装步骤

1. 安装 Python 2.7：

   • 确保系统中已安装 Python 2.7。可以通过以下命令检查 Python 版本：

     python --version
     

   • 如果未安装，请根据操作系统类型安装 Python 2.7。

2. 下载项目文件：

   • 从 GitHub 项目页面下载 sqlite3-to-mysql.py 脚本文件。

3. 确保 MySQL/MariaDB 服务运行：

   • 确保 MySQL 或 MariaDB 服务正在运行。可以通过以下命令检查服务状态：

     systemctl status mariadb
     

   • 如果服务未运行，请启动服务：

     systemctl start mariadb
     

2. 项目使用说明

2.1 基本使用

项目的主要功能是将 SQLite 数据库文件转换并导入到 MySQL/MariaDB 数据库中。使用步骤如下：

1. 准备 SQLite 数据库文件：

   • 确保你有一个 SQLite 数据库文件（例如 filename.db）。

2. 执行转换命令：

   • 使用以下命令将 SQLite 数据库转换并导入到 MySQL/MariaDB：

     sqlite3 filename.db .dump | ./sqlite3-to-mysql.py -u new_user -p new_password -d new_database | mysql -u root -p --default-character-set=utf8
     

   • 其中：
     • filename.db 是你的 SQLite 数据库文件。
     • new_user 是你在 MySQL/MariaDB 中创建的新用户。
     • new_password 是新用户的密码。
     • new_database 是你要创建的新数据库名称。

3. 验证导入结果：

   • 使用新创建的用户登录 MySQL/MariaDB，检查数据库和表是否已成功创建并填充数据。

2.2 注意事项

• 数据备份：在执行转换操作前，请务必备份你的数据，以防数据丢失。
• 数据库名称冲突：如果选择的数据库名称已存在于 MySQL/MariaDB 实例中，数据将被覆盖。

3. 项目 API 使用文档

3.1 命令行参数

• -u new_user：指定在 MySQL/MariaDB 中创建的新用户。
• -p new_password：指定新用户的密码。
• -d new_database：指定要创建的新数据库名称。

3.2 示例

./sqlite3-to-mysql.py -u myuser -p mypassword -d mydatabase

4. 项目安装方式

4.1 直接使用脚本

• 下载 sqlite3-to-mysql.py 脚本文件，并确保 Python 2.7 已安装。
• 按照上述使用说明执行转换操作。

4.2 集成到项目中

• 可以将 sqlite3-to-mysql.py 脚本集成到你的项目中，通过调用脚本实现 SQLite 到 MySQL 的转换功能。

---

通过以上步骤，你可以轻松地将 SQLite 数据库转换并导入到 MySQL/MariaDB 中。如果在使用过程中遇到问题，请参考项目文档或联系项目维护者。