Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Active Record est une bibliothèque ORM (mappage objet-relationnel) fournie avec Ruby on Rails.
Active Record fournit une abstraction sur la base de données sous-jacente et inclut des fonctionnalités telles que la génération automatique de modifications de schéma et la gestion de l'historique des versions de schéma.
La compatibilité de Spanner avec Active Record permet aux utilisateurs d'Active Record d'utiliser des bases de données Spanner. Grâce à cette prise en charge, les applications Ruby peuvent profiter de la haute disponibilité et de la cohérence externe à grande échelle de Spanner via un ORM.
Configurer la compatibilité de Spanner avec Active Record
Pour configurer la compatibilité de Spanner avec Active Record dans votre application, modifiez le fichier Gemfile de votre application Rails et ajoutez le gem activerecord-spanner-adapter.
gem 'activerecord-spanner-adapter'
Exécutez ensuite bundle pour installer le gem.
bundle install
En tant qu'authentification pour la compatibilité de Spanner avec Active Record, l'emplacement du fichier d'identifiants JSON du compte de service doit être fourni dans la variable d'environnement GOOGLE_APPLICATION_CREDENTIALS.
Sinon, la compatibilité Spanner avec Active Record peut également utiliser les identifiants par défaut définis dans l'application gcloud du SDK Google Cloud.
Utiliser la compatibilité Spanner avec Active Record
Pour en savoir plus sur les fonctionnalités disponibles, les limites de la compatibilité de Spanner avec Active Record, les recommandations d'utilisation et les exemples de code, consultez la documentation de référence sur GitHub.
Étape suivante
Consultez des exemples de code pour savoir comment utiliser la compatibilité Spanner avec Active Record.
Affichez le dépôt de la compatibilité de Spanner avec Active Record sur GitHub.
Ouvrez une demande GitHub pour signaler un bug ou poser une question sur la compatibilité de Spanner avec Active Record.
Obtenez davantage d'informations concernant les identifiants d'autorisation et d'authentification sur la page Premiers pas avec l'authentification.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/03 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/09/03 (UTC)."],[],[],null,["# Using Active Record with Spanner\n\nRuby [Active Record](https://guides.rubyonrails.org/active_record_basics.html) is an Object-Relational\nMapping (ORM) library bundled with [Ruby on Rails](https://rubyonrails.org/).\nActive Record provides an abstraction over the underlying database and\nincludes capabilities such as automatically generating schema changes and\nmanaging schema version history.\n\nThe [Spanner support for Active Record](https://github.com/googleapis/ruby-spanner-activerecord)\nenables [Active Record](https://guides.rubyonrails.org/active_record_basics.html) users to use Spanner\ndatabases. With this support, Ruby applications can take advantage of\nSpanner's high availability and external consistency at scale through\nan ORM.\n\n\n| **PostgreSQL interface note:** The [PostgreSQL interface for Spanner](/spanner/docs/postgresql-interface) doesn't support Active Record.\n\n\u003cbr /\u003e\n\nSetting up the Spanner support for Active Record\n------------------------------------------------\n\nTo setup the Spanner support for Active Record in your application, edit the\n`Gemfile` of your Rails application and add the\n[activerecord-spanner-adapter](https://rubygems.org/gems/activerecord-spanner-adapter)\ngem. \n\n gem 'activerecord-spanner-adapter'\n\nNext, run bundle to install the gem. \n\n bundle install\n\nAs authentication for the Spanner support for Active Record, the\n[service account JSON credentials](/docs/authentication/getting-started) file location should be\nprovided in the `GOOGLE_APPLICATION_CREDENTIALS` environment variable.\nOtherwise, the Spanner support for Active Record can also use the default credentials\nset in the Google Cloud SDK `gcloud` application.\n\nUsing the Spanner support for Active Record\n-------------------------------------------\n\nFor more information about the available features, limitations of the\nSpanner support for Active Record, recommendations on how to use it, and for code\nsamples, please consult the\n[reference documentation](https://github.com/googleapis/ruby-spanner-activerecord#readme)\non GitHub.\n\nWhat's next\n-----------\n\n- Checkout the [code examples](https://github.com/googleapis/ruby-spanner-activerecord#examples) on how to use the Spanner support for Active Record.\n- View the repository for the Spanner support for Active Record on [GitHub](https://github.com/googleapis/ruby-spanner-activerecord).\n- File a [GitHub issue](https://github.com/googleapis/ruby-spanner-activerecord/issues) to report a bug or ask a question about the Spanner support for Active Record.\n- Learn more about [Active Record](https://guides.rubyonrails.org/active_record_basics.html).\n- Learn more about [Ruby Gems](https://rubygems.org/).\n- Learn about authorization and authentication credentials in [Getting started with authentication](/docs/authentication/getting-started)."]]
