# sebastienros/yessql

A .NET document database working on any RDBMS

Repository: https://github.com/sebastienros/yessql
Canonical: https://ross.abutalabs.com/products/yessql
Language: C#
License: MIT
License Family: permissive
Last push: 2026-08-24T16:49:50+00:00

## Health v2 (maintenance only)
Score: 96/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 90, longevity 100
- inputs: {"age_days": 5331, "days_push": 9, "days_rel": 71, "gap_med": 17.0, "n_releases_24m": 11}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1360, forks 195 (observed 2026-08-28T04:04:29.887822+00:00)

## What it is
YesSql is a .NET document database library that stores documents and indexes in any relational database (SQL Server, PostgreSQL, MySQL, SQLite). It provides NoSQL-style document storage with map/reduce indexing while leveraging the transactional guarantees of SQL databases.

## Use cases
- store JSON documents in SQL Server with transactions
- use a document database without deploying MongoDB
- add document storage to an existing .NET application backed by PostgreSQL
- run map/reduce indexes over documents in MySQL
- get RavenDB-like document modeling on a free relational database
- persist POCO documents with SQL querying in .NET Core

## When to choose
- your team already runs and trusts a relational database
- you need transactional document storage in .NET
- you want document database semantics without extra infrastructure
- you need free, open-source document storage with map/reduce indexes

## When to avoid
- you need a dedicated document database's native scaling or features
- you prefer MongoDB or RavenDB and don't need SQL-backed storage
- you want a full ORM with change tracking and LINQ mappings
- your data model is strictly relational

## Facets
- artifact type: library
- maturity: active
- function: database, orm, serialization
- domain: databases, backend, web-development
- platform: dotnet, cross-platform
- tags: document-database, rdbms, nosql, dapper, csharp

## Member repositories
- sebastienros/yessql (main) score 96

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:29.887822+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:41:40.452108+00:00, confidence not recorded.
  - readme: https://github.com/sebastienros/yessql (fetched 2026-08-28T04:04:29.887822+00:00, sha 015135bbbb2a)
- Data as of 2026-08-30T08:39:29.467469+00:00.