DB2 與 Ruby on Rails 入門指南：IBM_DB 驅動安裝與 Starter Toolkit 實戰

背景：為什麼選 DB2 on Rails？

Ruby on Rails (RoR) 以「約定優於配置」、「DRY 原則」和 MVC 架構極大提升 Web 開發效率。IBM 推出 IBM_DB 驅動適配器，讓 Rails 原生支持 DB2 全系列 (含 pureXML)、Informix、IDS。配合 免費的 DB2 Express-C (無大小/時間/用戶限制) 及 Starter Toolkit for DB2 on Rails，構建零成本、企業級持久化的 RoR 應用成為現實。

兩種環境搭建路徑

路徑 A：Starter Toolkit 一鍵安裝 (推薦新手)

1. 下載 Starter Toolkit for DB2 on Rails v2.1+ (alphaWorks / IBM 官網)。
2. 運行安裝程序，自動完成：
   • DB2 Express-C 數據庫服務器 (可選安裝)
   • Ruby 運行時 + Rails 框架
   • IBM_DB 適配器與 C 驅動 (預編譯二進制，無需本地編譯工具鏈)
   • 預配置好的 database.yml 模板
   • 示例應用碼
3. 驗證：rails server 啟動 WEBrick，訪問示例頁確認連接正常。

限制： v2.1 暫不支持連接 i5/OS (AS400) 和 z/OS 上的 DB2，後續版本將補齊。

路徑 B：手動安裝 IBM_DB Gem (現有 DB2 環境)

適用於已有 DB2 服務器/客戶端、需自主控制版本的場景。

# 1. 確保已安裝 Ruby + DevKit (Windows) / GCC (Linux/Mac)
# 2. 從 RubyGems 或 RubyForge rubyibm 專案安裝最新穩定版 (0.6.0+)
gem install ibm_db

# 3. 若需本地編譯 C 擴展 (非預編譯平台)，需設置 DB2 客戶端庫路徑
export IBM_DB_HOME=/opt/ibm/db2/V11.5  # Linux 示例
gem install ibm_db -- --with-ibm-db-dir=$IBM_DB_HOME

# 4. Rails 專案中配置 config/database.yml
development:
  adapter: ibm_db
  database: MYDB
  username: db2inst1
  password: xxx
  host: localhost
  port: 50000
  # 可選: schema_search_path: MYSCHEMA

核心優勢：原生 XML 支持 (pureXML)

DB2 9+ 引入 pureXML，XML 以解析後的樹結構存儲，非文本大對象。IBM_DB 適配器充分利用此特性：

• ActiveRecord 欄位類型 :xml 直接映射 XML 列。
• 支持 XPath/XQuery 在 SQL 中高效過濾、提取 XML 片段，無需全文解析。
• 混合關係/文檔建模：訂單主表關係列 + 明細 XML 列，兼顧事務一致性與靈活結構。

Rails 遷移 與 DB2 協作

# 生成遷移
rails generate migration CreateProducts name:string price:decimal description:xml

# 遷移文件中使用 DB2 特有選項
class CreateProducts < ActiveRecord::Migration
  def change
    create_table :products do |t|
      t.string :name, limit: 100
      t.decimal :price, precision: 10, scale: 2
      t.xml :description  # DB2 專屬類型
    end
    # DB2 特有：指定表空間、壓縮、組織方式
    execute "ALTER TABLE products COMPRESS YES"
    execute "ALTER TABLE products APPEND OFF"
  end
end

# 執行遷移
rake db:migrate

常見問題排查

下一步學習資源

• IBM DeveloperWorks 系列教程：「DB2 with Ruby on Rails」 (多部分進階主題)
• ibm_db GitHub/RubyForge 頁面：最新 Gem、Issue、文檔
• DB2 Express-C 論壇：免費版部署、授權、遷移問答