FastGuid 1.1.0

.NET 5.0 This package targets .NET 5.0. The package is compatible with this framework or higher. 
dotnet add package FastGuid --version 1.1.0                

                    
                

            
NuGet\Install-Package FastGuid -Version 1.1.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="FastGuid" Version="1.1.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
paket add FastGuid --version 1.1.0                

                    
                

            
#r "nuget: FastGuid, 1.1.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
// Install FastGuid as a Cake Addin
#addin nuget:?package=FastGuid&version=1.1.0

// Install FastGuid as a Cake Tool
#tool nuget:?package=FastGuid&version=1.1.0

FastGuid NuGet

by Stan Drapkin

10 times faster than Guid.NewGuid()

Static APIs

  • Guid FastGuid.NewGuid()

    • Returns a cryptographically random GUID.
    • ~10x faster than Guid.NewGuid().

  • FastGuid.Fill(Span<byte> data)

    • Fills a span with cryptographically strong random bytes.
    • ~5x faster for <512 bytes, otherwise calls RandomNumberGenerator.Fill()

  • Guid FastGuid.NewSqlServerGuid()

    • Returns new Guid optimized for use as a SQL-Server clustered key.
    • Guid structure is [8 random bytes] [8 bytes of SQL-Server-ordered DateTime.UtcNow]
    • Each Guid is sequential accross 100-nanosecond UtcNow precision limits.
    • 64-bit cryptographic randomness adds uniqueness for timestamp collisions and provides reasonable unguessability and protection against online brute-force attacks.

  • Helper methods for Guids generated by NewSqlServerGuid():

    • DateTime FastGuid.SqlServer.GetTimestamp(Guid guid)
      • Extracts SqlServer guid creation timestamp (UTC). Full DateTime.UtcNow precision.
    • Guid FastGuid.SqlServer.MinGuidForTimestamp(DateTime timestampUtc)
    • Guid FastGuid.SqlServer.MaxGuidForTimestamp(DateTime timestampUtc)
      • Return the smallest/largest Guid for a given timestamp (useful for time-based database range searches).

Usage

Replace all calls to Guid.NewGuid() with FastGuid.NewGuid()

..from this:

Guid guid = Guid.NewGuid(); // your current code

..to this:

// using SecurityDriven;
Guid guid = FastGuid.NewGuid(); // 10x faster
  • Thread-safe
  • 128 bits of cryptographically-strong randomness

Switch from this:

Span<byte> key = stackalloc byte[32];
RandomNumberGenerator.Fill(key); // 145 nanoseconds

..to this:

Span<byte> key = stackalloc byte[32];
FastGuid.Fill(key); // 25 nanoseconds

Benchmark #1:

public class Bench
{
	[Benchmark(Baseline = true)]
	public void FastGuid_NewGuid() // 12 calls
	{
		FastGuid.NewGuid(); FastGuid.NewGuid(); FastGuid.NewGuid(); FastGuid.NewGuid();
		FastGuid.NewGuid(); FastGuid.NewGuid(); FastGuid.NewGuid(); FastGuid.NewGuid();
		FastGuid.NewGuid(); FastGuid.NewGuid(); FastGuid.NewGuid(); FastGuid.NewGuid();
	}

	[Benchmark]
	public void Guid_NewGuid() // 12 calls
	{
		Guid.NewGuid(); Guid.NewGuid(); Guid.NewGuid(); Guid.NewGuid();
		Guid.NewGuid(); Guid.NewGuid(); Guid.NewGuid(); Guid.NewGuid();
		Guid.NewGuid(); Guid.NewGuid(); Guid.NewGuid(); Guid.NewGuid();
	}
}//class Bench

BenchmarkDotNet=v0.13.2, OS=Windows 10 (10.0.19045.2364)
Intel Core i7-10510U CPU 1.80GHz, 1 CPU, 8 logical and 4 physical cores
.NET SDK=7.0.101
  [Host] : .NET 7.0.1 (7.0.122.56804), X64 RyuJIT AVX2
Method Mean Error StdDev Ratio
FastGuid_NewGuid 116.6 ns 2.26 ns 5.19 ns 1.00
Guid_NewGuid 1,215.9 ns 23.85 ns 45.96 ns 10.39

Benchmark #2:

static Guid Test_Guid_CreateVersion7() => Guid.CreateVersion7();
static Guid Test_Guid_NewGuid() => Guid.NewGuid();
static Guid Test_FastGuid_NewGuid() => FastGuid.NewGuid();
static Guid Test_FastGuid_NewSqlServerGuid() => FastGuid.NewSqlServerGuid();

BenchmarkDotNet v0.13.8, Windows 10 (10.0.19045.4780/22H2/2022Update)
Intel Core i7-10510U CPU 1.80GHz, 1 CPU, 8 logical and 4 physical cores
.NET SDK 9.0.100-preview.7.24407.12
  [Host] : .NET 9.0.0 (9.0.24.40507), X64 RyuJIT AVX2
Method Mean Error StdDev Ratio
Test_Guid_CreateVersion7 149.7 ns 3.0 ns 5.9 ns 16x
Test_Guid_NewGuid 84.7 ns 1.7 ns 3.5 ns 9x
Test_FastGuid_NewGuid (base) 9.6 ns 0.2 ns 0.4 ns 1x
Test_FastGuid_NewSqlServerGuid 42.5 ns 0.9 ns 1.4 ns 4x
Product Compatible and additional computed target framework versions.
.NET net5.0 is compatible.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

  • net5.0

    • No dependencies.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.1.0 126 9/4/2024
1.0.6 694 1/22/2024
1.0.5 145 10/5/2023
1.0.4 300 12/24/2022
1.0.1 346 8/30/2021
1.0.0 331 8/15/2021
1.0.0-alpha 208 8/14/2021

Performance improvements.
~10x faster than Guid.NewGuid().
Performance-tested on .NET 9, 8, 7, 6, and 5.
New SqlServer Guid helper methods - see README.
New FastGuid.Fill() method - see README.