You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
486 lines
24 KiB
486 lines
24 KiB
using System;
|
|
using System.Data;
|
|
using System.Collections.Generic;
|
|
|
|
namespace Migrator.Framework
|
|
{
|
|
/// <summary>
|
|
/// The main interface to use in Migrations to make changes on a database schema.
|
|
/// </summary>
|
|
public interface ITransformationProvider : IDisposable
|
|
{
|
|
|
|
/// <summary>
|
|
/// Get this provider or a NoOp provider if you are not running in the context of 'provider'.
|
|
/// </summary>
|
|
ITransformationProvider this[string provider] { get; }
|
|
|
|
/// <summary>
|
|
/// The list of Migrations currently applied to the database.
|
|
/// </summary>
|
|
List<long> AppliedMigrations { get; }
|
|
|
|
ILogger Logger { get; set; }
|
|
|
|
/// <summary>
|
|
/// Add a column to an existing table
|
|
/// </summary>
|
|
/// <param name="table">The name of the table that will get the new column</param>
|
|
/// <param name="column">The name of the new column</param>
|
|
/// <param name="type">The data type for the new columnd</param>
|
|
/// <param name="size">The precision or size of the column</param>
|
|
/// <param name="property">Properties that can be ORed together</param>
|
|
/// <param name="defaultValue">The default value of the column if no value is given in a query</param>
|
|
void AddColumn(string table, string column, DbType type, int size, ColumnProperty property, object defaultValue);
|
|
|
|
/// <summary>
|
|
/// Add a column to an existing table
|
|
/// </summary>
|
|
/// <param name="table">The name of the table that will get the new column</param>
|
|
/// <param name="column">The name of the new column</param>
|
|
/// <param name="type">The data type for the new columnd</param>
|
|
void AddColumn(string table, string column, DbType type);
|
|
|
|
/// <summary>
|
|
/// Add a column to an existing table
|
|
/// </summary>
|
|
/// <param name="table">The name of the table that will get the new column</param>
|
|
/// <param name="column">The name of the new column</param>
|
|
/// <param name="type">The data type for the new columnd</param>
|
|
/// <param name="size">The precision or size of the column</param>
|
|
void AddColumn(string table, string column, DbType type, int size);
|
|
|
|
/// <summary>
|
|
/// Add a column to an existing table
|
|
/// </summary>
|
|
/// <param name="table">The name of the table that will get the new column</param>
|
|
/// <param name="column">The name of the new column</param>
|
|
/// <param name="type">The data type for the new columnd</param>
|
|
/// <param name="size">The precision or size of the column</param>
|
|
/// <param name="property">Properties that can be ORed together</param>
|
|
void AddColumn(string table, string column, DbType type, int size, ColumnProperty property);
|
|
|
|
/// <summary>
|
|
/// Add a column to an existing table
|
|
/// </summary>
|
|
/// <param name="table">The name of the table that will get the new column</param>
|
|
/// <param name="column">The name of the new column</param>
|
|
/// <param name="type">The data type for the new columnd</param>
|
|
/// <param name="property">Properties that can be ORed together</param>
|
|
void AddColumn(string table, string column, DbType type, ColumnProperty property);
|
|
|
|
/// <summary>
|
|
/// Add a column to an existing table with the default column size.
|
|
/// </summary>
|
|
/// <param name="table">The name of the table that will get the new column</param>
|
|
/// <param name="column">The name of the new column</param>
|
|
/// <param name="type">The data type for the new columnd</param>
|
|
/// <param name="defaultValue">The default value of the column if no value is given in a query</param>
|
|
void AddColumn(string table, string column, DbType type, object defaultValue);
|
|
|
|
/// <summary>
|
|
/// Add a column to an existing table
|
|
/// </summary>
|
|
/// <param name="table">The name of the table that will get the new column</param>
|
|
/// <param name="column">An instance of a <see cref="Column">Column</see> with the specified properties</param>
|
|
void AddColumn(string table, Column column);
|
|
|
|
/// <summary>
|
|
/// Add a foreign key constraint
|
|
/// </summary>
|
|
/// <param name="name">The name of the foreign key. e.g. FK_TABLE_REF</param>
|
|
/// <param name="foreignTable">The table that the foreign key will be created in (eg. Table.FK_id)</param>
|
|
/// <param name="foreignColumns">The columns that are the foreign keys (eg. FK_id)</param>
|
|
/// <param name="primaryTable">The table that holds the primary keys (eg. Table.PK_id)</param>
|
|
/// <param name="primaryColumns">The columns that are the primary keys (eg. PK_id)</param>
|
|
void AddForeignKey(string name, string foreignTable, string[] foreignColumns, string primaryTable, string[] primaryColumns);
|
|
|
|
/// <summary>
|
|
/// Add a foreign key constraint
|
|
/// </summary>
|
|
/// <param name="name">The name of the foreign key. e.g. FK_TABLE_REF</param>
|
|
/// <param name="foreignTable">The table that the foreign key will be created in (eg. Table.FK_id)</param>
|
|
/// <param name="foreignColumns">The columns that are the foreign keys (eg. FK_id)</param>
|
|
/// <param name="primaryTable">The table that holds the primary keys (eg. Table.PK_id)</param>
|
|
/// <param name="primaryColumns">The columns that are the primary keys (eg. PK_id)</param>
|
|
/// <param name="constraint">Constraint parameters</param>
|
|
void AddForeignKey(string name, string foreignTable, string[] foreignColumns, string primaryTable, string[] primaryColumns, ForeignKeyConstraint constraint);
|
|
|
|
/// <summary>
|
|
/// Add a foreign key constraint
|
|
/// </summary>
|
|
///
|
|
/// <param name="name">The name of the foreign key. e.g. FK_TABLE_REF</param>
|
|
/// <param name="foreignTable">The table that the foreign key will be created in (eg. Table.FK_id)</param>
|
|
/// <param name="foreignColumn">The column that is the foreign key (eg. FK_id)</param>
|
|
/// <param name="primaryTable">The table that holds the primary keys (eg. Table.PK_id)</param>
|
|
/// <param name="primaryColumn">The column that is the primary key (eg. PK_id)</param>
|
|
void AddForeignKey(string name, string foreignTable, string foreignColumn, string primaryTable, string primaryColumn);
|
|
|
|
/// <summary>
|
|
/// Add a foreign key constraint
|
|
/// </summary>
|
|
/// <param name="name">The name of the foreign key. e.g. FK_TABLE_REF</param>
|
|
/// <param name="foreignTable">The table that the foreign key will be created in (eg. Table.FK_id)</param>
|
|
/// <param name="foreignColumn">The column that is the foreign key (eg. FK_id)</param>
|
|
/// <param name="primaryTable">The table that holds the primary key (eg. Table.PK_id)</param>
|
|
/// <param name="primaryColumn">The column that is the primary key (eg. PK_id)</param>
|
|
/// <param name="constraint">Constraint parameters</param>
|
|
void AddForeignKey(string name, string foreignTable, string foreignColumn, string primaryTable, string primaryColumn, ForeignKeyConstraint constraint);
|
|
|
|
/// <summary>
|
|
/// Add a foreign key constraint when you don't care about the name of the constraint.
|
|
/// Warning: This will prevent you from dropping the constraint since you won't know the name.
|
|
/// </summary>
|
|
/// <param name="foreignTable">The table that the foreign key will be created in (eg. Table.FK_id)</param>
|
|
/// <param name="foreignColumn">The column that is the foreign key (eg. FK_id)</param>
|
|
/// <param name="primaryTable">The table that holds the primary key (eg. Table.PK_id)</param>
|
|
/// <param name="primaryColumn">The column that is the primary key (eg. PK_id)</param>
|
|
void GenerateForeignKey(string foreignTable, string foreignColumn, string primaryTable, string primaryColumn);
|
|
|
|
/// <summary>
|
|
/// Add a foreign key constraint when you don't care about the name of the constraint.
|
|
/// Warning: This will prevent you from dropping the constraint since you won't know the name.
|
|
/// </summary>
|
|
/// <param name="foreignTable">The table that the foreign key will be created in (eg. Table.FK_id)</param>
|
|
/// <param name="foreignColumns">The columns that are the foreign keys (eg. FK_id)</param>
|
|
/// <param name="primaryTable">The table that holds the primary key (eg. Table.PK_id)</param>
|
|
/// <param name="primaryColumns">The column that is the primary key (eg. PK_id)</param>
|
|
void GenerateForeignKey(string foreignTable, string[] foreignColumns, string primaryTable, string[] primaryColumns);
|
|
|
|
/// <summary>
|
|
/// Add a foreign key constraint when you don't care about the name of the constraint.
|
|
/// Warning: This will prevent you from dropping the constraint since you won't know the name.
|
|
/// </summary>
|
|
/// <param name="foreignTable">The table that the foreign key will be created in (eg. Table.FK_id)</param>
|
|
/// <param name="foreignColumns">The columns that are the foreign keys (eg. FK_id)</param>
|
|
/// <param name="primaryTable">The table that holds the primary key (eg. Table.PK_id)</param>
|
|
/// <param name="primaryColumns">The columns that are the primary keys (eg. PK_id)</param>
|
|
/// <param name="constraint">Constraint parameters</param>
|
|
void GenerateForeignKey(string foreignTable, string[] foreignColumns, string primaryTable, string[] primaryColumns, ForeignKeyConstraint constraint);
|
|
|
|
/// <summary>
|
|
/// Add a foreign key constraint when you don't care about the name of the constraint.
|
|
/// Warning: This will prevent you from dropping the constraint since you won't know the name.
|
|
/// </summary>
|
|
/// <param name="foreignTable">The table that the foreign key will be created in (eg. Table.FK_id)</param>
|
|
/// <param name="foreignColumn">The columns that are the foreign keys (eg. FK_id)</param>
|
|
/// <param name="primaryTable">The table that holds the primary key (eg. Table.PK_id)</param>
|
|
/// <param name="primaryColumn">The column that is the primary key (eg. PK_id)</param>
|
|
/// <param name="constraint">Constraint parameters</param>
|
|
void GenerateForeignKey(string foreignTable, string foreignColumn, string primaryTable, string primaryColumn,
|
|
ForeignKeyConstraint constraint);
|
|
|
|
/// <summary>
|
|
/// Add a foreign key constraint when you don't care about the name of the constraint.
|
|
/// Warning: This will prevent you from dropping the constraint since you won't know the name.
|
|
///
|
|
/// The current expectations are that there is a column named the same as the foreignTable present in
|
|
/// the table. This is subject to change because I think it's not a good convention.
|
|
/// </summary>
|
|
/// <param name="foreignTable">The table that the foreign key will be created in (eg. Table.FK_id)</param>
|
|
/// <param name="primaryTable">The table that holds the primary key (eg. Table.PK_id)</param>
|
|
void GenerateForeignKey(string foreignTable, string primaryTable);
|
|
|
|
/// <summary>
|
|
/// Add a foreign key constraint when you don't care about the name of the constraint.
|
|
/// Warning: This will prevent you from dropping the constraint since you won't know the name.
|
|
///
|
|
/// The current expectations are that there is a column named the same as the foreignTable present in
|
|
/// the table. This is subject to change because I think it's not a good convention.
|
|
/// </summary>
|
|
/// <param name="foreignTable">The table that the foreign key will be created in (eg. Table.FK_id)</param>
|
|
/// <param name="primaryTable">The table that holds the primary key (eg. Table.PK_id)</param>
|
|
/// <param name="constraint"></param>
|
|
void GenerateForeignKey(string foreignTable, string primaryTable, ForeignKeyConstraint constraint);
|
|
|
|
/// <summary>
|
|
/// Add an Index to a table
|
|
/// </summary>
|
|
/// <param name="name">The name of the index to add.</param>
|
|
/// <param name="table">The name of the table that will get the index.</param>
|
|
/// <param name="unique">If the index will be unique</param>
|
|
/// <param name="columns">The name of the column or columns that are in the index.</param>
|
|
void AddIndex(string name, string table, bool unique, params string[] columns);
|
|
|
|
/// <summary>
|
|
/// Add a primary key to a table
|
|
/// </summary>
|
|
/// <param name="name">The name of the primary key to add.</param>
|
|
/// <param name="table">The name of the table that will get the primary key.</param>
|
|
/// <param name="columns">The name of the column or columns that are in the primary key.</param>
|
|
void AddPrimaryKey(string name, string table, params string[] columns);
|
|
|
|
/// <summary>
|
|
/// Add a constraint to a table
|
|
/// </summary>
|
|
/// <param name="name">The name of the constraint to add.</param>
|
|
/// <param name="table">The name of the table that will get the constraint</param>
|
|
/// <param name="columns">The name of the column or columns that will get the constraint.</param>
|
|
void AddUniqueConstraint(string name, string table, params string[] columns);
|
|
|
|
/// <summary>
|
|
/// Add a constraint to a table
|
|
/// </summary>
|
|
/// <param name="name">The name of the constraint to add.</param>
|
|
/// <param name="table">The name of the table that will get the constraint</param>
|
|
/// <param name="checkSql">The check constraint definition.</param>
|
|
void AddCheckConstraint(string name, string table, string checkSql);
|
|
|
|
/// <summary>
|
|
/// Add a table
|
|
/// </summary>
|
|
/// <param name="name">The name of the table to add.</param>
|
|
/// <param name="columns">The columns that are part of the table.</param>
|
|
void AddTable(string name, params Column[] columns);
|
|
|
|
/// <summary>
|
|
/// Add a table
|
|
/// </summary>
|
|
/// <param name="name">The name of the table to add.</param>
|
|
/// <param name="engine">The name of the database engine to use. (MySQL)</param>
|
|
/// <param name="columns">The columns that are part of the table.</param>
|
|
void AddTable(string name, string engine, params Column[] columns);
|
|
|
|
/// <summary>
|
|
/// Start a transction
|
|
/// </summary>
|
|
void BeginTransaction();
|
|
|
|
/// <summary>
|
|
/// Change the definition of an existing column.
|
|
/// </summary>
|
|
/// <param name="table">The name of the table that will get the new column</param>
|
|
/// <param name="column">An instance of a <see cref="Column">Column</see> with the specified properties and the name of an existing column</param>
|
|
void ChangeColumn(string table, Column column);
|
|
|
|
/// <summary>
|
|
/// Check to see if a column exists
|
|
/// </summary>
|
|
/// <param name="table"></param>
|
|
/// <param name="column"></param>
|
|
/// <returns></returns>
|
|
bool ColumnExists(string table, string column);
|
|
|
|
/// <summary>
|
|
/// Commit the running transction
|
|
/// </summary>
|
|
void Commit();
|
|
|
|
/// <summary>
|
|
/// Check to see if a constraint exists
|
|
/// </summary>
|
|
/// <param name="name">The name of the constraint</param>
|
|
/// <param name="table">The table that the constraint lives on.</param>
|
|
/// <returns></returns>
|
|
bool ConstraintExists(string table, string name);
|
|
|
|
/// <summary>
|
|
/// Check to see if a primary key constraint exists on the table
|
|
/// </summary>
|
|
/// <param name="name">The name of the primary key</param>
|
|
/// <param name="table">The table that the constraint lives on.</param>
|
|
/// <returns></returns>
|
|
bool PrimaryKeyExists(string table, string name);
|
|
|
|
/// <summary>
|
|
/// Execute an arbitrary SQL query
|
|
/// </summary>
|
|
/// <param name="sql">The SQL to execute.</param>
|
|
/// <returns></returns>
|
|
int ExecuteNonQuery(string sql);
|
|
|
|
/// <summary>
|
|
/// Execute an arbitrary SQL query
|
|
/// </summary>
|
|
/// <param name="sql">The SQL to execute.</param>
|
|
/// <returns></returns>
|
|
IDataReader ExecuteQuery(string sql);
|
|
|
|
/// <summary>
|
|
/// Execute an arbitrary SQL query
|
|
/// </summary>
|
|
/// <param name="sql">The SQL to execute.</param>
|
|
/// <returns>A single value that is returned.</returns>
|
|
object ExecuteScalar(string sql);
|
|
|
|
/// <summary>
|
|
/// Get the information about the columns in a table
|
|
/// </summary>
|
|
/// <param name="table">The table name that you want the columns for.</param>
|
|
/// <returns></returns>
|
|
Column[] GetColumns(string table);
|
|
|
|
/// <summary>
|
|
/// Get information about a single column in a table
|
|
/// </summary>
|
|
/// <param name="table">The table name that you want the columns for.</param>
|
|
/// <param name="column">The column name for which you want information.</param>
|
|
/// <returns></returns>
|
|
Column GetColumnByName(string table, string column);
|
|
|
|
/// <summary>
|
|
/// Get the names of all of the tables
|
|
/// </summary>
|
|
/// <returns>The names of all the tables.</returns>
|
|
string[] GetTables();
|
|
|
|
/// <summary>
|
|
/// Insert data into a table
|
|
/// </summary>
|
|
/// <param name="table">The table that will get the new data</param>
|
|
/// <param name="columns">The names of the columns</param>
|
|
/// <param name="values">The values in the same order as the columns</param>
|
|
/// <returns></returns>
|
|
int Insert(string table, string[] columns, string[] values);
|
|
|
|
/// <summary>
|
|
/// Delete data from a table
|
|
/// </summary>
|
|
/// <param name="table">The table that will have the data deleted</param>
|
|
/// <param name="columns">The names of the columns used in a where clause</param>
|
|
/// <param name="values">The values in the same order as the columns</param>
|
|
/// <returns></returns>
|
|
int Delete(string table, string[] columns, string[] values);
|
|
|
|
/// <summary>
|
|
/// Delete data from a table
|
|
/// </summary>
|
|
/// <param name="table">The table that will have the data deleted</param>
|
|
/// <param name="whereColumn">The name of the column used in a where clause</param>
|
|
/// <param name="whereValue">The value for the where clause</param>
|
|
/// <returns></returns>
|
|
int Delete(string table, string whereColumn, string whereValue);
|
|
|
|
/// <summary>
|
|
/// Marks a Migration version number as having been applied
|
|
/// </summary>
|
|
/// <param name="version">The version number of the migration that was applied</param>
|
|
void MigrationApplied(long version);
|
|
|
|
/// <summary>
|
|
/// Marks a Migration version number as having been rolled back from the database
|
|
/// </summary>
|
|
/// <param name="version">The version number of the migration that was removed</param>
|
|
void MigrationUnApplied(long version);
|
|
|
|
/// <summary>
|
|
/// Remove an existing column from a table
|
|
/// </summary>
|
|
/// <param name="table">The name of the table to remove the column from</param>
|
|
/// <param name="column">The column to remove</param>
|
|
void RemoveColumn(string table, string column);
|
|
|
|
/// <summary>
|
|
/// Remove an existing foreign key constraint
|
|
/// </summary>
|
|
/// <param name="table">The table that contains the foreign key.</param>
|
|
/// <param name="name">The name of the foreign key to remove</param>
|
|
void RemoveForeignKey(string table, string name);
|
|
|
|
/// <summary>
|
|
/// Remove an existing constraint
|
|
/// </summary>
|
|
/// <param name="table">The table that contains the foreign key.</param>
|
|
/// <param name="name">The name of the constraint to remove</param>
|
|
void RemoveConstraint(string table, string name);
|
|
|
|
/// <summary>
|
|
/// Remove an existing index
|
|
/// </summary>
|
|
/// <param name="table">The table that contains the index.</param>
|
|
/// <param name="name">The name of the index to remove</param>
|
|
void RemoveIndex(string table, string name);
|
|
|
|
/// <summary>
|
|
/// Remove an existing table
|
|
/// </summary>
|
|
/// <param name="tableName">The name of the table</param>
|
|
void RemoveTable(string tableName);
|
|
|
|
/// <summary>
|
|
/// Rename an existing table
|
|
/// </summary>
|
|
/// <param name="oldName">The old name of the table</param>
|
|
/// <param name="newName">The new name of the table</param>
|
|
void RenameTable(string oldName, string newName);
|
|
|
|
/// <summary>
|
|
/// Rename an existing table
|
|
/// </summary>
|
|
/// <param name="tableName">The name of the table</param>
|
|
/// <param name="oldColumnName">The old name of the column</param>
|
|
/// <param name="newColumnName">The new name of the column</param>
|
|
void RenameColumn(string tableName, string oldColumnName, string newColumnName);
|
|
|
|
/// <summary>
|
|
/// Rollback the currently running transaction.
|
|
/// </summary>
|
|
void Rollback();
|
|
|
|
/// <summary>
|
|
/// Get values from a table
|
|
/// </summary>
|
|
/// <param name="what">The columns to select</param>
|
|
/// <param name="from">The table to select from</param>
|
|
/// <param name="where">The where clause to limit the selection</param>
|
|
/// <returns></returns>
|
|
IDataReader Select(string what, string from, string where);
|
|
|
|
/// <summary>
|
|
/// Get values from a table
|
|
/// </summary>
|
|
/// <param name="what">The columns to select</param>
|
|
/// <param name="from">The table to select from</param>
|
|
/// <returns></returns>
|
|
IDataReader Select(string what, string from);
|
|
|
|
/// <summary>
|
|
/// Get a single value from a table
|
|
/// </summary>
|
|
/// <param name="what">The columns to select</param>
|
|
/// <param name="from">The table to select from</param>
|
|
/// <param name="where"></param>
|
|
/// <returns></returns>
|
|
object SelectScalar(string what, string from, string where);
|
|
|
|
/// <summary>
|
|
/// Get a single value from a table
|
|
/// </summary>
|
|
/// <param name="what">The columns to select</param>
|
|
/// <param name="from">The table to select from</param>
|
|
/// <returns></returns>
|
|
object SelectScalar(string what, string from);
|
|
|
|
/// <summary>
|
|
/// Check if a table already exists
|
|
/// </summary>
|
|
/// <param name="tableName">The name of the table that you want to check on.</param>
|
|
/// <returns></returns>
|
|
bool TableExists(string tableName);
|
|
|
|
/// <summary>
|
|
/// Update the values in a table
|
|
/// </summary>
|
|
/// <param name="table">The name of the table to update</param>
|
|
/// <param name="columns">The names of the columns.</param>
|
|
/// <param name="columnValues">The values for the columns in the same order as the names.</param>
|
|
/// <returns></returns>
|
|
int Update(string table, string[] columns, string[] columnValues);
|
|
|
|
/// <summary>
|
|
/// Update the values in a table
|
|
/// </summary>
|
|
/// <param name="table">The name of the table to update</param>
|
|
/// <param name="columns">The names of the columns.</param>
|
|
/// <param name="values">The values for the columns in the same order as the names.</param>
|
|
/// <param name="where">A where clause to limit the update</param>
|
|
/// <returns></returns>
|
|
int Update(string table, string[] columns, string[] values, string where);
|
|
|
|
IDbCommand GetCommand();
|
|
|
|
void ExecuteSchemaBuilder(SchemaBuilder.SchemaBuilder schemaBuilder);
|
|
}
|
|
}
|