Laxo.Database.Migrations 1.0.2

Laxo database migrations

Es una biblioteca de clases con el fin de poder ejecutar archivos .sql para las migraciones de una o más bases de datos sin importar el proveedor de esta.

Índice de contenido

1. Instalación
2. Inicio rápido
3. Proveedores de bases de datos
4. Nota
5. Advertencia
6. Contribuyendo
7. Licencia

Instalación

Para la instalación abra la consola del administrador de paquetes en Visual Studio y escriba:

PM> Install-Package Laxo.Database.Migrations

O haga clic derecho en el proyecto → Administrar paquetes NuGet... → En línea → busque Laxo.Database.Migrations en la parte superior; también puedes usar el dotnet CLI con el siguiente comando.

dotnet add package Laxo.Database.Migrations

Inicio rápido

Debes indicar el proveedor de la base de datos mediante una clase y la ruta de la carpeta de los archivos a migrar.

using System.Data.SqlClient;
using Laxo.Database.Migrations;

string erroresSQLServer;
using (SqlConnection connection = new("Cadena de conexión")
{
    MigrateService migrateService = new(new MigrationGeneratorSQLServer(), connection);
    erroresSQLServer = await migrateService.ExecuteAsync("Ruta de la carpeta con los archivos .sql");
}
Console.Writeline(erroresSQLServer);

Al ejecutarse las migraciones en caso exista algún error, se retornará dicho error en la variable erroresSQLServer

Proveedores de bases de datos

Laxo.Database.Migrations pretende ser lo más independiente posible de la base de datos. Sin embargo, hay lugares donde se necesita que se le indique con que proveedor de base de datos va a interactuar.

Proveedores de bases de datos integrados

Los motores de base de datos admitidos actualmente son:

• MSSQL:

      string erroresSQLServer;
      using (SqlConnection connection = new("Cadena de conexión")
      {
         MigrateService migrateService = new(new MigrationGeneratorSQLServer(), connection);
         erroresSQLServer = await migrateService.ExecuteAsync("Ruta de la carpeta con los archivos .sql");
      }
  

• MySQL:

     string erroresMySQLServer;
     using (MySqlConnection connection = new("Cadena de conexión")
     {
        MigrateService migrateService = new(new MigrationGeneratorMySQL(), connection);
        erroresMySQLServer = await migrateService.ExecuteAsync("Ruta de la carpeta con los archivos .sql");
     }
  

• PostgreSQL:

     string erroresPostgreSQL;
     using (NpgsqlConnection connection = new("Cadena de conexión")
     {
        MigrateService migrateService = new(new MigrationGeneratorPostgreSQL(), connection);
        erroresPostgreSQL = await migrateService.ExecuteAsync("Ruta de la carpeta con los archivos .sql");
     }
  

Nota

Laxo.Database.Migrations crea una tabla en la base de datos de nombre "__MigrationsHistory" e inserta los nombres de los archivos que se han ejecutado de manera correcta, con el uso de esta tabla puede saber qué archivos están pendientes de ejecutar.

Advertencia

Si el script a migrar tiene más de una instrucción a ejecutar, evite usar la palabra reservada "GO" para separarlos, como lo veremos en el siguiente ejemplo:

ALTER TABLE Tabla1
ADD Campo123 int
GO

ALTER TABLE Table2
ADD Campo321 int
GO

El ejemplo anterior no funcionará, para corregir esto debe de borrar todas las palabras "GO".

Contribuyendo

Los "pull requests" son bienvenidos. Para cambios importantes, abra primero un "discuss" para poder saber lo que le gustaría cambiar.

Licencia

MIT

Hecho con algo de amor y sueño 😁