Ruby Active Record は、Ruby on Rails にバンドルされたオブジェクト リレーショナル マッピング(ORM)ライブラリです。Active Record は、基盤となるデータベースを抽象化し、スキーマの変更を自動生成する機能やスキーマのバージョン履歴を管理する機能などを提供します。
Active Record に対する Spanner のサポートにより、Active Record ユーザーは Spanner データベースを使用できます。このサポートにより、Ruby アプリケーションは ORM を介して Spanner の高可用性と外部整合性を大規模に利用できます。
アクティブ レコードの Spanner サポートの設定
アプリケーションで Active Record に対する Spanner のサポートを設定するには、Rails アプリケーションの Gemfile
を編集して activerecord-spanner-adapter gem を追加します。
gem 'activerecord-spanner-adapter'
次に、バンドルを実行して gem をインストールします。
bundle install
Active Record に対する Spanner サポートの認証として、GOOGLE_APPLICATION_CREDENTIALS
環境変数でサービス アカウントの JSON 認証情報ファイルの場所を指定する必要があります。それ以外の場合は、Active Record に対する Spanner サポートで、Google Cloud SDK gcloud
アプリケーションに設定されたデフォルトの認証情報を使用することもできます。
アクティブ レコードの Spanner サポートの使用
利用可能な機能、Active Record に対する Spanner サポートの制限、使用方法に関する推奨事項、コードサンプルについては、リファレンス ドキュメントをご覧ください(GitHub にあります)。
次のステップ
- Active Record の Spanner サポートを使用する方法について、コードの例を確認します。
- GitHub で Active Record の Spanner サポートのリポジトリを確認します。
- GitHub の問題を提出してバグを報告するか、Active Record の Spanner サポートについて質問します。
- Active Record について詳細を学習します。
- Ruby Gems について詳細を学習します。
- 認証のスタートガイドで、承認と認証情報について学習します。