ActiveRecord SQL Server Adapter 技术文档

1. 安装指南

1.1 系统要求

• 支持的操作系统：Windows、Linux、macOS
• 支持的SQL Server版本：2012及以上
• 支持的Ruby版本：与Rails版本匹配

1.2 安装步骤

1. 确保已安装Ruby和Rails。
2. 添加Gem到Gemfile：

   gem 'activerecord-sqlserver-adapter', '~> 7.2.0'
   

3. 运行bundle install安装依赖。

2. 项目的使用说明

2.1 配置数据库连接

在config/database.yml中配置SQL Server连接：

development:
  adapter: sqlserver
  database: my_database
  username: my_username
  password: my_password
  host: my_host

2.2 创建数据库

使用Rails命令创建数据库：

rails db:create

2.3 运行迁移

使用Rails命令运行数据库迁移：

rails db:migrate

3. 项目API使用文档

3.1 执行存储过程

每个继承自ActiveRecord::Base的类都有一个execute_procedure类方法，用于执行存储过程。例如：

Account.execute_procedure(:update_totals, 'admin', nil, true)

3.2 强制模式为小写

如果数据库模式为大写或混合大小写，可以强制将所有表和列名转换为小写：

ActiveRecord::ConnectionAdapters::SQLServerAdapter.lowercase_schema_reflection = true

3.3 配置连接

可以通过重写configure_connection方法来配置连接，例如设置TEXTSIZE：

module ActiveRecord
  module ConnectionAdapters
    class SQLServerAdapter < AbstractAdapter
      def configure_connection
        super
        @raw_connection.execute("SET TEXTSIZE #{64.megabytes}").do
      end
    end
  end
end

4. 项目安装方式

4.1 通过Gem安装

在Gemfile中添加：

gem 'activerecord-sqlserver-adapter', '~> 7.2.0'

然后运行：

bundle install

4.2 手动安装

可以通过以下命令手动安装Gem：

gem install activerecord-sqlserver-adapter -v 7.2.0

通过以上步骤，您可以成功安装并使用ActiveRecord SQL Server Adapter来连接和管理SQL Server数据库。