Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Ruby Active Record ist eine ORM-Bibliothek (Object-Relational Mapping), die mit Ruby on Rails gebündelt ist.
Active Record bietet eine Abstraktion der zugrunde liegenden Datenbank und umfasst Funktionen wie die automatische Generierung von Schemaänderungen und die Verwaltung des Schemaversionsverlaufs.
Die Spanner-Unterstützung für Active Record ermöglicht Nutzern von Active Record die Verwendung von Spanner-Datenbanken. Dank dieser Unterstützung können Ruby-Anwendungen die hohe Verfügbarkeit und externe Konsistenz von Spanner über ein ORM in großem Maßstab nutzen.
Spanner-Unterstützung für Active Record einrichten
Zum Einrichten der Spanner-Unterstützung für Active Record in Ihrer Anwendung bearbeiten Sie das Gemfile Ihrer Rails-Anwendung und fügen das Gem activerecord-spanner-adapter hinzu:
gem 'activerecord-spanner-adapter'
Führen Sie dann das Bundle aus, um das Gem zu installieren.
bundle install
Als Authentifizierung für die Spanner-Unterstützung für Active Record sollte der Speicherort der JSON-Anmeldedaten für das Dienstkonto in der Umgebungsvariablen GOOGLE_APPLICATION_CREDENTIALS angegeben werden.
Andernfalls kann die Spanner-Unterstützung für Active Record auch die Standardanmeldedaten verwenden, die in der Google Cloud SDK-Anwendung gcloud festgelegt sind.
Spanner-Unterstützung für Active Record verwenden
Weitere Informationen zu den verfügbaren Funktionen, Einschränkungen der Spanner-Unterstützung für Active Record, Empfehlungen zur Verwendung und Codebeispiele finden Sie in der Referenzdokumentation auf GitHub.
Nächste Schritte
Codebeispiele zur Verwendung der Spanner-Unterstützung für Active Record.
Repository für die Spanner-Unterstützung für Active Record auf GitHub ansehen.
Ein GitHub-Problem senden, um einen Fehler zu melden oder eine Frage zur Spanner-Unterstützung für Active Record zu stellen.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Schwer verständlich","hardToUnderstand","thumb-down"],["Informationen oder Beispielcode falsch","incorrectInformationOrSampleCode","thumb-down"],["Benötigte Informationen/Beispiele nicht gefunden","missingTheInformationSamplesINeed","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 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)."]]
