sequel-schema-sharding 0.4.1 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: f7c70c9f4005f27bb6c64ab8f666d8d6238aee84
-  data.tar.gz: 9c867fc8fdf0e585579c184aeb6c77ce85b90b07
+  metadata.gz: d2dce85ba1914970e81126721a1bfd51d6b9208d
+  data.tar.gz: 0376b7682b6ae4b35a91146bab97332eb208962e
 SHA512:
-  metadata.gz: 257e3ea91ff1851bad52e02b57c546a9897ea7d8a6ba46d5d865a638aa796a26e90be4e207270dcac16291727218e85a27916ba24bc2b1b62d9e5ab9cad334b3
-  data.tar.gz: 39efe5f19987104abac8f8688306c38821a0d751e2bc04df65b7f8f74f1db8971d74dcb882daf94f77f554c102be173852efa7d4a8c16c8f14f0a3facc9d3d03
+  metadata.gz: f799c6bd555910a534954d137aac874f94ba9b57315c988066b696a09c381b6b81db75cfb6965d040e9a2ad26ccdd04f0bb1b562a5acfe7245658a315b1d19b2
+  data.tar.gz: a7cf6e434056d0cd54d693f9ffb09668e3e5bddebbe42fce825f5c36830ce0323173fdf6c8b039da16703f31f1df19478be2aa696be567c18cd183f81b7919ca

data/README.md

@@ -91,6 +91,44 @@ See Sequel documentation for more info:
 
 TODO: rake tasks for running migrations
 
+### Read/write splitting
+
+Sequel supports read/write splitting, but sequel-schema-sharding needs a
+few modifications in order to work with horizontal sharding. In order to
+use read/write splitting across shards, the following configuration can
+be used in your `sharding.yml`:
+
+```yml
+<env>:
+  tables:
+    <table_name>:
+      schema_name: "schema_%04d"
+      logical_shards:
+        <shard_name>: <1..n>
+        <shard_name>:<n+1..m>
+  physical_shards:
+    <shard_name>:
+      host: <hostname>
+      database: <database>
+      replicas:
+        <replica_name>:
+          host: <hostname>
+          database: <database>
+          ...
+  common:
+    username: <pg_username>
+    password: <pg_password>
+    port: <pg_port>
+```
+
+Replica configuration is merged into common attributes, so are redundant
+if they are not different from the master. Replica attributes take priority,
+however, so if you use a proxy such as PGBouncer, you can specify a different
+local database name.
+
+See http://sequel.rubyforge.org/rdoc/files/doc/sharding_rdoc.html for more
+information.
+
 ### Models
 
 Models declare their table in the class definition. This allows Sequel

data/lib/sequel/schema-sharding/configuration.rb

@@ -12,7 +12,15 @@ module Sequel
 
       def physical_shard_configs
         @physical_shard_configs ||= config['physical_shards'].inject({}) do |hash, value|
-          hash[value[0]] = config['common'].merge(value[1])
+          shard_config = config['common'].merge(value[1])
+
+          if shard_config['replicas']
+            shard_config['replicas'] = shard_config['replicas'].map do |name, replica|
+              config['common'].merge(replica)
+            end
+          end
+
+          hash[value[0]] = shard_config
           hash
         end
       end

data/lib/sequel/schema-sharding/connection_manager.rb

@@ -55,7 +55,7 @@ module Sequel
         return {} if config['replicas'].nil?
         {
           :servers => {
-            :read_only => ->(db) { {:host => config['replicas'].sample} }
+            :read_only => ->(db) { config['replicas'].sample }
           }
         }
       end

data/lib/sequel/schema-sharding/version.rb

@@ -1,5 +1,5 @@
 module Sequel
   module SchemaSharding
-    VERSION = "0.4.1"
+    VERSION = "0.5.0"
   end
 end

data/spec/fixtures/test_db_config.yml

@@ -20,7 +20,9 @@ test:
       host: 127.0.0.1
       database: sequel_test_shard2
       replicas:
-        - 127.0.0.1
+        replica_1:
+          host: 127.0.0.1
+          database: sequel_test_shard2
   common:
     username: postgres
     password: boomboomkaboom
@@ -46,7 +48,9 @@ boom:
       host: 127.0.0.1
       database: sequel_boom_shard2
       replicas:
-        - 127.0.0.1
+        replica_1:
+          host: 127.0.0.1
+          database: sequel_boom_shard2
   common:
     username: postgres
     password: boomboomkaboom

data/spec/schema-sharding/configuration_spec.rb

@@ -43,7 +43,11 @@ describe Sequel::SchemaSharding::Configuration do
         expect(value['username']).to eq('postgres')
         expect(value['password']).to eq('boomboomkaboom')
         expect(value['port']).to eq(5432)
-        expect(value['replicas']).to eq(['127.0.0.1']) if key == 'shard2'
+        expect(value['replicas']).to eq([{'host' => '127.0.0.1',
+                                         'database' => 'sequel_boom_shard2',
+                                         'port' => 5432,
+                                         'username' => 'postgres',
+                                         'password' => 'boomboomkaboom'}]) if key == 'shard2'
 
         i += 1
       end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sequel-schema-sharding
 version: !ruby/object:Gem::Version
-  version: 0.4.1
+  version: 0.5.0
 platform: ruby
 authors:
 - Paul Henry
@@ -10,7 +10,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-10-10 00:00:00.000000000 Z
+date: 2013-10-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: sequel