搭配 Spanner 使用 Active Record

Ruby Active Record 是 Ruby on Rails 隨附的物件-關聯式對應 (ORM) 程式庫。Active Record 可提供基礎資料庫的抽象概念，並提供自動產生結構定義變更和管理結構定義版本記錄等功能。

Active Record 的 Spanner 支援可讓 Active Record 使用者使用 Spanner 資料庫。有了這項支援，Ruby 應用程式就能透過 ORM 充分利用 Spanner 的高可用性和外部一致性。

設定 Spanner 支援 Active Record

如要在應用程式中設定 Spanner 對 Active Record 的支援，請編輯 Rails 應用程式的 Gemfile，並新增 activerecord-spanner-adapter gem。

gem 'activerecord-spanner-adapter'

接著，執行 bundle 來安裝 Gem。

bundle install

為了讓 Spanner 支援 Active Record 的驗證，應在 GOOGLE_APPLICATION_CREDENTIALS 環境變數中提供 服務帳戶 JSON 憑證檔案位置。否則，Active Record 的 Spanner 支援功能也可以使用 Google Cloud SDK gcloud 應用程式中設定的預設憑證。

使用 Spanner 支援的 Active Record

如要進一步瞭解可用功能、Spanner 對 Active Record 支援的限制、如何使用 Spanner 的建議，以及程式碼範例，請參閱 GitHub 上的參考說明文件。

後續步驟

  • 請查看程式碼範例，瞭解如何使用 Spanner 支援的 Active Record。
  • 在 GitHub 上查看 Active Record 的 Spanner 支援存放區。
  • 如要回報錯誤或提出有關 Spanner 對 Active Record 支援問題，請提交 GitHub 問題。
  • 進一步瞭解 Active Record。
  • 進一步瞭解 Ruby Gems。
  • 請參閱驗證入門一文，進一步瞭解授權和驗證憑證。