Skip to main content
net10.0

Couchbase data provider for Koan: options binding and repository integration for document databases.

Published
Jun 12, 2026
4mo ago
Total Downloads
3.9K
3,856

Install

dotnet add package Sylin.Koan.Data.Connector.Couchbase --version 0.17.0
ProductVersions
.NET
net10.0

README

Koan.Data.Connector.Couchbase

Couchbase adapter that brings Koan's repository abstractions to Couchbase buckets, scopes, and collections. The adapter mirrors the MongoDB provider surface so document-first applications can swap providers with minimal changes.

Features

  • Options-first configuration with orchestration-aware defaults (ConnectionString=auto, Bucket=Koan).
  • IDataRepository implementation with bulk upsert/delete, transactional batches, and instruction execution (EnsureCreated, Clear).
  • LINQ predicate support translated to parameterised N1QL for common comparison and string operators.
  • N1QL query support via raw statements or CouchbaseQueryDefinition objects.
  • Guardrail-aware paging when DataQueryOptions are supplied.
  • Health contributor and telemetry activity source (Koan.Data.Connector.Couchbase).
  • Aspire/orchestration metadata to auto-provision Couchbase containers during local development.

See TECHNICAL.md for deeper implementation details.

Changes from Previous Version

v0.8.0v0.17.0
Added Dependencies
Snappier(net10.0)

Adoption Assessment

Assess this package against its supported frameworks, license, maintenance signals and dependency graph before making it a project standard.

Compatibility metadata lists 1 target framework; confirm the exact target used by your application.

Related Guides & Workflows

Learn how to evaluate, integrate, or audit this package in your .NET project.