partitioned 1.1.10 → 1.1.11

data/.gitignore

@@ -0,0 +1,2 @@
+.ruby-version
+Gemfile.lock

data/Gemfile

@@ -1,17 +1,3 @@
 source "http://rubygems.org"
 
-# Declare your gem's dependencies in partitioned.gemspec.
-# Bundler will treat runtime dependencies like base dependencies, and
-# development dependencies will be added by default to the :development group.
-gemspec
-
-# jquery-rails is used by the dummy application
-gem "jquery-rails"
-
-# Declare any dependencies that are still in development here instead of in
-# your gemspec. These might include edge Rails or gems from your path or
-# Git. Remember to move these dependencies to your gemspec before releasing
-# your gem to rubygems.org.
-
-# To use debugger
-# gem 'ruby-debug'
+gemspec

data/{README → README.md}

@@ -1,5 +1,4 @@
-Partitioned
-===========
+# Partitioned
 
 Partitioned adds assistance to ActiveRecord for manipulating (reading,
 creating, updating) an activerecord model that represents data that
@@ -26,83 +25,109 @@ provides streamlined targeted access to the desired data.
 Support for bulk inserts and bulk updates is also provided via
 Partitioned::Base.create_many and Partitioned::Base.update_many.
 
-Example
-=======
+## Example
 
-Given the following models:
 
-  class Company < ActiveRecord::Base
-  end
+Given the following models:
 
-  class ByCompanyId < Partitioned::ByForeignKey
-    self.abstract_class = true
+```ruby
+class Company < ActiveRecord::Base
+end
 
-    belongs_to :company
+class ByCompanyId < Partitioned::ByForeignKey
+  self.abstract_class = true
 
-    def self.partition_foreign_key
-      return :company_id
-    end
+  belongs_to :company
 
-    partitioned do |partition|
-      partition.index :id, :unique => true
-    end
+  def self.partition_foreign_key
+    return :company_id
   end
 
-  class Employee < ByCompanyId
+  partitioned do |partition|
+    partition.index :id, :unique => true
   end
+end
+
+class Employee < ByCompanyId
+end
+```
 
 and the following tables:
 
-  -- this is the referenced table
-  create table companies
-  (
-      id               serial not null primary key,
-      created_at       timestamp not null default now(),
-      updated_at       timestamp,
-      name             text null
-  );
-
-  -- add some companies
-  insert into table companies (name) values
-    ('company 1'),('company 2'),('company 2');
-
-  -- this is the parent table
-  create table employees
-  (
-      id               serial not null primary key,
-      created_at       timestamp not null default now(),
-      updated_at       timestamp,
-      name             text null,
-      company_id       integer not null references companies
-  );
+```sql
+-- this is the referenced table
+create table companies
+(
+    id               serial not null primary key,
+    created_at       timestamp not null default now(),
+    updated_at       timestamp,
+    name             text null
+);
+
+-- add some companies
+insert into table companies (name) values
+  ('company 1'),('company 2'),('company 2');
+
+-- this is the parent table
+create table employees
+(
+    id               serial not null primary key,
+    created_at       timestamp not null default now(),
+    updated_at       timestamp,
+    name             text null,
+    company_id       integer not null references companies
+);
+```
 
 We now need to create some infrastructure for partitioned tables,
 in particular, we create a schema to hold the child partition
 tables of employees.
 
-  Employee.create_infrastructure
+```ruby
+Employee.create_infrastructure
+```
 
 Which creates the employees_partitions schema using the following SQL:
 
-  create schema employees_partitions;
+```sql
+create schema employees_partitions;
+```
 
 NOTE: We also install protections on the employees table so it isn't
 used as a data table (this SQL is not presented for simplicity but is
 apart of the create_infrastructure call).
 
+You can create migration for this Employee in this case:
+
+```ruby
+class CreatePartitionEmployee < ActiveRecord::Migration
+  def up
+    Employee.create_infrastructure
+  end
+
+  def down
+    Employee.delete_infrastructure
+  end
+end
+```
+
 To add child tables we use the create_new_partitions_tables method:
 
-  company_ids = Company.all.map(&:id)
-  Employee.create_new_partition_tables(company_ids)
+```ruby
+company_ids = Company.all.map(&:id)
+Employee.create_new_partition_tables(company_ids)
+```
 
 which results in the following SQL:
 
-  create table employees_partitions.p1
-    ( CHECK ( company_id = 1 ) ) INHERITS (employees);
-  create table employees_partitions.p2
-    ( CHECK ( company_id = 2 ) ) INHERITS (employees);
-  create table employees_partitions.p3
-    ( CHECK ( company_id = 3 ) ) INHERITS (employees);
+```sql
+create table employees_partitions.p1
+  ( CHECK ( company_id = 1 ) ) INHERITS (employees);
+create table employees_partitions.p2
+  ( CHECK ( company_id = 2 ) ) INHERITS (employees);
+create table employees_partitions.p3
+  ( CHECK ( company_id = 3 ) ) INHERITS (employees);
+```
 
 NOTE: Some other SQL is generated in the above example, specifically
 the reference to the companies table needs to be explicitly created
@@ -117,13 +142,22 @@ inserts of the EMPLOYEES table redirect the record insert into the
 specific child table determined by the value of COMPANY_ID
 
 eg:
-  employee = Employee.create(:name => 'Keith', :company_id => 1)
+
+```ruby
+employee = Employee.create(:name => 'Keith', :company_id => 1)
+```
 
 this would normally produce the following:
-  INSERT INTO employees ('name', company_id) values ('Keith', 1);
+
+```sql
+INSERT INTO employees ('name', company_id) values ('Keith', 1);
+```
 
 but with Partitioned we see:
-  INSERT INTO employees_partitions.p1 ('name', company_id) values ('Keith', 1);
+
+```sql
+INSERT INTO employees_partitions.p1 ('name', company_id) values ('Keith', 1);
+```
 
 reads of such a table need some assistance to find the specific child
 table the record exists in.
@@ -134,15 +168,19 @@ search all child table for the specific record we are looking for.
 
 This is no longer valid (well, doesn't perform well):
 
-  employee = Employee.find(1)
+```ruby
+employee = Employee.find(1)
+```
 
 instead, do one of the following:
 
-  employee = Employee.from_partition(1).find(1)
-  employee = Employee.find(:first,
-                           :conditions => {:name => 'Keith', :company_id => 1})
-  employee = Employee.find(:first,
-                           :conditions => {:id => 1, :company_id => 1})
+```ruby
+employee = Employee.from_partition(1).find(1)
+employee = Employee.find(:first,
+                         :conditions => {:name => 'Keith', :company_id => 1})
+employee = Employee.find(:first,
+                         :conditions => {:id => 1, :company_id => 1})
+```
 
 an update (employee.save where the record already exists in the
 database) will take advantage of knowing which child table the record
@@ -150,11 +188,23 @@ exists in so it can do some optimization.
 
 so, the following works as expected:
 
-  employee.name = "Not Keith"
-  employee.save
+```ruby
+employee.name = "Not Keith"
+employee.save
+```
 
 turns into the following SQL:
 
-  update employees_partitions.p1 set name = 'Not Keith' where id = 1;
+```sql
+update employees_partitions.p1 set name = 'Not Keith' where id = 1;
+```
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request
 
 Copyright 2010-2012 fiksu.com, inc, all rights reserved

data/lib/partitioned/partitioned_base/partition_manager.rb

@@ -67,6 +67,14 @@ module Partitioned
         add_parent_table_rules
       end
 
+      #
+      # The once called function to drop a parent the schema.
+      #
+      def delete_infrastructure
+        drop_partition_schema
+        remove_parent_table_rules
+      end
+
       #
       # An array of key values (each key value is an array of keys) that represent
       # the child partitions that should be created.
@@ -173,8 +181,8 @@ module Partitioned
       extend Forwardable
       def_delegators :parent_table_class, :sql_adapter, :configurator
       def_delegators :sql_adapter, :drop_partition_table, :create_partition_table, :add_partition_table_index,
-         :add_references_to_partition_table, :create_partition_schema, :add_parent_table_rules,
-         :partition_table_name, :partition_table_alias_name
+         :add_references_to_partition_table, :create_partition_schema, :drop_partition_schema, :add_parent_table_rules,
+         :remove_parent_table_rules, :partition_table_name, :partition_table_alias_name
 
     end
   end

data/lib/partitioned/partitioned_base/sql_adapter.rb

@@ -44,6 +44,15 @@ module Partitioned
         create_schema(configurator.schema_name, :unless_exists => true)
       end
 
+      #
+      # Child tables whose parent table is 'foos', typically exist in a schema named foos_partitions.
+      #
+      # *partition_key_values are needed here to support the use of multiple schemas to keep tables in.
+      #
+      def drop_partition_schema(*partition_key_values)
+        drop_schema(configurator.schema_name, :cascade => true)
+      end
+
       #
       # Does a specific child partition exist.
       #
@@ -119,6 +128,18 @@ module Partitioned
         execute(sql)
       end
 
+      #
+      # Used to drop the parent table rule.
+      #
+      def remove_parent_table_rules(*partition_key_values)
+        insert_redirector_name = parent_table_rule_name("insert", "redirector", *partition_key_values)
+        sql = <<-SQL
+          DROP RULE #{insert_redirector_name}
+            ON INSERT CASCADE
+        SQL
+        execute(sql)
+      end
+
       #
       # The name of the table (schemaname.childtablename) given the check constraint values.
       #

data/lib/partitioned/version.rb

@@ -1,4 +1,4 @@
 module Partitioned
   # the current version of this gem
-  VERSION = "1.1.10"
+  VERSION = "1.1.11"
 end

data/partitioned.gemspec

@@ -4,21 +4,24 @@ $LOAD_PATH.push File.expand_path("../lib", __FILE__)
 require "partitioned/version"
 
 Gem::Specification.new do |s|
- s.name        = 'partitioned'
- s.version     = Partitioned::VERSION
- s.license     = 'New BSD License'
- s.date        = '2013-04-25'
- s.summary     = "Postgres table partitioning support for ActiveRecord."
- s.description = "A gem providing support for table partitioning in ActiveRecord. Support is available for postgres and AWS RedShift databases. Other features include child table management (creation and deletion) and bulk data creating and updating."
- s.authors     = ["Keith Gabryelski", "Aleksandr Dembskiy", "Edward Slavich"]
- s.email       = 'keith@fiksu.com'
- s.files       = `git ls-files`.split("\n")
- s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
- s.require_path = 'lib'
- s.homepage    = 'http://github.com/fiksu/partitioned'
- s.add_dependency 'pg'
- s.add_dependency 'rails', '>= 3.2.8'
- s.add_dependency 'rspec-rails'
- s.add_dependency 'bulk_data_methods', '1.0.0'
- s.add_dependency 'activerecord-redshift-adapter'
+  s.name           = 'partitioned'
+  s.version        = Partitioned::VERSION
+  s.license        = 'New BSD License'
+  s.date           = '2013-04-29'
+  s.summary        = "Postgres table partitioning support for ActiveRecord."
+  s.description    = "A gem providing support for table partitioning in ActiveRecord. Support is available for postgres and AWS RedShift databases. Other features include child table management (creation and deletion) and bulk data creating and updating."
+  s.authors        = ["Keith Gabryelski", "Aleksandr Dembskiy", "Edward Slavich"]
+  s.email          = 'keith@fiksu.com'
+  s.files          = `git ls-files`.split("\n")
+  s.test_files     = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.require_path   = 'lib'
+  s.homepage       = 'http://github.com/fiksu/partitioned'
+
+  s.add_development_dependency "jquery-rails"
+
+  s.add_dependency 'pg'
+  s.add_dependency 'rails', '>= 3.2.8'
+  s.add_dependency 'rspec-rails'
+  s.add_dependency 'bulk_data_methods', '1.0.0'
+  s.add_dependency 'activerecord-redshift-adapter'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: partitioned
 version: !ruby/object:Gem::Version
-  version: 1.1.10
+  version: 1.1.11
   prerelease: 
 platform: ruby
 authors:
@@ -11,8 +11,24 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-04-25 00:00:00.000000000 Z
+date: 2013-04-29 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: jquery-rails
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: pg
   requirement: !ruby/object:Gem::Requirement
@@ -101,12 +117,12 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- .gitignore
 - .rspec
 - Gemfile
-- Gemfile.lock
 - LICENSE
 - PARTITIONING_EXPLAINED.txt
-- README
+- README.md
 - Rakefile
 - examples/README
 - examples/company_id.rb
@@ -220,7 +236,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.25
+rubygems_version: 1.8.24
 signing_key: 
 specification_version: 3
 summary: Postgres table partitioning support for ActiveRecord.

data/Gemfile.lock

@@ -1,120 +0,0 @@
-PATH
-  remote: .
-  specs:
-    partitioned (1.1.9)
-      activerecord-redshift-adapter
-      bulk_data_methods (= 1.0.0)
-      pg
-      rails (>= 3.2.8)
-      rspec-rails
-
-GEM
-  remote: http://rubygems.org/
-  specs:
-    actionmailer (3.2.13)
-      actionpack (= 3.2.13)
-      mail (~> 2.5.3)
-    actionpack (3.2.13)
-      activemodel (= 3.2.13)
-      activesupport (= 3.2.13)
-      builder (~> 3.0.0)
-      erubis (~> 2.7.0)
-      journey (~> 1.0.4)
-      rack (~> 1.4.5)
-      rack-cache (~> 1.2)
-      rack-test (~> 0.6.1)
-      sprockets (~> 2.2.1)
-    activemodel (3.2.13)
-      activesupport (= 3.2.13)
-      builder (~> 3.0.0)
-    activerecord (3.2.13)
-      activemodel (= 3.2.13)
-      activesupport (= 3.2.13)
-      arel (~> 3.0.2)
-      tzinfo (~> 0.3.29)
-    activerecord-redshift-adapter (0.9.0)
-      pg
-      rails (>= 3.0.0)
-    activeresource (3.2.13)
-      activemodel (= 3.2.13)
-      activesupport (= 3.2.13)
-    activesupport (3.2.13)
-      i18n (= 0.6.1)
-      multi_json (~> 1.0)
-    arel (3.0.2)
-    builder (3.0.4)
-    bulk_data_methods (1.0.0)
-      pg
-      rails (>= 3.0.0)
-      rspec-rails
-    diff-lcs (1.2.4)
-    erubis (2.7.0)
-    hike (1.2.2)
-    i18n (0.6.1)
-    journey (1.0.4)
-    jquery-rails (2.2.1)
-      railties (>= 3.0, < 5.0)
-      thor (>= 0.14, < 2.0)
-    json (1.7.7)
-    mail (2.5.3)
-      i18n (>= 0.4.0)
-      mime-types (~> 1.16)
-      treetop (~> 1.4.8)
-    mime-types (1.23)
-    multi_json (1.7.2)
-    pg (0.15.1)
-    polyglot (0.3.3)
-    rack (1.4.5)
-    rack-cache (1.2)
-      rack (>= 0.4)
-    rack-ssl (1.3.3)
-      rack
-    rack-test (0.6.2)
-      rack (>= 1.0)
-    rails (3.2.13)
-      actionmailer (= 3.2.13)
-      actionpack (= 3.2.13)
-      activerecord (= 3.2.13)
-      activeresource (= 3.2.13)
-      activesupport (= 3.2.13)
-      bundler (~> 1.0)
-      railties (= 3.2.13)
-    railties (3.2.13)
-      actionpack (= 3.2.13)
-      activesupport (= 3.2.13)
-      rack-ssl (~> 1.3.2)
-      rake (>= 0.8.7)
-      rdoc (~> 3.4)
-      thor (>= 0.14.6, < 2.0)
-    rake (10.0.4)
-    rdoc (3.12.2)
-      json (~> 1.4)
-    rspec-core (2.13.1)
-    rspec-expectations (2.13.0)
-      diff-lcs (>= 1.1.3, < 2.0)
-    rspec-mocks (2.13.1)
-    rspec-rails (2.13.0)
-      actionpack (>= 3.0)
-      activesupport (>= 3.0)
-      railties (>= 3.0)
-      rspec-core (~> 2.13.0)
-      rspec-expectations (~> 2.13.0)
-      rspec-mocks (~> 2.13.0)
-    sprockets (2.2.2)
-      hike (~> 1.2)
-      multi_json (~> 1.0)
-      rack (~> 1.0)
-      tilt (~> 1.1, != 1.3.0)
-    thor (0.18.1)
-    tilt (1.3.7)
-    treetop (1.4.12)
-      polyglot
-      polyglot (>= 0.3.1)
-    tzinfo (0.3.37)
-
-PLATFORMS
-  ruby
-
-DEPENDENCIES
-  jquery-rails
-  partitioned!