Excalibur.Data.Spanner 10.0.0-alpha.10

This is a prerelease version of Excalibur.Data.Spanner.
dotnet add package Excalibur.Data.Spanner --version 10.0.0-alpha.10
                    
NuGet\Install-Package Excalibur.Data.Spanner -Version 10.0.0-alpha.10
                    
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="Excalibur.Data.Spanner" Version="10.0.0-alpha.10" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Excalibur.Data.Spanner" Version="10.0.0-alpha.10" />
                    
Directory.Packages.props
<PackageReference Include="Excalibur.Data.Spanner" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Excalibur.Data.Spanner --version 10.0.0-alpha.10
                    
#r "nuget: Excalibur.Data.Spanner, 10.0.0-alpha.10"
                    
#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.
#:package Excalibur.Data.Spanner@10.0.0-alpha.10
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Excalibur.Data.Spanner&version=10.0.0-alpha.10&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=Excalibur.Data.Spanner&version=10.0.0-alpha.10&prerelease
                    
Install as a Cake Tool

Excalibur.Data.Spanner

Google Cloud Spanner data-provider foundation for Excalibur. Provides the non-Dapper adapter base that the forthcoming Excalibur.*.Spanner persistence stores (event store, outbox, inbox, saga) will build on — those stores are not yet shipped in this package.

Spanner is not a Dapper target: it uses the mutation API rather than sequences/auto-increment, and has no pessimistic locking (FOR UPDATE ... SKIP LOCKED). Concurrency is optimistic — write conflicts surface as retryable ABORTED transactions.

What this package provides

  • SpannerOptions — project/instance/database addressing, emulator endpoint, and abort-retry tuning, validated at startup (ValidateOnStart).
  • ISpannerConnectionProvider — creates connections and runs work under ExecuteInRetryableTransactionAsync, replaying ABORTED transactions with exponential backoff.
  • SpannerCommitLimits — the Spanner per-commit ceilings (80,000 mutations / 100 MiB) the stores chunk against.
  • AddSpannerDataProvider(...) — one-time DI registration the store packages depend on.

Usage

services.AddSpannerDataProvider(o =>
{
    o.ProjectId = "my-project";
    o.InstanceId = "my-instance";
    o.DatabaseId = "my-database";
    // o.EmulatorHost = "localhost:9010"; // local development / integration tests
});

Set EmulatorHost (or the SPANNER_EMULATOR_HOST environment variable) to target the official Spanner emulator.

Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

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
10.0.0-alpha.10 61 9/6/2026
10.0.0-alpha.9 64 8/31/2026
10.0.0-alpha.8 68 8/14/2026
10.0.0-alpha.7 65 8/13/2026
10.0.0-alpha.6 78 8/11/2026
10.0.0-alpha.5 62 8/10/2026
10.0.0-alpha.4 62 8/10/2026