veggerby/Shardis.Migrationv0.2.2
.NET 8.0.NET 9.0
Shardis key migration execution primitives (planner, executor, metrics hooks, in-memory implementations).
Get Started
$ dotnet add package Shardis.MigrationReadme
Shardis.Migration
Key migration execution primitives for Shardis. This package contains the executor, planner abstractions, checkpoint store contracts, and reference in-memory implementations used for tests and prototypes.
Install
dotnet add package Shardis.Migration --version 0.2.*
When to use
- Deterministic, idempotent key migration (copy → verify → swap) between shard topologies.
- Need pluggable verification (checksum, rowversion via provider) & projection abstractions.
- Require checkpointing & resume support during long-running migrations.
What’s included
- Planner models:
MigrationPlan<TKey>,KeyMove<TKey>,MigrationCheckpoint<TKey>. ShardMigrationExecutor<TKey>— orchestrates copy → verify → swap with checkpoint persistence & metrics hooks.- Abstractions:
IShardDataMover<TKey>,IVerificationStrategy<TKey>,IShardMigrationCheckpointStore<TKey>,IShardMapSwapper<TKey>,IShardMigrationMetrics. - Duration instrumentation: executor records per-key copy / verify latency, per-swap-batch latency, and total elapsed (extend for export).