FoundationDB SQL Layer ActiveRecord Adapter

The FoundationDB SQL Layer is a full SQL implementation built on the FoundationDB storage substrate. It provides high performance, multi-node scalability, fault-tolerance and true multi-key ACID transactions.

This project provides connection adapter integration for ActiveRecord.

Supported SQL Layer Versions

Version 1.9.3 is the minimum recommended release for use with this adapter.

While 1.9.2 is technically supported, it is known to contain a number of limitations preventing complete support.

All previous releases are unsupported.

Supported ActiveRecord Versions

This project currently supports Rails v3.2 and v4.0.

Support for v4.1 will be available shortly after it is released as stable.

Quick Start

1. Add to Gemfile
2. Install
3. Update configuration
4. Setup database

For a concrete example, we can easily use this adapter when following the Getting Started with Rails guide.

Follow the guide through Step 3.2 and then, before step 4, perform the steps below:

1. Add one the following lines to Gemfile:

   • Latest stable release:
     • gem 'activerecord-fdbsql-adapter', '~> 1.0.0'
   • Unreleased development version:
     • gem 'activerecord-fdbsql-adapter', github: 'FoundationDB/sql-layer-adapter-activerecord'

2. Install the new gem

   • $ bundle install

3. Edit config/database.yml to look like (adjust host as necessary):

   development:
     adapter: fdbsql
     host: localhost
     database: blog_dev

4. Setup the database

   • $ rake db:create

Continue with the guide at Step 4.

Contributing

1. Fork
2. Branch
3. Commit
4. Pull Request

If you would like to contribute a feature or fix, thanks! Please make sure any changes come with new tests to ensure acceptance. Please read the test/RUNNING_UNIT_TESTS.md file for more details.

Contact

• GitHub: http://github.com/FoundationDB/sql-layer-adapter-activerecord
• Community: http://community.foundationdb.com
• IRC: #FoundationDB on irc.freenode.net

License

The MIT License (MIT)
Copyright (c) 2012-2014 FoundationDB, LLC
It is free software and may be redistributed under the terms specified in the LICENSE file.