Name

sqitch-engine - Manage database engine configuration

Synopsis

sqitch engine
sqitch engine [-v | --verbose]
sqitch engine add <name> [engine-options]
sqitch engine alter <name> [engine-options]
sqitch engine remove <name>
sqitch engine show <name>

Description

Manage the database engines you deploy to. The list of supported engines includes:

• firebird

• mysql

• oracle

• pg

• sqlite

• vertica

• exasol

• snowflake

Each engine may have a number of properties:

target

The name or URI of the database target. Note that if the value is a URI, the engine in the URI must match the engine being added or altered. The default is db:$engine. See sqitch-target for details on target configuration.

registry

The name of the registry schema or database. The default is sqitch.

client

The command-line client to use. If not specified, each engine looks in the OS Path for an appropriate client.

top_dir

The path to the top directory for the engine. This directory generally contains the plan file and subdirectories for deploy, revert, and verify scripts, as well as reworked instances of those scripts. The default is ., the current directory.

plan_file

The plan file to use for this engine. The default is $top_dir/sqitch.plan.

deploy_dir

The path to the deploy directory for the engine. This directory contains all of the deploy scripts referenced by changes in the plan_file. The default is $top_dir/deploy.

revert_dir

The path to the revert directory for the engine. This directory contains all of the revert scripts referenced by changes in the plan_file. The default is $top_dir/revert.

verify_dir

The path to the verify directory for the engine. This directory contains all of the verify scripts referenced by changes in the plan_file. The default is $top_dir/verify.

reworked_dir

The path to the reworked directory for the engine. This directory contains all subdirectories for all reworked scripts referenced by changes in the plan_file. The default is $top_dir.

reworked_deploy_dir

The path to the reworked deploy directory for the engine. This directory contains all of the reworked deploy scripts referenced by changes in the plan_file. The default is $reworked_dir/deploy.

reworked_revert_dir

The path to the reworked revert directory for the engine. This directory contains all of the reworked revert scripts referenced by changes in the plan_file. The default is $reworked_dir/revert.

reworked_verify_dir

The path to the reworked verify directory for the engine. This directory contains all of the reworked verify scripts referenced by changes in the plan_file. The default is $reworked_dir/verify.

extension

The file name extension to append to change names to create script file names. The default is sql.

Each of these overrides the corresponding core configuration -- for example, the core.target, core.plan_file, core.registry, and core.client config options.

Options

List Option

-v

--verbose

sqitch engine --verbose

Be more verbose when listing engines.

Add and Alter Options

--top-dir

sqitch engine add pg --top-dir sql

Specifies the top directory to use for the engine. Typically contains the deployment plan file and the change script directories.

--plan-file

-f

sqitch engine add pg --plan-file my.plan

Specifies the path to the deployment plan file. Defaults to $top_dir/sqitch.plan.

--extension

sqitch engine add pg --extension ddl

Specifies the file name extension to use for change script file names. Defaults to sql.

--dir

sqitch engine add pg --dir deploy=dep --dir revert=rev --dir verify=tst

Sets the path to a script directory. May be specified multiple times. Supported keys are:

• deploy

• revert

• verify

• reworked

• reworked_deploy

• reworked_revert

• reworked_verify

--target

sqitch engine add pg --target db:pg:widgets

Specifies the name or URI of the target database for the engine.

--registry

sqitch engine add pg --registry meta

Specifies the name of the database object where Sqitch's state and history data is stored. Typically a schema name (as in PostgreSQL and Oracle) or a database name (as in SQLite and MySQL). Defaults to sqitch.

--client

sqitch engine add pg --client /usr/local/pgsql/bin/psql

Specifies the path to the command-line client for the engine. Defaults to a client in the current path named appropriately for the engine.

-s

--set

Set a variable name and value for use by the database engine client, if it supports variables. The format must be name=value, e.g., --set defuser='Homer Simpson'.

Actions

With no arguments, shows a list of existing engines. Several actions are available to perform operations on the engines.

add

Add an engine named <name> for the database at <uri>. The --set option specifies engine-specific properties. A new plan file and new script script directories will be created if they don't already exist.

alter

Alter an engine named <name>. The --set option specifies engine-specific properties to set. New script script directories will be created if they don't already exist.

remove, rm

Remove the engine named <name> from the configuration. The plan file and script directories will not be affected.

show

Gives some information about the engine <name>, including the associated properties. Specify multiple engine names to see information for each.

Configuration Variables

The engines are stored in the configuration file, but the command itself currently relies on no configuration variables.

Sqitch

Part of the sqitch suite.