Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Active Record de Ruby es una biblioteca de asignación relacional de objetos (ORM) que se incluye en Ruby on Rails.
Active Record proporciona una abstracción sobre la base de datos subyacente y
incluye funciones como generar cambios de esquema automáticamente y
administrar el historial de versiones de esquemas.
La compatibilidad de Spanner con Active Record permite que los usuarios de Active Record usen bases de datos de Spanner. Con esta compatibilidad, las aplicaciones de Ruby pueden aprovechar la alta disponibilidad y la coherencia externa de Spanner a gran escala a través de un ORM.
Configura la compatibilidad con Spanner para Active Record
Para configurar la compatibilidad de Spanner con Active Record en tu aplicación, edita el archivo Gemfile de tu aplicación de Rails y agrega la gema activerecord-spanner-adapter.
gem 'activerecord-spanner-adapter'
A continuación, ejecuta bundle para instalar la gema.
bundle install
Como autenticación para la compatibilidad de Spanner con Active Record, la ubicación del archivo de credenciales JSON de la cuenta de servicio se debe proporcionar en la variable de entorno GOOGLE_APPLICATION_CREDENTIALS.
De lo contrario, la compatibilidad de Spanner con Active Record también puede usar las credenciales predeterminadas establecidas en la aplicación gcloud del SDK de Google Cloud.
Usa la compatibilidad con Spanner para Active Record
Para obtener más información sobre las funciones disponibles, las limitaciones de la compatibilidad de Spanner con Active Record, las recomendaciones sobre cómo usarlo y los ejemplos de código, consulta la documentación de referencia en GitHub.
¿Qué sigue?
Consulta los ejemplos de código sobre cómo usar la compatibilidad de Spanner con Active Record.
Consulta el repositorio de la compatibilidad de Spanner con Active Record en
GitHub.
Presenta un problema en GitHub para informar un error o hacer una pregunta sobre la compatibilidad de Spanner con Active Record.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 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)."]]
