Repository is archived
No commit activity in last 3 years
No release in over 3 years
There's a lot of open issues
OracleEnhanced adapter for Scenic gem.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
2026
 Dependencies

Development

>= 2.2.10
~> 12.3
~> 3.0

Runtime

>= 4.0.0
>= 1.4.0
 Project Readme

ScenicOracleEnhancedAdapter

This gem provides an adapter for the Scenic gem for use with the Oracle Enhanced Adapter.

Installation

Add this line to your application's Gemfile:

gem 'scenic_oracle_enhanced_adapter'

And then execute:

$ bundle

Then add a Scenic initializer (or modify your existing initializer) to make Scenic use this adapter:

# config/initializers/scenic.rb

Scenic.configure do |config|
  config.database = Scenic::Adapters::OracleEnhanced.new
end

Switching from rails_sql_views to Scenic

In Oracle 12, replacing a view has issues when the view refers to objects outside its own schema; use update_view, which will drop and create. The replace_view method can still be used for views referring to objects in their own schema.

  1. Run bundle exec rails g scenic:view <full_view_name> (if you use a prefix for the view, include it).
  2. Move the view's SQL definition from the original migration into the newly-created file in db/views.
  3. In the original migration, delete any drop_view call.
  4. Copy the create_view or update_view line from the scenic migration and substitute it for the old create_view method and block.
  5. Delete the scenic migration file
  6. For the down method, copy the update_view line into the down (replacing any drop_ and create_view methods) and make the version: argument to the same number as the revert_to_version: argument (e.g. update_view :complex_data_view, version: 2, revert_to_version: 1 becomes update_view :complex_data_view, version: 1, revert_to_version: 1)

Development

After checking out the repo, run bin/setup to install dependencies. Then, run rake spec to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/PMACS/scenic_oracle_enhanced_adapter.