Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Ruby Active Record è una libreria di mapping oggetto-relazionale (ORM) inclusa in Ruby on Rails.
Active Record fornisce un'astrazione sul database sottostante e include funzionalità come la generazione automatica delle modifiche dello schema e la gestione della cronologia delle versioni dello schema.
Il supporto di Spanner per Active Record consente agli utenti di Active Record di utilizzare i database Spanner. Con questo supporto, le applicazioni Ruby possono sfruttare la disponibilità elevata e la coerenza esterna di Spanner su larga scala tramite un ORM.
Configurare il supporto di Spanner per Active Record
Per configurare il supporto di Spanner per Active Record nella tua applicazione, modifica il file Gemfile della tua applicazione Rails e aggiungi il gem activerecord-spanner-adapter.
gem 'activerecord-spanner-adapter'
Quindi, esegui il comando bundle per installare il gem.
bundle install
Come autenticazione per il supporto di Spanner per Active Record, la posizione del file delle credenziali JSON dell'account di servizio deve essere fornita nella variabile di ambiente GOOGLE_APPLICATION_CREDENTIALS.
In caso contrario, il supporto di Spanner per Active Record può utilizzare anche le credenziali predefinite impostate nell'applicazione Google Cloud SDK gcloud.
Utilizzare il supporto di Spanner per Active Record
Per ulteriori informazioni sulle funzionalità disponibili, sulle limitazioni del supporto di Spanner per Active Record, sui consigli su come utilizzarlo e su esempi di codice, consulta la documentazione di riferimento su GitHub.
Passaggi successivi
Consulta gli esempi di codice su come utilizzare il supporto di Spanner per Active Record.
Visualizza il repository per il supporto di Spanner per Active Record su
GitHub.
Invia una segnalazione su GitHub per segnalare un bug o fare una domanda sull'assistenza di Spanner per Active Record.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 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)."]]
