jake-carpenter / easy-bulk-copy

Easy and automatic mapping for SqlBulkCopy

DEPRECATED

I lost access to the MS account that owns the NuGet package for this project. A replacement project is planned. - May 31, 2024

EasyBulkCopy

Easy and automatic mapping for SqlBulkCopy

Installation

• Option 1: Install via package manager
• Option 2: Install via NuGet

Install-Package EasyBulkCopy

• Option 3: Install via dotnet command line interface

dotnet add package EasyBulkCopy

Usage

Create classes that map to your MSSQL tables and decorate them with the attribute to provide the table name

[BulkTableName("dbo.MyTable")]
public class MyTable
{
    public int Id { get; set; }
    public string Name { get; set; }
    public DateTimeOffset CreatedDate { get; set; }
}

Register your classes in the .NET Core DI container

• Option 1: Piecemeal registration

public void ConfigureServices(IServiceCollection services)
{
    services.UseEasyBulkCopy();
    services.RegisterBulkInsertType<MyTable>();
}

• Option 2: Scan assembly and automatically register decorated types

public void ConfigureServices(IServiceCollection services)
{
    services.UseEasyBulkCopy();
    services.RegisterBulkInsertTypesInAssembly(Assembly.GetExecutingAssembly());
}

Inject the IBulkInserter interface where needed

public class Foo
{
    // ...
    public Foo(IBulkInserter bulkInserter)
    {
        _bulkInserter = bulkInserter
        _connectionString = "Server=localhost;Database=master;"
    }

    public async Task Write(IEnumerable<MyTable> rows)
    {
        await _bulkInserter.Insert(_connectionString, rows);
    }
}

easy-bulk-copy's Issues

Transaction support

Investigate support for passing in the connection from a transaction

GitHub action for feature/issue branches

Support flagging computed fields

As a developer using EasyBulkCopy I would like to be able to annotate or flag properties in a model representing my database that is computed so SQLBulkCopy does not attempt to write to it.

Migrate test environment build up to FluentDocker

Use FluentDocker to build up reusable integration test DB and test app DB.

Support providing custom SqlBulkCopyOptions

Allow optionally providing SqlBulkCopyOptions when defining a table.