App-Sqitch
view release on metacpan - search on metacpan
view release on metacpan or search on metacpan
lib/sqitch-authentication.pod view on Meta::CPAN
=encoding UTF-8
=head1 Name
sqitch-authentication - Guide to using database authentication credentials with Sqitch
=head1 Description
For database engines that require authentication, Sqitch supports a number
of credential-specification options, and searches for them in a specific
sequence. These searches are performed in two parts: a search for a username
and a search for a password.
=head1 Usernames
Sqitch searches for usernames sequentially, using the first value it finds.
Any of these approaches may be used to specify a username, in this order:
=over
=item 1. In the C<$SQITCH_USERNAME> environment variable
=item 2. Via the C<--db-username> option
=item 3. In the deploy target URI; this is the preferred option
=item 4. In an engine-specific environment variable or configuration
=back
Naturally, this last option varies by database engine. The details are as
follows:
=over
=item PostgreSQL, YugabyteDB, CockroachDB
The Postgres, Yugabyte, and Cockroach engines use the C<PGUSER> environment
variable, if set. Otherwise, it uses the system username.
=item MySQL
For MySQL, if the L<MySQL::Config> module is installed, usernames and
passwords can be specified in the
L<F</etc/my.cnf> and F<~/.my.cnf> files|https://dev.mysql.com/doc/refman/5.7/en/password-security-user.html>.
These files must limit access only to the current user (C<0600>). Sqitch will
look for a username and password under the C<[client]> and C<[mysql]>
sections, in that order.
=item Oracle
Oracle provides no default to search for a username.
=item Vertica
The Vertica engine uses the C<VSQL_USER> environment variable, if set.
Otherwise, it uses the system username.
=item Firebird
The Firebird engine uses the C<ISC_USER> environment variable, if set.
=item Exasol
Exasol provides no default to search for a username.
view all matches for this distributionview release on metacpan - search on metacpan
( run in 0.516 second using v1.00-cache-2.02-grep-82fe00e-cpan-2c419f77a38b )