activerecord-oracle_enhanced-adapter 1.2.4 → 1.3.0

data/lib/active_record/connection_adapters/oracle_enhanced_schema_definitions.rb

@@ -6,7 +6,8 @@ module ActiveRecord
     class OracleEnhancedSynonymDefinition < Struct.new(:name, :table_owner, :table_name, :db_link) #:nodoc:
     end
 
-    class OracleEnhancedIndexDefinition < Struct.new(:table, :name, :unique, :tablespace, :columns) #:nodoc:
+    class OracleEnhancedIndexDefinition < Struct.new(:table, :name, :unique, :type, :parameters, :statement_parameters,
+      :tablespace, :columns) #:nodoc:
     end
 
     module OracleEnhancedSchemaDefinitions #:nodoc:

data/lib/active_record/connection_adapters/oracle_enhanced_schema_dumper.rb

@@ -11,26 +11,30 @@ module ActiveRecord #:nodoc:
       end
 
       private
-      
+
+      def ignore_table?(table)
+        [ActiveRecord::Migrator.proper_table_name('schema_migrations'), ignore_tables].flatten.any? do |ignored|
+          case ignored
+          when String; table == ignored
+          when Regexp; table =~ ignored
+          else
+            raise StandardError, 'ActiveRecord::SchemaDumper.ignore_tables accepts an array of String and / or Regexp values.'
+          end
+        end
+      end
+
       def tables_with_oracle_enhanced(stream)
-        sorted_tables = @connection.tables.sort
+        return tables_without_oracle_enhanced(stream) unless @connection.respond_to?(:materialized_views)
+        # do not include materialized views in schema dump - they should be created separately after schema creation
+        sorted_tables = (@connection.tables - @connection.materialized_views).sort
         sorted_tables.each do |tbl|
           # add table prefix or suffix for schema_migrations
-          next if [ActiveRecord::Migrator.proper_table_name('schema_migrations'), ignore_tables].flatten.any? do |ignored|
-            case ignored
-            when String; tbl == ignored
-            when Regexp; tbl =~ ignored
-            else
-              raise StandardError, 'ActiveRecord::SchemaDumper.ignore_tables accepts an array of String and / or Regexp values.'
-            end
-          end
+          next if ignore_table? tbl
           # change table name inspect method
           tbl.extend TableInspect
           oracle_enhanced_table(tbl, stream)
           # add primary key trigger if table has it
           primary_key_trigger(tbl, stream)
-        end
-        sorted_tables.each do |tbl|
           # add foreign keys if table has them
           foreign_keys(tbl, stream)
         end
@@ -76,6 +80,7 @@ module ActiveRecord #:nodoc:
         if @connection.respond_to?(:synonyms)
           syns = @connection.synonyms
           syns.each do |syn|
+		        next if ignore_table? syn.name
             table_name = syn.table_name
             table_name = "#{syn.table_owner}.#{table_name}" if syn.table_owner
             table_name = "#{table_name}@#{syn.db_link}" if syn.db_link
@@ -89,14 +94,28 @@ module ActiveRecord #:nodoc:
       def indexes_with_oracle_enhanced(table, stream)
         if (indexes = @connection.indexes(table)).any?
           add_index_statements = indexes.map do |index|
-            # use table.inspect as it will remove prefix and suffix
-            statment_parts = [ ('add_index ' + table.inspect) ]
-            statment_parts << index.columns.inspect
-            statment_parts << (':name => ' + index.name.inspect)
-            statment_parts << ':unique => true' if index.unique
-            statment_parts << ':tablespace => ' + index.tablespace.inspect if index.tablespace
-
-            '  ' + statment_parts.join(', ')
+            case index.type
+            when nil
+              # use table.inspect as it will remove prefix and suffix
+              statement_parts = [ ('add_index ' + table.inspect) ]
+              statement_parts << index.columns.inspect
+              statement_parts << (':name => ' + index.name.inspect)
+              statement_parts << ':unique => true' if index.unique
+              statement_parts << ':tablespace => ' + index.tablespace.inspect if index.tablespace
+            when 'CTXSYS.CONTEXT'
+              if index.statement_parameters
+                statement_parts = [ ('add_context_index ' + table.inspect) ]
+                statement_parts << index.statement_parameters
+              else
+                statement_parts = [ ('add_context_index ' + table.inspect) ]
+                statement_parts << index.columns.inspect
+                statement_parts << (':name => ' + index.name.inspect)
+              end
+            else
+              # unrecognized index type
+              statement_parts = ["# unrecognized index #{index.name.inspect} with type #{index.type.inspect}"]
+            end
+            '  ' + statement_parts.join(', ')
           end
 
           stream.puts add_index_statements.sort.join("\n")

data/lib/active_record/connection_adapters/oracle_enhanced_tasks.rb

@@ -1,5 +1,6 @@
 # implementation idea taken from JDBC adapter
-if defined?(Rake.application) && Rake.application && ActiveRecord::Base.configurations[RAILS_ENV]['adapter'] == 'oracle_enhanced'
+if defined?(Rake.application) && Rake.application &&
+    ActiveRecord::Base.configurations[defined?(Rails.env) ? Rails.env : RAILS_ENV]['adapter'] == 'oracle_enhanced'
   oracle_enhanced_rakefile = File.dirname(__FILE__) + "/oracle_enhanced.rake"
   if Rake.application.lookup("environment")
     # rails tasks already defined; load the override tasks now

data/lib/active_record/connection_adapters/oracle_enhanced_version.rb

@@ -1 +1 @@
-ActiveRecord::ConnectionAdapters::OracleEnhancedAdapter::VERSION = '1.2.3'
+ActiveRecord::ConnectionAdapters::OracleEnhancedAdapter::VERSION = File.read(File.dirname(__FILE__)+'/../../../VERSION').chomp

data/spec/active_record/connection_adapters/oracle_enhanced_adapter_spec.rb

@@ -112,7 +112,7 @@ describe "OracleEnhancedAdapter" do
     before(:all) do
       @conn.execute <<-SQL
         CREATE TABLE test_employees (
-          id            NUMBER,
+          id            NUMBER PRIMARY KEY,
           first_name    VARCHAR2(20),
           last_name     VARCHAR2(25),
           email         VARCHAR2(25),
@@ -180,7 +180,7 @@ describe "OracleEnhancedAdapter" do
       @conn.execute "DROP TABLE test_employees" rescue nil
       @conn.execute <<-SQL
         CREATE TABLE test_employees (
-          id            NUMBER,
+          id            NUMBER PRIMARY KEY,
           first_name    VARCHAR2(20),
           last_name     VARCHAR2(25),
           hire_date     DATE
@@ -198,12 +198,15 @@ describe "OracleEnhancedAdapter" do
     end
 
     before(:each) do
-      @buffer = StringIO.new
-      log_to @buffer
+      set_logger
       @conn = ActiveRecord::Base.connection
       @conn.clear_columns_cache
     end
 
+    after(:each) do
+      clear_logger
+    end
+
     describe "without column caching" do
 
       before(:each) do
@@ -212,14 +215,26 @@ describe "OracleEnhancedAdapter" do
 
       it "should get columns from database at first time" do
         TestEmployee.connection.columns('test_employees').map(&:name).should == @column_names
-        @buffer.string.should =~ /select .* from all_tab_columns/im
+        @logger.logged(:debug).last.should =~ /select .* from all_tab_columns/im
       end
 
       it "should get columns from database at second time" do
         TestEmployee.connection.columns('test_employees')
-        @buffer.truncate(0)
+        @logger.clear(:debug)
         TestEmployee.connection.columns('test_employees').map(&:name).should == @column_names
-        @buffer.string.should =~ /select .* from all_tab_columns/im
+        @logger.logged(:debug).last.should =~ /select .* from all_tab_columns/im
+      end
+
+      it "should get primary key from database at first time" do
+        TestEmployee.connection.pk_and_sequence_for('test_employees').should == ['id', nil]
+        @logger.logged(:debug).last.should =~ /select .* from all_constraints/im
+      end
+
+      it "should get primary key from database at first time" do
+        TestEmployee.connection.pk_and_sequence_for('test_employees').should == ['id', nil]
+        @logger.clear(:debug)
+        TestEmployee.connection.pk_and_sequence_for('test_employees').should == ['id', nil]
+        @logger.logged(:debug).last.should =~ /select .* from all_constraints/im
       end
 
     end
@@ -232,14 +247,26 @@ describe "OracleEnhancedAdapter" do
 
       it "should get columns from database at first time" do
         TestEmployee.connection.columns('test_employees').map(&:name).should == @column_names
-        @buffer.string.should =~ /select .* from all_tab_columns/im
+        @logger.logged(:debug).last.should =~ /select .* from all_tab_columns/im
       end
 
       it "should get columns from cache at second time" do
         TestEmployee.connection.columns('test_employees')
-        @buffer.truncate(0)
+        @logger.clear(:debug)
         TestEmployee.connection.columns('test_employees').map(&:name).should == @column_names
-        @buffer.string.should be_blank
+        @logger.logged(:debug).last.should be_blank
+      end
+
+      it "should get primary key from database at first time" do
+        TestEmployee.connection.pk_and_sequence_for('test_employees').should == ['id', nil]
+        @logger.logged(:debug).last.should =~ /select .* from all_constraints/im
+      end
+
+      it "should get primary key from cache at first time" do
+        TestEmployee.connection.pk_and_sequence_for('test_employees').should == ['id', nil]
+        @logger.clear(:debug)
+        TestEmployee.connection.pk_and_sequence_for('test_employees').should == ['id', nil]
+        @logger.logged(:debug).last.should be_blank
       end
 
     end
@@ -329,6 +356,14 @@ describe "OracleEnhancedAdapter" do
       @adapter.valid_table_name?("sys.v$session").should be_true
     end
 
+    it "should be valid with upcase schema name" do
+      @adapter.valid_table_name?("ABC_123.DEF_456").should be_true
+    end
+
+    it "should be valid with irregular schema name and database links" do
+      @adapter.valid_table_name?('abc$#_123.abc$#_123@abc$#@._123').should be_true
+    end
+
     it "should not be valid with two dots in name" do
       @adapter.valid_table_name?("abc_123.def_456.ghi_789").should be_false
     end
@@ -337,6 +372,30 @@ describe "OracleEnhancedAdapter" do
       @adapter.valid_table_name?("warehouse-things").should be_false
     end
 
+    it "should not be valid with for camel-case" do
+      @adapter.valid_table_name?("Abc").should be_false
+      @adapter.valid_table_name?("aBc").should be_false
+      @adapter.valid_table_name?("abC").should be_false
+    end
+    
+    it "should not be valid for names > 30 characters" do
+      @adapter.valid_table_name?("a" * 31).should be_false
+    end
+    
+    it "should not be valid for schema names > 30 characters" do
+      @adapter.valid_table_name?(("a" * 31) + ".validname").should be_false
+    end
+    
+    it "should not be valid for database links > 128 characters" do
+      @adapter.valid_table_name?("name@" + "a" * 129).should be_false
+    end
+    
+    it "should not be valid for names that do not begin with alphabetic characters" do
+      @adapter.valid_table_name?("1abc").should be_false
+      @adapter.valid_table_name?("_abc").should be_false
+      @adapter.valid_table_name?("abc.1xyz").should be_false
+      @adapter.valid_table_name?("abc._xyz").should be_false
+    end
   end
 
   describe "table quoting" do
@@ -415,7 +474,7 @@ describe "OracleEnhancedAdapter" do
       @db_link_password = SYSTEM_CONNECTION_PARAMS[:password]
       @db_link_database = SYSTEM_CONNECTION_PARAMS[:database]
       @conn.execute "DROP DATABASE LINK #{@db_link}" rescue nil
-      @conn.execute "CREATE DATABASE LINK #{@db_link} CONNECT TO #{@db_link_username} IDENTIFIED BY #{@db_link_password} USING '#{@db_link_database}'"
+      @conn.execute "CREATE DATABASE LINK #{@db_link} CONNECT TO #{@db_link_username} IDENTIFIED BY \"#{@db_link_password}\" USING '#{@db_link_database}'"
       @conn.execute "CREATE OR REPLACE SYNONYM test_posts FOR test_posts@#{@db_link}"
       @conn.execute "CREATE OR REPLACE SYNONYM test_posts_seq FOR test_posts_seq@#{@db_link}"
       class ::TestPost < ActiveRecord::Base

data/spec/active_record/connection_adapters/oracle_enhanced_adapter_structure_dumper_spec.rb

@@ -58,7 +58,7 @@ describe "OracleEnhancedAdapter structure dump" do
       SQL
       dump = ActiveRecord::Base.connection.structure_dump_fk_constraints
       dump.split('\n').length.should == 1
-      dump.should =~ /ALTER TABLE TEST_POSTS ADD CONSTRAINT fk_test_post_foo FOREIGN KEY \(foo_id\) REFERENCES foos\(id\)/
+      dump.should =~ /ALTER TABLE \"?TEST_POSTS\"? ADD CONSTRAINT \"?FK_TEST_POST_FOO\"? FOREIGN KEY \(\"?FOO_ID\"?\) REFERENCES \"?FOOS\"?\(\"?ID\"?\)/i
     end
   
     it "should not error when no foreign keys are present" do
@@ -78,7 +78,7 @@ describe "OracleEnhancedAdapter structure dump" do
         END;
       SQL
       dump = ActiveRecord::Base.connection.structure_dump_db_stored_code.gsub(/\n|\s+/,' ')
-      dump.should =~ /create or replace TRIGGER TEST_POST_TRIGGER/
+      dump.should =~ /CREATE OR REPLACE TRIGGER TEST_POST_TRIGGER/
     end
   
     it "should dump types" do
@@ -86,7 +86,7 @@ describe "OracleEnhancedAdapter structure dump" do
         create or replace TYPE TEST_TYPE AS TABLE OF VARCHAR2(10);
       SQL
       dump = ActiveRecord::Base.connection.structure_dump_db_stored_code.gsub(/\n|\s+/,' ')
-      dump.should =~ /create or replace TYPE TEST_TYPE/
+      dump.should =~ /CREATE OR REPLACE TYPE TEST_TYPE/
     end
   
     it "should dump virtual columns" do
@@ -99,7 +99,7 @@ describe "OracleEnhancedAdapter structure dump" do
         )
       SQL
       dump = ActiveRecord::Base.connection.structure_dump
-      dump.should =~ /id_plus number GENERATED ALWAYS AS \(ID\+2\) VIRTUAL/
+      dump.should =~ /ID_PLUS NUMBER GENERATED ALWAYS AS \(ID\+2\) VIRTUAL/
     end
   
     it "should dump unique keys" do
@@ -124,9 +124,9 @@ describe "OracleEnhancedAdapter structure dump" do
       SQL
       
       dump = ActiveRecord::Base.connection.structure_dump
-      dump.should =~ /create unique index ix_test_posts_foo_id on test_posts \(foo_id\)/i
-      dump.should =~ /create  index ix_test_posts_foo on test_posts \(foo\)/i
-      dump.should_not =~ /create unique index uk_test_posts_/i
+      dump.should =~ /CREATE UNIQUE INDEX "?IX_TEST_POSTS_FOO_ID"? ON "?TEST_POSTS"? \("?FOO_ID"?\)/i
+      dump.should =~ /CREATE  INDEX "?IX_TEST_POSTS_FOO\"? ON "?TEST_POSTS"? \("?FOO"?\)/i
+      dump.should_not =~ /CREATE UNIQUE INDEX "?UK_TEST_POSTS_/i
     end
   end
   describe "temporary tables" do
@@ -138,7 +138,7 @@ describe "OracleEnhancedAdapter structure dump" do
         t.integer :post_id
       end
       dump = ActiveRecord::Base.connection.structure_dump
-      dump.should =~ /create global temporary table test_comments/i
+      dump.should =~ /CREATE GLOBAL TEMPORARY TABLE "?TEST_COMMENTS"?/i
     end
   end
 
@@ -173,8 +173,8 @@ describe "OracleEnhancedAdapter structure dump" do
     end
     it "should dump drop sql for just temp tables" do
       dump = @conn.temp_table_drop
-      dump.should =~ /drop table temp_tbl/i
-      dump.should_not =~ /drop table not_temp_tbl/i
+      dump.should =~ /DROP TABLE "TEMP_TBL"/
+      dump.should_not =~ /DROP TABLE "?NOT_TEMP_TBL"?/i
     end
     after(:each) do
       @conn.drop_table :temp_tbl 
@@ -194,6 +194,10 @@ describe "OracleEnhancedAdapter structure dump" do
       @conn.execute <<-SQL
         create or replace view full_drop_test_view (foo) as select id as "foo" from full_drop_test
       SQL
+      #materialized view
+      @conn.execute <<-SQL
+        create materialized view full_drop_test_mview (foo) as select id as "foo" from full_drop_test
+      SQL
       #package
       @conn.execute <<-SQL
         create or replace package full_drop_test_package as
@@ -241,6 +245,7 @@ describe "OracleEnhancedAdapter structure dump" do
       @conn.drop_table :full_drop_test
       @conn.drop_table :full_drop_test_temp
       @conn.execute "DROP VIEW FULL_DROP_TEST_VIEW" rescue nil
+      @conn.execute "DROP MATERIALIZED VIEW FULL_DROP_TEST_MVIEW" rescue nil
       @conn.execute "DROP SYNONYM FULL_DROP_TEST_SYNONYM" rescue nil
       @conn.execute "DROP PACKAGE FULL_DROP_TEST_PACKAGE" rescue nil
       @conn.execute "DROP FUNCTION FULL_DROP_TEST_FUNCTION" rescue nil
@@ -249,19 +254,21 @@ describe "OracleEnhancedAdapter structure dump" do
     end
     it "should contain correct sql" do
       drop = @conn.full_drop
-      drop.should =~ /drop table full_drop_test cascade constraints/i
-      drop.should =~ /drop sequence full_drop_test_seq/i
-      drop.should =~ /drop view "full_drop_test_view"/i
-      drop.should =~ /drop package full_drop_test_package/i
-      drop.should =~ /drop function full_drop_test_function/i
-      drop.should =~ /drop procedure full_drop_test_procedure/i
-      drop.should =~ /drop synonym "full_drop_test_synonym"/i
-      drop.should =~ /drop type "full_drop_test_type"/i
+      drop.should =~ /DROP TABLE "FULL_DROP_TEST" CASCADE CONSTRAINTS/
+      drop.should =~ /DROP SEQUENCE "FULL_DROP_TEST_SEQ"/
+      drop.should =~ /DROP VIEW "FULL_DROP_TEST_VIEW"/
+      drop.should_not =~ /DROP TABLE "?FULL_DROP_TEST_MVIEW"?/i
+      drop.should =~ /DROP MATERIALIZED VIEW "FULL_DROP_TEST_MVIEW"/
+      drop.should =~ /DROP PACKAGE "FULL_DROP_TEST_PACKAGE"/
+      drop.should =~ /DROP FUNCTION "FULL_DROP_TEST_FUNCTION"/
+      drop.should =~ /DROP PROCEDURE "FULL_DROP_TEST_PROCEDURE"/
+      drop.should =~ /DROP SYNONYM "FULL_DROP_TEST_SYNONYM"/
+      drop.should =~ /DROP TYPE "FULL_DROP_TEST_TYPE"/
     end
     it "should not drop tables when preserve_tables is true" do
       drop = @conn.full_drop(true)
-      drop.should =~ /drop table full_drop_test_temp/i
-      drop.should_not =~ /drop table full_drop_test cascade constraints/i
+      drop.should =~ /DROP TABLE "FULL_DROP_TEST_TEMP"/
+      drop.should_not =~ /DROP TABLE "?FULL_DROP_TEST"? CASCADE CONSTRAINTS/i
     end
   end
 end

data/spec/active_record/connection_adapters/oracle_enhanced_context_index_spec.rb

@@ -0,0 +1,334 @@
+require File.expand_path(File.dirname(__FILE__) + '/../../spec_helper')
+
+describe "OracleEnhancedAdapter context index" do
+  include SchemaSpecHelper
+  include LoggerSpecHelper
+
+  def create_table_posts
+    schema_define do
+      create_table :posts, :force => true do |t|
+        t.string :title
+        t.text :body
+        t.integer :comments_count
+        t.timestamps
+        t.string :all_text, :limit => 2 # will be used for multi-column index
+      end
+    end
+  end
+
+  def create_table_comments
+    schema_define do
+      create_table :comments, :force => true do |t|
+        t.integer :post_id
+        t.string :author
+        t.text :body
+        t.timestamps
+      end
+    end
+  end
+
+  def create_tables
+    create_table_posts
+    create_table_comments
+  end
+
+  def drop_table_posts
+    schema_define { drop_table :posts }
+  end
+
+  def drop_table_comments
+    schema_define { drop_table :comments }
+  end
+
+  def drop_tables
+    drop_table_comments
+    drop_table_posts
+  end
+
+  before(:all) do
+    # database user should have CTXAPP role to be able to set CONTEXT index parameters
+    ActiveRecord::Base.establish_connection(CONNECTION_PARAMS)
+    @conn = ActiveRecord::Base.connection
+  end
+
+  describe "on single table" do
+    before(:all) do
+      @title_words = %w{aaa bbb ccc}
+      @body_words = %w{foo bar baz}
+      create_table_posts
+      class ::Post < ActiveRecord::Base
+        has_context_index
+      end
+      @post0 = Post.create(:title => "dummy title", :body => "dummy body")
+      @post1 = Post.create(:title => @title_words.join(' '), :body => @body_words.join(' '))
+      @post2 = Post.create(:title => (@title_words*2).join(' '), :body => (@body_words*2).join(' '))
+    end
+
+    after(:all) do
+      drop_table_posts
+      Object.send(:remove_const, "Post")
+    end
+
+    after(:each) do
+      @post.destroy if @post
+    end
+
+    it "should create single VARCHAR2 column index" do
+      @conn.add_context_index :posts, :title
+      @title_words.each do |word|
+        Post.contains(:title, word).all.should == [@post2, @post1]
+      end
+      @conn.remove_context_index :posts, :title
+    end
+
+    it "should create single CLOB column index" do
+      @conn.add_context_index :posts, :body
+      @body_words.each do |word|
+        Post.contains(:body, word).all.should == [@post2, @post1]
+      end
+      @conn.remove_context_index :posts, :body
+    end
+
+    it "should not include text index secondary tables in user tables list" do
+      @conn.add_context_index :posts, :title
+      @conn.tables.any?{|t| t =~ /^dr\$/i}.should be_false
+      @conn.remove_context_index :posts, :title
+    end
+
+    it "should create multiple column index" do
+      @conn.add_context_index :posts, [:title, :body]
+      (@title_words+@body_words).each do |word|
+        Post.contains(:title, word).all.should == [@post2, @post1]
+      end
+      @conn.remove_context_index :posts, [:title, :body]
+    end
+
+    it "should create multiple column index with specified main index column" do
+      @conn.add_context_index :posts, [:title, :body],
+        :index_column => :all_text, :sync => 'ON COMMIT'
+      @post = Post.create(:title => "abc", :body => "def")
+      Post.contains(:all_text, "abc").all.should == [@post]
+      Post.contains(:all_text, "def").all.should == [@post]
+      @post.update_attributes!(:title => "ghi")
+      # index will not be updated as all_text column is not changed
+      Post.contains(:all_text, "ghi").all.should be_empty
+      @post.update_attributes!(:all_text => "1")
+      # index will be updated when all_text column is changed
+      Post.contains(:all_text, "ghi").all.should == [@post]
+      @conn.remove_context_index :posts, :index_column => :all_text
+    end
+
+    it "should create multiple column index with trigger updated main index column" do
+      @conn.add_context_index :posts, [:title, :body],
+        :index_column => :all_text, :index_column_trigger_on => [:created_at, :updated_at],
+        :sync => 'ON COMMIT'
+      @post = Post.create(:title => "abc", :body => "def")
+      Post.contains(:all_text, "abc").all.should == [@post]
+      Post.contains(:all_text, "def").all.should == [@post]
+      @post.update_attributes!(:title => "ghi")
+      # index should be updated as created_at column is changed
+      Post.contains(:all_text, "ghi").all.should == [@post]
+      @conn.remove_context_index :posts, :index_column => :all_text
+    end
+
+  end
+
+  describe "on multiple tables" do
+    before(:all) do
+      create_tables
+      class ::Post < ActiveRecord::Base
+        has_many :comments, :dependent => :destroy
+        has_context_index
+      end
+      class ::Comment < ActiveRecord::Base
+        belongs_to :post, :counter_cache => true
+      end
+    end
+
+    after(:all) do
+      drop_tables
+      Object.send(:remove_const, "Comment")
+      Object.send(:remove_const, "Post")
+    end
+
+    after(:each) do
+      Post.destroy_all
+    end
+
+    it "should create multiple table index with specified main index column" do
+      @conn.add_context_index :posts,
+        [:title, :body,
+        # specify aliases always with AS keyword
+        "SELECT comments.author AS comment_author, comments.body AS comment_body FROM comments WHERE comments.post_id = :id"
+        ],
+        :name => 'post_and_comments_index',
+        :index_column => :all_text, :index_column_trigger_on => [:updated_at, :comments_count],
+        :sync => 'ON COMMIT'
+      @post = Post.create!(:title => "aaa", :body => "bbb")
+      @post.comments.create!(:author => "ccc", :body => "ddd")
+      @post.comments.create!(:author => "eee", :body => "fff")
+      ["aaa", "bbb", "ccc", "ddd", "eee", "fff"].each do |word|
+        Post.contains(:all_text, word).all.should == [@post]
+      end
+      @conn.remove_context_index :posts, :name => 'post_and_comments_index'
+    end
+
+    it "should find by search term within specified field" do
+      @post = Post.create!(:title => "aaa", :body => "bbb")
+      @post.comments.create!(:author => "ccc", :body => "ddd")
+      @conn.add_context_index :posts,
+        [:title, :body,
+        # specify aliases always with AS keyword
+        "SELECT comments.author AS comment_author, comments.body AS comment_body FROM comments WHERE comments.post_id = :id"
+        ],
+        :index_column => :all_text
+      Post.contains(:all_text, "aaa within title").all.should == [@post]
+      Post.contains(:all_text, "aaa within body").all.should be_empty
+      Post.contains(:all_text, "bbb within body").all.should == [@post]
+      Post.contains(:all_text, "bbb within title").all.should be_empty
+      Post.contains(:all_text, "ccc within comment_author").all.should == [@post]
+      Post.contains(:all_text, "ccc within comment_body").all.should be_empty
+      Post.contains(:all_text, "ddd within comment_body").all.should == [@post]
+      Post.contains(:all_text, "ddd within comment_author").all.should be_empty
+      @conn.remove_context_index :posts, :index_column => :all_text
+    end
+
+  end
+
+  describe "with specified tablespace" do
+    before(:all) do
+      create_table_posts
+      class ::Post < ActiveRecord::Base
+        has_context_index
+      end
+      @post = Post.create(:title => 'aaa', :body => 'bbb')
+      @tablespace = @conn.default_tablespace
+      set_logger
+      @conn = ActiveRecord::Base.connection
+    end
+
+    after(:all) do
+      drop_table_posts
+      Object.send(:remove_const, "Post")
+    end
+
+    after(:each) do
+      clear_logger
+    end
+
+    def verify_logged_statements
+      ['K_TABLE_CLAUSE', 'R_TABLE_CLAUSE', 'N_TABLE_CLAUSE', 'I_INDEX_CLAUSE', 'P_TABLE_CLAUSE'].each do |clause|
+        @logger.output(:debug).should =~ /CTX_DDL\.SET_ATTRIBUTE\('index_posts_on_title_sto', '#{clause}', '.*TABLESPACE #{@tablespace}'\)/
+      end
+      @logger.output(:debug).should =~ /CREATE INDEX .* PARAMETERS \('STORAGE index_posts_on_title_sto'\)/
+    end
+
+    it "should create index on single column" do
+      @conn.add_context_index :posts, :title, :tablespace => @tablespace
+      verify_logged_statements
+      Post.contains(:title, 'aaa').all.should == [@post]
+      @conn.remove_context_index :posts, :title
+    end
+
+    it "should create index on multiple columns" do
+      @conn.add_context_index :posts, [:title, :body], :name => 'index_posts_text', :tablespace => @conn.default_tablespace
+      verify_logged_statements
+      Post.contains(:title, 'aaa AND bbb').all.should == [@post]
+      @conn.remove_context_index :posts, :name => 'index_posts_text'
+    end
+
+  end
+
+  describe "schema dump" do
+
+    def standard_dump
+      stream = StringIO.new
+      ActiveRecord::SchemaDumper.ignore_tables = []
+      ActiveRecord::SchemaDumper.dump(ActiveRecord::Base.connection, stream)
+      stream.string
+    end
+
+    describe "without table prefixe and suffix" do
+
+      before(:all) do
+        create_tables
+      end
+
+      after(:all) do
+        drop_tables
+      end
+
+      it "should dump definition of single column index" do
+        @conn.add_context_index :posts, :title
+        standard_dump.should =~ /add_context_index "posts", \["title"\], :name => \"index_posts_on_title\"$/
+        @conn.remove_context_index :posts, :title
+      end
+
+      it "should dump definition of multiple column index" do
+        @conn.add_context_index :posts, [:title, :body]
+        standard_dump.should =~ /add_context_index "posts", \[:title, :body\]$/
+        @conn.remove_context_index :posts, [:title, :body]
+      end
+
+      it "should dump definition of multiple table index with options" do
+        options = {
+          :name => 'post_and_comments_index',
+          :index_column => :all_text, :index_column_trigger_on => :updated_at,
+          :sync => 'ON COMMIT'
+        }
+        @conn.add_context_index :posts,
+          [:title, :body,
+          "SELECT comments.author AS comment_author, comments.body AS comment_body FROM comments WHERE comments.post_id = :id"
+          ], options
+        standard_dump.should =~ /add_context_index "posts", \[:title, :body, "SELECT comments.author AS comment_author, comments.body AS comment_body FROM comments WHERE comments.post_id = :id"\], #{options.inspect[1..-2]}$/
+        @conn.remove_context_index :posts, :name => 'post_and_comments_index'
+      end
+
+    end
+
+    describe "with table prefix and suffix" do
+      before(:all) do
+        ActiveRecord::Base.table_name_prefix = 'xxx_'
+        ActiveRecord::Base.table_name_suffix = '_xxx'
+        create_tables
+      end
+
+      after(:all) do
+        drop_tables
+        ActiveRecord::Base.table_name_prefix = ''
+        ActiveRecord::Base.table_name_suffix = ''
+      end
+
+      it "should dump definition of single column index" do
+        schema_define { add_context_index :posts, :title }
+        standard_dump.should =~ /add_context_index "posts", \["title"\], :name => "i_xxx_posts_xxx_title"$/
+        schema_define { remove_context_index :posts, :title }
+      end
+
+      it "should dump definition of multiple column index" do
+        schema_define { add_context_index :posts, [:title, :body] }
+        standard_dump.should =~ /add_context_index "posts", \[:title, :body\]$/
+        schema_define { remove_context_index :posts, [:title, :body] }
+      end
+
+      it "should dump definition of multiple table index with options" do
+        options = {
+          :name => 'xxx_post_and_comments_i',
+          :index_column => :all_text, :index_column_trigger_on => :updated_at,
+          :sync => 'ON COMMIT'
+        }
+        schema_define do
+          add_context_index :posts,
+            [:title, :body,
+            "SELECT comments.author AS comment_author, comments.body AS comment_body FROM comments WHERE comments.post_id = :id"
+            ], options
+        end
+        standard_dump.should =~ /add_context_index "posts", \[:title, :body, "SELECT comments.author AS comment_author, comments.body AS comment_body FROM comments WHERE comments.post_id = :id"\], #{options.inspect[1..-2]}$/
+        schema_define { remove_context_index :posts, :name => 'xxx_post_and_comments_i' }
+      end
+
+    end
+
+  end
+
+end