Scroll to navigation

DBIx::Class::Storage::DBI::Replicated::Balancer::Random(3pm) User Contributed Perl Documentation DBIx::Class::Storage::DBI::Replicated::Balancer::Random(3pm)

NAME

DBIx::Class::Storage::DBI::Replicated::Balancer::Random - A 'random' Balancer

SYNOPSIS

This class is used internally by DBIx::Class::Storage::DBI::Replicated. You shouldn't need to create instances of this class.

DESCRIPTION

Given a pool (DBIx::Class::Storage::DBI::Replicated::Pool) of replicated database's (DBIx::Class::Storage::DBI::Replicated::Replicant), defines a method by which query load can be spread out across each replicant in the pool.

ATTRIBUTES

This class defines the following attributes.

master_read_weight

A number greater than 0 that specifies what weight to give the master when choosing which backend to execute a read query on. A value of 0, which is the default, does no reads from master, while a value of 1 gives it the same priority as any single replicant.

For example: if you have 2 replicants, and a "master_read_weight" of 0.5, the chance of reading from master will be "20%".

You can set it to a value higher than 1, making master have higher weight than any single replicant, if for example you have a very powerful master.

METHODS

This class defines the following methods.

next_storage

Returns an active replicant at random. Please note that due to the nature of the word 'random' this means it's possible for a particular active replicant to be requested several times in a row.

FURTHER QUESTIONS?

Check the list of additional DBIC resources.

COPYRIGHT AND LICENSE

This module is free software copyright by the DBIx::Class (DBIC) authors. You can redistribute it and/or modify it under the same terms as the DBIx::Class library.

2022-05-21 perl v5.34.0