Creates a new object of type Data::Session::Driver::Pg.
"new()" takes a hash of key/value pairs, some of which might mandatory. Further, some combinations might
be mandatory.
The keys are listed here in alphabetical order.
They are lower-case because they are (also) method names, meaning they can be called to set or get the
value at any time.
o data_col_name => $string
Specifes the name of the column in the sessions table which holds the session data.
This key is normally passed in as Data::Session -> new(data_col_name => $string).
Default: 'a_session'.
This key is optional.
o data_source => $string
Specifies the data source (as used by DBI -> connect($data_source, $username, $password,
$data_source_attr) ) to obtain a database handle.
This key is normally passed in as Data::Session -> new(data_source => $string).
Default: ''.
This key is optional, as long as a value is supplied for 'dbh'.
o data_source_attr => $hashref
Specifies the attributes (as used by DBI -> connect($data_source, $username, $password,
$data_source_attr) ) to obtain a database handle.
This key is normally passed in as Data::Session -> new(data_source_attr => $hashref).
Default: {AutoCommit => 1, PrintError => 0, RaiseError => 1}.
This key is optional.
o dbh => $dbh
Specifies the database handle to use to access the sessions table.
This key is normally passed in as Data::Session -> new(dbh => $dbh).
If not specified, this module will use the values of these keys to obtain a database handle:
o data_source
o data_source_attr
o username
o password
Default: ''.
This key is optional.
o host => $string
Not used.
o id_col_name => $string
Specifes the name of the column in the sessions table which holds the session id.
This key is normally passed in as Data::Session -> new(id_col_name => $string).
Default: 'id'.
This key is optional.
o password => $string
Specifies the password (as used by DBI -> connect($data_source, $username, $password,
$data_source_attr) ) to obtain a database handle.
This key is normally passed in as Data::Session -> new(password => $string).
Default: ''.
This key is optional.
o pg_bytea => $boolean
Specifies (if pg_bytea => 1) that the a_session column in the sessions table is of type bytea.
This key is normally passed in as Data::Session -> new(pg_bytea => $boolean).
If both 'pg_bytea' and 'pg_text' are set to 1, 'pg_text' is forced to be 0.
If both 'pg_bytea' and 'pg_text' are set to 0, 'pg_bytea' is forced to be 1.
o pg_text => $boolean
Specifies (if pg_text => 1) that the a_session column in the sessions table is of type text.
This key is normally passed in as Data::Session -> new(pg_text => $boolean).
o port => $string
Not used.
o socket => $string
Not used.
o table_name => $string
Specifes the name of the sessions table.
This key is normally passed in as Data::Session -> new(table_name => $string).
Default: 'sessions'.
This key is optional.
o username => $string
Specifies the username (as used by DBI -> connect($data_source, $username, $password,
$data_source_attr) ) to obtain a database handle.
This key is normally passed in as Data::Session -> new(username => $string).
Default: ''.
This key is optional.
o verbose => $integer
Print to STDERR more or less information.
This key is normally passed in as Data::Session -> new(verbose => $integer).
Typical values are 0, 1 and 2.
This key is optional.