【亲测免费】 MySQL2 Gem 使用教程

1. 项目介绍

MySQL2 是一个现代、简单且非常快速的 MySQL 库，专为 Ruby 设计。它通过 C 代码将 MySQL 字段类型转换为 Ruby 数据类型，提供了显著的速度优势。MySQL2 旨在服务于连接、查询和迭代结果的常见用例，避免了直接映射复杂 C API 的复杂性。它还强制使用 UTF-8（或二进制）进行连接，并在可能的情况下使用编码感知的 MySQL API 调用。

2. 项目快速启动

安装

首先，确保你已经安装了 MySQL 客户端库。然后，使用以下命令安装 MySQL2 gem：

gem install mysql2

连接到数据库

以下是一个简单的示例，展示如何连接到 MySQL 数据库并执行查询：

require 'mysql2'

# 创建客户端连接
client = Mysql2::Client.new(
  :host => "localhost",
  :username => "root",
  :password => "yourpassword",
  :database => "yourdatabase"
)

# 执行查询
results = client.query("SELECT * FROM users")

# 遍历结果
results.each do |row|
  puts row
end

使用预处理语句

MySQL2 支持预处理语句，这可以提高性能并防止 SQL 注入攻击：

statement = client.prepare("SELECT * FROM users WHERE id = ?")
result = statement.execute(1)

result.each do |row|
  puts row
end

3. 应用案例和最佳实践

连接池

在高并发环境下，使用连接池可以显著提高性能。以下是一个简单的连接池示例：

require 'mysql2/client'
require 'connection_pool'

pool = ConnectionPool.new(size: 5, timeout: 5) {
  Mysql2::Client.new(
    :host => "localhost",
    :username => "root",
    :password => "yourpassword",
    :database => "yourdatabase"
  )
}

pool.with do |client|
  results = client.query("SELECT * FROM users")
  results.each do |row|
    puts row
  end
end

异步查询

MySQL2 支持异步查询，适用于需要非阻塞 I/O 的场景：

require 'mysql2/em'

EM.run do
  client = Mysql2::EM::Client.new(
    :host => "localhost",
    :username => "root",
    :password => "yourpassword",
    :database => "yourdatabase"
  )

  defer = client.query("SELECT sleep(1)")
  defer.callback do |result|
    puts "Result: #{result.to_a.inspect}"
  end
end

4. 典型生态项目

Ruby on Rails

MySQL2 是 Ruby on Rails 的默认 MySQL 适配器之一。你可以在 database.yml 中配置 MySQL2 作为数据库适配器：

development:
  adapter: mysql2
  encoding: utf8
  database: my_database
  username: root
  password: my_password
  host: localhost

Sequel

Sequel 是一个强大的 Ruby ORM，支持 MySQL2 作为适配器。你可以在连接字符串中使用 mysql2:// 前缀：

DB = Sequel.connect('mysql2://user:password@localhost/my_database')

EventMachine

MySQL2 与 EventMachine 结合使用，可以实现高效的异步数据库操作。以下是一个简单的示例：

require 'mysql2/em'

EM.run do
  client = Mysql2::EM::Client.new(
    :host => "localhost",
    :username => "root",
    :password => "yourpassword",
    :database => "yourdatabase"
  )

  defer = client.query("SELECT sleep(1)")
  defer.callback do |result|
    puts "Result: #{result.to_a.inspect}"
  end
end

通过这些示例和最佳实践，你可以充分利用 MySQL2 的强大功能，提升你的 Ruby 应用程序的性能和可扩展性。