YDB .NET Ecosystem

Overview

This repository contains all official .NET libraries for working with YDB — a distributed SQL database by Yandex. All packages are developed, tested, and released from this single monorepo.

• Ydb.Sdk — Core SDK: ADO.NET provider, Topic (Pub/Sub) client, gRPC transport, session pooling, retry policies.
• EntityFrameworkCore.Ydb — Entity Framework Core provider built on top of Ydb.Sdk.
• Ydb.Sdk.OpenTelemetry — OpenTelemetry instrumentation: tracing and metrics extensions.

Packages

Package	NuGet	README	Documentation
Ydb.Sdk		README	ADO.NET, Topic
EntityFrameworkCore.Ydb		README	EF Core
Ydb.Sdk.OpenTelemetry		README	—

Quick Start

dotnet add package Ydb.Sdk

await using var dataSource = new YdbDataSource("Host=localhost;Port=2136;Database=/local");
await using var connection = await dataSource.OpenConnectionAsync();

await using var cmd = new YdbCommand("SELECT 1;", connection);
await cmd.ExecuteNonQueryAsync();

Examples

Ready-to-run example projects live in the examples/ folder:

Example	Description
AdoNet.QuickStart	Minimal ADO.NET usage
AdoNet.Dapper.QuickStart	Dapper integration
AdoNet.Yandex.Cloud	Connecting to YDB in Yandex Cloud
AdoNet.OpenTelemetry	Full OTel stack: Grafana + Tempo + Prometheus
Topic.QuickStart	Topic Pub/Sub client
EntityFrameworkCore.QuickStart	EF Core basics
EntityFrameworkCore.Samples	EF Core — LINQ queries, relationships
Linq2db.QuickStart	Linq2db integration

Versioning

This project follows SemVer 2.0.0:

• MAJOR — breaking changes
• MINOR — new features, backward compatible
• PATCH — bug fixes and internal improvements

Major version zero (0.y.z) is pre-release and does not guarantee backward compatibility.

Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

License

Licensed under the Apache 2.0 License.