X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=t%2F93storage_replication.t;h=eb31c816cff37b9c9d8258da790d698aebc67c28;hb=de5dc9efd2c3575f78a7dc71c50d571c9a17c38d;hp=b70e254fa2d6062a13aa493ed6b310e2fdbcaf3a;hpb=955a6df69eb864ba348f87f5a06a8b7a68ffc76c;p=dbsrgits%2FDBIx-Class.git diff --git a/t/93storage_replication.t b/t/93storage_replication.t index b70e254..eb31c81 100644 --- a/t/93storage_replication.t +++ b/t/93storage_replication.t @@ -2,13 +2,13 @@ use strict; use warnings; use lib qw(t/lib); use Test::More; -use Data::Dump qw/dump/; +use DBICTest; BEGIN { - eval "use Moose"; + eval "use Moose; use Test::Moose"; plan $@ ? ( skip_all => 'needs Moose for testing' ) - : ( tests => 33 ); + : ( tests => 41 ); } use_ok 'DBIx::Class::Storage::DBI::Replicated::Pool'; @@ -16,21 +16,34 @@ use_ok 'DBIx::Class::Storage::DBI::Replicated::Balancer'; use_ok 'DBIx::Class::Storage::DBI::Replicated::Replicant'; use_ok 'DBIx::Class::Storage::DBI::Replicated'; +=head1 HOW TO USE + + This is a test of the replicated storage system. This will work in one of + two ways, either it was try to fake replication with a couple of SQLite DBs + and creative use of copy, or if you define a couple of %ENV vars correctly + will try to test those. If you do that, it will assume the setup is properly + replicating. Your results may vary, but I have demonstrated this to work with + mysql native replication. + +=cut + + ## ---------------------------------------------------------------------------- ## Build a class to hold all our required testing data and methods. ## ---------------------------------------------------------------------------- -TESTSCHEMACLASS: { +TESTSCHEMACLASSES: { + ## --------------------------------------------------------------------- ## + ## Create an object to contain your replicated stuff. + ## --------------------------------------------------------------------- ## + package DBIx::Class::DBI::Replicated::TestReplication; use DBICTest; - use File::Copy; - use Data::Dump qw/dump/; - use base qw/Class::Accessor::Fast/; - __PACKAGE__->mk_accessors( qw/schema master_path slave_paths/ ); + __PACKAGE__->mk_accessors( qw/schema/ ); ## Initialize the object @@ -39,8 +52,6 @@ TESTSCHEMACLASS: { my $self = $class->SUPER::new(@_); $self->schema( $self->init_schema ); - $self->master_path("t/var/DBIxClass.db"); - return $self; } @@ -48,20 +59,64 @@ TESTSCHEMACLASS: { sub init_schema { my $class = shift @_; - my $schema = DBICTest->init_schema(storage_type=>'::DBI::Replicated'); + + my $schema = DBICTest->init_schema( + storage_type=>[ + '::DBI::Replicated' => { + balancer_type=>'::Random', + } + ], + deploy_args=>{ + add_drop_table => 1, + }, + ); + return $schema; } + sub generate_replicant_connect_info {} + sub replicate {} + sub cleanup {} + + + ## --------------------------------------------------------------------- ## + ## Subclass for when you are using SQLite for testing, this provides a fake + ## replication support. + ## --------------------------------------------------------------------- ## + + package DBIx::Class::DBI::Replicated::TestReplication::SQLite; + + use DBICTest; + use File::Copy; + use base 'DBIx::Class::DBI::Replicated::TestReplication'; + + __PACKAGE__->mk_accessors( qw/master_path slave_paths/ ); + + ## Set the mastep path from DBICTest + + sub new { + my $class = shift @_; + my $self = $class->SUPER::new(@_); + + $self->master_path( DBICTest->_sqlite_dbfilename ); + $self->slave_paths([ + "t/var/DBIxClass_slave1.db", + "t/var/DBIxClass_slave2.db", + ]); + + return $self; + } + ## Return an Array of ArrayRefs where each ArrayRef is suitable to use for ## $storage->connect_info to be used for connecting replicants. sub generate_replicant_connect_info { - my $self = shift @_; + my $self = shift @_; my @dsn = map { "dbi:SQLite:${_}"; } @{$self->slave_paths}; - return map { [$_,'','',{}] } @dsn; + return map { [$_,'','',{AutoCommit=>1}] } @dsn; } ## Do a 'good enough' replication by copying the master dbfile over each of @@ -83,6 +138,33 @@ TESTSCHEMACLASS: { unlink $slave; } } + + ## --------------------------------------------------------------------- ## + ## Subclass for when you are setting the databases via custom export vars + ## This is for when you have a replicating database setup that you are + ## going to test against. You'll need to define the correct $ENV and have + ## two slave databases to test against, as well as a replication system + ## that will replicate in less than 1 second. + ## --------------------------------------------------------------------- ## + + package DBIx::Class::DBI::Replicated::TestReplication::Custom; + use base 'DBIx::Class::DBI::Replicated::TestReplication'; + + ## Return an Array of ArrayRefs where each ArrayRef is suitable to use for + ## $storage->connect_info to be used for connecting replicants. + + sub generate_replicant_connect_info { + return ( + [$ENV{"DBICTEST_SLAVE0_DSN"}, $ENV{"DBICTEST_SLAVE0_DBUSER"}, $ENV{"DBICTEST_SLAVE0_DBPASS"}, {AutoCommit => 1}], + [$ENV{"DBICTEST_SLAVE1_DSN"}, $ENV{"DBICTEST_SLAVE1_DBUSER"}, $ENV{"DBICTEST_SLAVE1_DBPASS"}, {AutoCommit => 1}], + ); + } + + ## pause a bit to let the replication catch up + + sub replicate { + sleep 1; + } } ## ---------------------------------------------------------------------------- @@ -91,13 +173,12 @@ TESTSCHEMACLASS: { ## Thi first bunch of tests are basic, just make sure all the bits are behaving -ok my $replicated = DBIx::Class::DBI::Replicated::TestReplication - ->new({ - slave_paths=>[ - "t/var/DBIxClass_slave1.db", - "t/var/DBIxClass_slave2.db", - ], - }) => 'Created a replication object'; +my $replicated_class = DBICTest->has_custom_dsn ? + 'DBIx::Class::DBI::Replicated::TestReplication::Custom' : + 'DBIx::Class::DBI::Replicated::TestReplication::SQLite'; + +ok my $replicated = $replicated_class->new + => 'Created a replication object'; isa_ok $replicated->schema => 'DBIx::Class::Schema'; @@ -123,7 +204,7 @@ ok my @replicant_connects = $replicated->generate_replicant_connect_info ok my @replicated_storages = $replicated->schema->storage->connect_replicants(@replicant_connects) => 'Created some storages suitable for replicants'; -isa_ok $replicated->schema->storage->current_replicant +isa_ok $replicated->schema->storage->balancer->current_replicant => 'DBIx::Class::Storage::DBI'; ok $replicated->schema->storage->pool->has_replicants @@ -132,16 +213,18 @@ ok $replicated->schema->storage->pool->has_replicants is $replicated->schema->storage->num_replicants => 2 => 'has two replicants'; -isa_ok $replicated_storages[0] +does_ok $replicated_storages[0] => 'DBIx::Class::Storage::DBI::Replicated::Replicant'; -isa_ok $replicated_storages[1] +does_ok $replicated_storages[1] => 'DBIx::Class::Storage::DBI::Replicated::Replicant'; -isa_ok $replicated->schema->storage->replicants->{"t/var/DBIxClass_slave1.db"} +my @replicant_names = keys %{$replicated->schema->storage->replicants}; + +does_ok $replicated->schema->storage->replicants->{$replicant_names[0]} => 'DBIx::Class::Storage::DBI::Replicated::Replicant'; -isa_ok $replicated->schema->storage->replicants->{"t/var/DBIxClass_slave2.db"} +does_ok $replicated->schema->storage->replicants->{$replicant_names[1]} => 'DBIx::Class::Storage::DBI::Replicated::Replicant'; ## Add some info to the database @@ -181,11 +264,19 @@ $replicated [ 7, "Watergate"], ]); -## Alright, the database 'cluster' is not in a consistent state. When we do -## a read now we expect bad news - -is $replicated->schema->resultset('Artist')->find(5), undef - => 'read after disconnect fails because it uses a replicant which we have neglected to "replicate" yet'; +SKIP: { + ## We can't do this test if we have a custom replicants, since we assume + ## if there are custom one that you are trying to test a real replicating + ## system. See docs above for more. + + skip 'Cannot test inconsistent replication since you have a real replication system', 1 + if DBICTest->has_custom_dsn && $ENV{"DBICTEST_SLAVE0_DSN"}; + + ## Alright, the database 'cluster' is not in a consistent state. When we do + ## a read now we expect bad news + is $replicated->schema->resultset('Artist')->find(5), undef + => 'read after disconnect fails because it uses a replicant which we have neglected to "replicate" yet'; +} ## Make sure all the slaves have the table definitions $replicated->replicate; @@ -206,8 +297,8 @@ is $artist2->name, "Doom's Children" is $replicated->schema->storage->pool->connected_replicants => 2 => "both replicants are connected"; -$replicated->schema->storage->replicants->{"t/var/DBIxClass_slave1.db"}->disconnect; -$replicated->schema->storage->replicants->{"t/var/DBIxClass_slave2.db"}->disconnect; +$replicated->schema->storage->replicants->{$replicant_names[0]}->disconnect; +$replicated->schema->storage->replicants->{$replicant_names[1]}->disconnect; is $replicated->schema->storage->pool->connected_replicants => 0 => "both replicants are now disconnected"; @@ -225,7 +316,59 @@ is $artist3->name, "Dead On Arrival" is $replicated->schema->storage->pool->connected_replicants => 1 => "One replicant reconnected to handle the job"; + +## What happens when we try to select something that doesn't exist? +ok ! $replicated->schema->resultset('Artist')->find(666) + => 'Correctly failed to find something.'; + +## test the reliable option + +TESTRELIABLE: { + + $replicated->schema->storage->set_reliable_storage; + + ok $replicated->schema->resultset('Artist')->find(2) + => 'Read from master 1'; + + ok $replicated->schema->resultset('Artist')->find(5) + => 'Read from master 2'; + + $replicated->schema->storage->set_balanced_storage; + + ok $replicated->schema->resultset('Artist')->find(3) + => 'Read from replicant'; +} + +## Make sure when reliable goes out of scope, we are using replicants again + +ok $replicated->schema->resultset('Artist')->find(1) + => 'back to replicant 1.'; + +ok $replicated->schema->resultset('Artist')->find(2) + => 'back to replicant 2.'; + +## set all the replicants to inactive, and make sure the balancer falls back to +## the master. + +$replicated->schema->storage->replicants->{$replicant_names[0]}->active(0); +$replicated->schema->storage->replicants->{$replicant_names[1]}->active(0); + +ok $replicated->schema->resultset('Artist')->find(2) + => 'Fallback to master'; + +$replicated->schema->storage->replicants->{$replicant_names[0]}->active(1); +$replicated->schema->storage->replicants->{$replicant_names[1]}->active(1); + +ok $replicated->schema->resultset('Artist')->find(2) + => 'Returned to replicates'; + +## Getting slave status tests + +use Data::Dump qw/dump/; +my $lag1 = $replicated->schema->storage->replicants->{$replicant_names[0]}->lag_behind_master; +warn dump $lag1; + ## Delete the old database files $replicated->cleanup;