stephensmitchell-forks / bulk-operations Goto Github PK

Improve SQL insert, update, delete and merge performance and overcome SqlBulkCopy limitations

• Auditing
• Case Sensitivity
• Entity DataSource / Lambda Mapping
• Output Value
• And more...

Scalable

SQL Server - Benchmarks

As fast as SqlBulkCopy for insert but with way more capabilities

Extensible

Support Multiple SQL Providers:

• SQL Server 2008+
• SQL Azure
• SQL Compact
• MySQL
• SQLite
• PostgreSQL
• Oracle

Support Multiple Datasources:

• Entity
• DataTable
• DataRow
• DataReader
• DataSet
• Expando Object

Download

PM> Install-Package Z.BulkOperations

* PRO Version unlocked for the current month

Stay updated with latest changes

Insert - Output Identity Value

Problem

You need to output newly generated identity value but SqlBulkCopy do not support it.

Solution

Map your identity column with output direction.

var bulk = new BulkOperation(connection);

bulk.ColumnMappings.Add("CustomerID", ColumnMappingDirectionType.Output);
// ... mappings ...

bulk.BulkInsert(dt);

Flexibility

You can also output concurrency column (Timestamp) or any other column values. All kind of mapping direction are supported including "Formula" to use with a SQL Formula.

Entity DataSource / Lambda Mapping

Problem

You have a list of entity to insert but SqlBulkCopy doesn't support entity and lambda expression mapping.

Solution

Create a generic bulk operations with your entity type and use lambda expression for your column input, output and primary key mapping.

var bulk = new BulkOperation<Customer>(connection);

bulk.ColumnInputExpression = c => new { c.Name,  c.FirstName };
bulk.ColumnOutputExpression = c => c.CustomerID;
bulk.ColumnPrimaryKeyExpression = c => c.Code;

bulk.BulkMerge(customers);

Maintainability

Get rid of hardcoded string and use strongly-typed lambda expressions.

AutoMapping & Case Sensitivity

Problem

You have a DataTable which columns name match name in the database but SqlBulkCopy throw an error because name match are case insensitive.

Solution

Turn off case sensitivity with IsCaseSensitive property.

var bulk = new BulkOperation(connection);

bulk.IsCaseSensitive = false;

bulk.BulkMerge(dt);

Readability

Remove useless code which would have required to create your own mapping and keep the essentials.

Support

Contact our outstanding customer support for any request. We usually answer within the next business day, hour, or minutes!

• [email protected]
• Documentation
• Issues / Questions

PRO

PRO Version unlocked for the current month

Learn more about the PRO Version

Contribute

The best way to contribute is by spreading the word about the library:

• Blog it
• Comment it
• Fork it
• Star it
• Share it

A HUGE THANKS for your help.

More Projects

Entity Framework

• EntityFramework Extensions
• EntityFramework Plus

Bulk Operations

• Bulk Operations
• Dapper Plus

Expression Evaluator

• Eval-SQL.NET
• Eval-Expression.NET

Utilities

• Extension Methods Library
• Html Agility Pack

Need more info? [email protected]

Contact our outstanding customer support for any request. We usually answer within the next business day, hour, or minutes!