NAME
DBIx::Class::Migration::Script::Help::install - Install a migration version
SYNOPSIS
dbic-migration install --schema_class MyApp::Schema --to_version 2
DESCRIPTION
Installs a prepared migration to either the current schema version or the target version specified via "to_version" to the database connected via the "dsn", "username" in DBIx::Class::Migration::Script and "password" in DBIx::Class::Migration::Script (or to a developer level sandbox as defined by the "sandbox_class" in DBIx::Class::Migration::Script).
You can't install to a database if the tables already exist. See drop_tables
.
OPTIONS
This command accepts the following options. You may learn more about each option by typing dbic-migration help OPTION
. The following is a summary.
includes (I,lib,libs,include)
Optional.
Adds the listed paths to @INC. Handy during development when you want to use a development schema class.
to_version
aliases:V, Optional
This is the target version of the database we are installing. The version named must be have been previously prepared. If not specified, we will use the current Schema
class version.
schema_class (S)
Accepts Str. Required.
This is the schema we use as the basis for creating, managing and running your deployments. This should be the full package namespace defining your subclass of DBIx::Class::Schema. For example MyApp::Schema
.
If the "schema_class" cannot be loaded, a hard exception will be thrown.
target_dir (D)
Optional.
When using a sandbox_class
for generating developer level database sandboxes, you may wish to place the sandbox in a directory other than the default (which is under the share
directory off the project root).
sandbox_class
Aliases: T, sb
Accepts: String (default: SqliteSandbox)
The class we use to create a developer level database sandbox.
You can change this to either 'PostgresqlSandbox' or 'MySQLSandbox', which will create a sandbox using either DBIx::Class::Migration::MySQLSandbox or DBIx::Class::Migration::PostgresqlSandbox.
user
Aliases: U
password
Aliases: P
dsn
Connection information to an already created and running instance of a database. If you don't specify this, we will assume you want a developer level sandbox ( See "sandbox_class" in DBIx::Class::Migration::Script).
dbic_fixture_class
Accepts: String to a Perl Class. Defaults to DBIx::Class::Fixtures
Lets you specify a fixture class.
dbic_fixtures_extra_args
Accepts: HashRef. Optional
Allows you to pass custom arguments to DBIx::Class::Fixtures.
dbic_connect_attrs
dbi_connect_attrs
Accepts: HashRef, Optional
Lets you send custom attributes at connect
time to either DBIx::Class or the underlying DBI and your storage DBD
.
SEE ALSO
DBIx::Class::Migration, DBIx::Class::Migration::Script, DBIx::Class::Migration::Features, DBIx::Class::Migration::Tutorial
AUTHOR
See DBIx::Class::Migration for author information
COPYRIGHT & LICENSE
See DBIx::Class::Migration for copyright and license information