Sylin.Koan.Data.Vector.Connector.MongoAtlasVector
1.0.93
dotnet add package Sylin.Koan.Data.Vector.Connector.MongoAtlasVector --version 1.0.93
NuGet\Install-Package Sylin.Koan.Data.Vector.Connector.MongoAtlasVector -Version 1.0.93
<PackageReference Include="Sylin.Koan.Data.Vector.Connector.MongoAtlasVector" Version="1.0.93" />
<PackageVersion Include="Sylin.Koan.Data.Vector.Connector.MongoAtlasVector" Version="1.0.93" />
<PackageReference Include="Sylin.Koan.Data.Vector.Connector.MongoAtlasVector" />
paket add Sylin.Koan.Data.Vector.Connector.MongoAtlasVector --version 1.0.93
#r "nuget: Sylin.Koan.Data.Vector.Connector.MongoAtlasVector, 1.0.93"
#:package Sylin.Koan.Data.Vector.Connector.MongoAtlasVector@1.0.93
#addin nuget:?package=Sylin.Koan.Data.Vector.Connector.MongoAtlasVector&version=1.0.93
#tool nuget:?package=Sylin.Koan.Data.Vector.Connector.MongoAtlasVector&version=1.0.93
Sylin.Koan.Data.Vector.Connector.MongoAtlasVector
Sylin.Koan.Data.Vector.Connector.MongoAtlasVector makes an existing Atlas deployment the vector
plane for ordinary Koan Vector<TEntity> calls. Referencing the package is the composition step;
the application keeps declaring spaces and using the shared vector API.
Usage: declare and search
dotnet add package Sylin.Koan.Data.Vector.Connector.MongoAtlasVector
builder.Services.AddKoan(koan =>
koan.Data.Source("Default").Vector<Article>(space => space
.Name("articles")
.Dimensions(768)
.Metric(VectorMetric.Cosine)
.Visibility(VectorVisibility.Session)));
await Vector<Article>.Save(article.Id, embedding, new { article.Category });
var related = await Vector<Article>.Search(embedding, query => query
.Top(12)
.Where(Filter.Eq("Category", article.Category)));
If the application already uses Sylin.Koan.Data.Connector.Mongo, the vector connector reuses that
Mongo endpoint. It writes to the separate KoanVectors database and _vector collections, so a
record and its vector can safely have the same Entity type and identity.
Configuration
{
"Koan": {
"Data": {
"MongoAtlasVector": {
"ConnectionString": "mongodb://atlas-host:27017",
"Database": "KoanVectors"
}
}
}
}
ConnectionStrings:MongoAtlasVector is also accepted. When neither vector setting is concrete, the
connector reuses Koan:Data:Mongo:ConnectionString, ConnectionStrings:Mongo, or the selected
Mongo source. A source may override vector placement under
Koan:Data:Sources:{source}:mongo-atlas-vector. The vector database never inherits the record
connector database; set it explicitly when KoanVectors is not the desired boundary.
Guarantees and boundaries
- Search is native Atlas Search with exhaustive
exact: trueexecution and scores normalized to[0,1]. - Awaited writes and deletes poll Atlas Search until the accepted revision is visible, providing the declared Session visibility with a bounded timeout.
- Metadata equality, comparison, set, existence, size, and boolean filters execute as native Atlas prefilters. Unsupported intent fails before returning a partial client-filtered answer.
- Batch work is native Mongo bulk I/O with ordered per-item outcomes; whole-batch atomicity is not claimed.
- Managed sources may create and validate collections and search indexes. Read-only and external sources never create schema and fail correctively when required shape is absent.
This package requires MongoDB Atlas with Search/Vector Search enabled. Ordinary MongoDB does not provide the required search-index commands or execution stage and is rejected; the connector never falls back to an in-memory approximation. Atlas Local is suitable for development and conformance, not a production topology recommendation.
| Product | Versions 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. |
-
net10.0
- Microsoft.Extensions.Configuration (>= 10.0.10)
- Microsoft.Extensions.Configuration.Abstractions (>= 10.0.10)
- Microsoft.Extensions.Configuration.Binder (>= 10.0.10)
- Microsoft.Extensions.Configuration.EnvironmentVariables (>= 10.0.10)
- Microsoft.Extensions.Configuration.Json (>= 10.0.10)
- Microsoft.Extensions.DependencyInjection (>= 10.0.10)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.10)
- Microsoft.Extensions.Hosting (>= 10.0.10)
- Microsoft.Extensions.Hosting.Abstractions (>= 10.0.10)
- Microsoft.Extensions.Logging (>= 10.0.10)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.10)
- Microsoft.Extensions.Logging.Console (>= 10.0.10)
- Microsoft.Extensions.Options (>= 10.0.10)
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 10.0.10)
- Microsoft.Extensions.Options.DataAnnotations (>= 10.0.10)
- MongoDB.Driver (>= 3.10.0)
- Newtonsoft.Json (>= 13.0.4)
- SharpCompress (>= 0.50.0)
- Snappier (>= 1.3.1)
- Sylin.Koan.Core (>= 1.0.39 && < 2.0.0)
- Sylin.Koan.Data.Abstractions (>= 1.0.41 && < 2.0.0)
- Sylin.Koan.Data.Core (>= 1.0.73 && < 2.0.0)
- Sylin.Koan.Data.Vector (>= 1.0.49 && < 2.0.0)
- Sylin.Koan.Data.Vector.Abstractions (>= 1.0.33 && < 2.0.0)
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.0.93 | 134 | 9/13/2026 |
| 1.0.90 | 116 | 9/12/2026 |
| 1.0.87 | 108 | 9/12/2026 |
| 1.0.85 | 113 | 9/10/2026 |
| 1.0.81 | 115 | 9/10/2026 |
| 1.0.77 | 115 | 9/9/2026 |
| 1.0.73 | 98 | 9/9/2026 |
| 1.0.70 | 105 | 9/9/2026 |
| 1.0.65 | 111 | 9/9/2026 |
| 1.0.63 | 106 | 9/9/2026 |
| 1.0.58 | 121 | 9/5/2026 |
| 1.0.57 | 123 | 8/30/2026 |
| 1.0.56 | 107 | 8/30/2026 |
| 1.0.55 | 113 | 8/28/2026 |
| 1.0.54 | 106 | 8/28/2026 |
| 1.0.53 | 104 | 8/28/2026 |
| 1.0.52 | 97 | 8/28/2026 |
| 1.0.51 | 113 | 8/28/2026 |
| 1.0.50 | 115 | 8/27/2026 |
| 1.0.45 | 131 | 8/25/2026 |