SwitchPoint 项目使用教程

SwitchPoint 项目使用教程

switch_point Switching database connection between readonly one and writable one项目地址:https://gitcode.com/gh_mirrors/sw/switch_point

项目介绍

SwitchPoint 是一个 Ruby gem，用于在 Rails 应用中切换数据库连接，特别是在读写分离的场景中。它允许开发者为不同的模型配置不同的数据库连接，从而实现高效的读写操作分离。SwitchPoint 支持 ActiveRecord 3.2 到 5.2 版本，但不接受针对 ActiveRecord 6.1 及以上版本的新功能。

项目快速启动

安装

首先，将 SwitchPoint 添加到你的 Gemfile 中：

gem 'switch_point'

然后执行以下命令进行安装：

bundle install

配置

假设你有四个数据库：db-blog-master、db-blog-slave、db-comment-master 和 db-comment-slave。Article 和 Category 模型存储在 db-blog-[master|slave]，而 Comment 模型存储在 db-comment-[master|slave]。

在 database.yml 中配置数据库连接：

production_blog_master:
  adapter: mysql2
  username: blog_writable
  host: db-blog-master

production_blog_slave:
  adapter: mysql2
  username: blog_readonly
  host: db-blog-slave

production_comment_master:
  adapter: mysql2
  username: comment_writable
  host: db-comment-master

production_comment_slave:
  adapter: mysql2
  username: comment_readonly
  host: db-comment-slave

在初始化文件中配置 SwitchPoint：

SwitchPoint.configure do |config|
  config.define_switch_point :blog, readonly: :production_blog_slave, writable: :production_blog_master
  config.define_switch_point :comment, readonly: :production_comment_slave, writable: :production_comment_master
end

使用

在模型中使用 SwitchPoint：

class Article < ApplicationRecord
  use_switch_point :blog
end

class Comment < ApplicationRecord
  use_switch_point :comment
end

应用案例和最佳实践

读写分离

SwitchPoint 的主要应用场景是读写分离。通过为不同的模型配置不同的数据库连接，可以显著提高应用的读取性能。例如，对于博客系统，可以将文章和分类的读操作路由到从库，写操作路由到主库。

查询缓存

SwitchPoint 还提供了查询缓存功能，可以通过 Rack 中间件启用：

config.middleware.swap ActiveRecord::QueryCache, SwitchPoint::QueryCache

典型生态项目

ActiveRecord

SwitchPoint 依赖于 ActiveRecord，因此与 ActiveRecord 的生态系统紧密集成。它利用 ActiveRecord 的连接管理功能，实现了数据库连接的动态切换。

Rails

SwitchPoint 是一个 Rails gem，因此与 Rails 框架无缝集成。它可以在 Rails 应用中轻松配置和使用，提供了一种简单的方式来管理多个数据库连接。

通过以上步骤，你可以在 Rails 应用中快速集成和使用 SwitchPoint，实现高效的数据库读写分离。

switch_point Switching database connection between readonly one and writable one项目地址:https://gitcode.com/gh_mirrors/sw/switch_point