Mongify 技术文档

1. 安装指南

Mongify 是一个将 SQL 数据库转换为 MongoDB 的数据转换工具。它支持多种 SQL 数据库，包括 MySQL、PostgreSQL、SQLite、Oracle、SQLServer 和 DB2。目前，它主要在 MySql 和 SQLite 上进行了测试。

安装 Mongify 非常简单，只需要执行以下命令：

gem install mongify

请注意，您可能需要安装 activerecord 数据库相关 gem（当运行 mongify 命令时，如果出现错误信息，您将知道需要安装哪些 gem）。

2. 项目使用说明

Mongify 需要知道您的数据库位置才能工作。构建配置文件非常简单：

创建 SQL 数据库连接：

sql_connection do
  adapter     "mysql"
  host        "localhost"
  username    "root"
  password    "passw0rd"
  database    "my_database"
  batch_size  10000
  # 如果出现 "String not valid UTF-8" 错误，取消注释下面的行。
  # encoding "utf8"
end

创建 MongoDB 数据库连接：

mongodb_connection do
  host        "localhost"
  database    "my_database"
  # 如果出现 "String not valid UTF-8" 错误，取消注释下面的行。
  # encoding "utf8"
end

您可以运行以下命令来检查您的配置：

mongify check database.config

生成或创建翻译文件

生成翻译文件

如果您的数据库很大且结构复杂，手动编写翻译文件可能会非常繁琐。Mongify 的 translate 命令可以帮助您：

mongify translation database.config

或者将其直接管道输出到一个文件中：

mongify translation database.config > translation_file.rb

创建翻译文件

创建翻译文件非常直接。它看起来像这样：

table "users" do
  column "id", :key
  column "first_name", :string
  column "last_name", :string
  column "created_at", :datetime
  column "updated_at", :datetime
end

table "posts" do
  column "id", :key
  column "title", :string
  column "owner_id", :integer, :references => :users
  column "body", :text
  column "published_at", :datetime
  column "created_at", :datetime
  column "updated_at", :datetime
end

# 更多表定义...

将文件保存为 translation_file.rb 并运行以下命令：

mongify process database.config translation_file.rb

3. 项目 API 使用文档

Mongify 提供了几个命令来操作数据转换：

• check 或 ck：检查 SQL 和 NoSQL 数据库的连接。
• process 或 pr：处理翻译文件并将数据转换到 MongoDB。
• sync 或 sy：处理翻译文件并将数据同步到 MongoDB，仅基于 updated_at 列插入或更新新记录。
• translation 或 tr：从 SQL 连接输出一个翻译文件。

命令示例：

mongify translation database.config
mongify tr database.config
mongify check database.config
mongify process database.config database_translation.rb
mongify sync database.config database_translation.rb

4. 项目安装方式

如前所述，Mongify 的安装方式非常简单，通过 gem 命令即可完成：

gem install mongify

请确保在运行 Mongify 之前安装了所有必要的 activerecord 数据库 gem。