Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
O Active Record do Ruby é uma biblioteca de mapeamento relacional
de objetos (ORM) que vem com o Ruby on Rails.
O Active Record fornece uma abstração sobre o banco de dados subjacente e
inclui recursos como a geração automática de alterações de esquema e
o gerenciamento do histórico de versões do esquema.
O suporte do Spanner para o Active Record
permite que os usuários do Active Record usem os bancos de dados do Spanner. Com esse suporte, os aplicativos Ruby podem aproveitar a
alta disponibilidade e a consistência externa do Spanner em grande escala usando
um ORM.
Como configurar o suporte do Spanner para o Active Record
Para configurar o suporte do Spanner para o Active Record no seu aplicativo, edite o
Gemfile do seu aplicativo Rails e adicione a
gem activerecord-spanner-adapter.
gem 'activerecord-spanner-adapter'
Em seguida, execute o bundle para instalar a gem.
bundle install
Como autenticação para o suporte do Spanner para o Active Record, o local do arquivo credenciais JSON da conta de serviço precisa ser fornecido na variável de ambiente GOOGLE_APPLICATION_CREDENTIALS.
Caso contrário, o suporte do Spanner para o Active Record também poderá usar as credenciais padrão
definidas no aplicativo gcloud do SDK do Google Cloud.
Como usar o suporte do Spanner para o Active Record
Para mais informações sobre os recursos disponíveis, as limitações do
suporte do Spanner para o Active Record, recomendações sobre como usá-lo e para amostras
de código, consulte a
documentação de referência
no GitHub.
A seguir
Confira os exemplos de código sobre como usar
o suporte do Spanner para o Active Record.
Confira o repositório de suporte do Spanner para o Active Record no
GitHub.
Registre um problema do GitHub para relatar um bug ou fazer
uma pergunta sobre o suporte do Spanner para o Active Record.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-11 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)."]]
