SQL Server Types

OrmLite can be extended to support new Types using SQL Server Special Type Converters which currently adds support for the SQL Server-specific SqlGeography, SqlGeometry and SqlHierarchyId Types.

Since these Types require an external dependency to the Microsoft.SqlServer.Types NuGet package they're contained in a separate NuGet package that can be installed with:

PM> Install-Package ServiceStack.OrmLite.SqlServer.Converters

Once installed, all available SQL Server Types can be registered on your SQL Server Provider with:

SqlServerConverters.Configure(SqlServer2012Dialect.Provider);

SqlServer 2012 Connection String

In addition to using SqlServer2012Dialect.Provider you'll also need to specify you're using MSSQL 2012 on the connection string by adding the ;Type System Version=SQL Server 2012; suffix, e.g:

vardbFactory=newOrmLiteConnectionFactory("Server=host;Database=db;User Id=sa;Password=test;Type System Version=SQL Server 2012",SqlServer2012Dialect.Provider);vardb=dbFactory.OpenDbConnection();

Example Usage

After the Converters are registered they can treated like a normal .NET Type, e.g:

SqlHierarchyId Example:

publicclassNode{[AutoIncrement]publiclongId{get;set;}publicSqlHierarchyIdTreeId{get;set;}}db.DropAndCreateTable<Node>();vartreeId=SqlHierarchyId.Parse("/1/1/3/");// 0x5ADE is hexdb.Insert(newNode{TreeId=treeId});varparent=db.Scalar<SqlHierarchyId>(db.From<Node>().Select("TreeId.GetAncestor(1)"));parent.ToString().Print();//= /1/1/

SqlGeography and SqlGeometry Example:

publicclassGeoTest{publiclongId{get;set;}publicSqlGeographyLocation{get;set;}publicSqlGeometryShape{get;set;}}db.DropAndCreateTable<GeoTest>();vargeo=SqlGeography.Point(40.6898329,-74.0452177,4326);// Statue of Liberty// A simple line from (0,0) to (4,4) Length = SQRT(2 * 4^2)varwkt=newSystem.Data.SqlTypes.SqlChars("LINESTRING(0 0,4 4)".ToCharArray());varshape=SqlGeometry.STLineFromText(wkt,0);db.Insert(newGeoTestTable{Id=1,Location=geo,Shape=shape});vardbShape=db.SingleById<GeoTest>(1).Shape;new{dbShape.STEndPoint().STX,dbShape.STEndPoint().STY}.PrintDump();

Output:

{
STX: 4,
STY: 4
}

Memory Optimized Tables

OrmLite allows access to many other advanced SQL Server features including Memory-Optimized Tables where you can tell SQL Server to maintain specific tables in Memory using the [SqlServerMemoryOptimized] attribute, e.g:

[SqlServerMemoryOptimized(SqlServerDurability.SchemaOnly)]publicclassSqlServerMemoryOptimizedCacheEntry:ICacheEntry{[PrimaryKey][StringLength(StringLengthAttribute.MaxText)][SqlServerBucketCount(10000000)]publicstringId{get;set;}[StringLength(StringLengthAttribute.MaxText)]publicstringData{get;set;}publicDateTimeCreatedDate{get;set;}publicDateTime?ExpiryDate{get;set;}publicDateTimeModifiedDate{get;set;}}

The [SqlServerBucketCount] attribute can be used to configure the bucket count for a hash index whilst the new [SqlServerCollate] attribute can be used to specify an SQL Server collation.