SnowBankSDK/foundationdb-dotnet-client

Это официальный C#/.NET биндинг для клиентской библиотеки FoundationDB. Он нужен .NET-разработчикам, которые используют FoundationDB как распределённое key-value хранилище и хотят работать с ним из C# через управляемый API.

Ключевые возможности

• Управляемый клиент для FoundationDB Client API на C#/.NET
• Регистрация в DI-контейнере через AddFoundationDb с провайдером IFdbDatabaseProvider
• Три способа подключения: через .NET Aspire, файл fdb.cluster или строку подключения
• Отдельный пакет FoundationDB.Client.Native, версия которого должна совпадать с кластером
• Кроссплатформенность: Windows, Linux и macOS
• Публикация в NuGet под лицензией BSD-3-Clause

Для каких задач подходит

• Работа с FoundationDB из ASP.NET Core или консольных .NET-приложений
• Подключение к локальному или удалённому кластеру FoundationDB через DI
• Интеграция FoundationDB в .NET Aspire-приложения через AppHost
• Использование распределённого key-value хранилища в C#-микросервисах
• Настройка соединения с кластером через fdb.cluster или строку подключения

Подробнее

Библиотека представляет собой managed-обёртку над нативной клиентской библиотекой FoundationDB. Она ставится как NuGet-пакет FoundationDB.Client, а для работы требуется отдельный пакет FoundationDB.Client.Native, версия которого должна совпадать с major.minor версией вашего кластера. Это ключевой момент: несовпадение версий проявляется как таймауты без явных ошибок, поэтому в документации ему уделено отдельное внимание.

Подключение строится через регистрацию в DI-контейнере: вызов AddFoundationDb добавляет синглтон IFdbDatabaseProvider. Кластер можно указать тремя способами: через интеграцию с .NET Aspire (AppHost передаёт соединение), через файл fdb.cluster на диске или через строку подключения вида docker:docker@127.0.0.1:4500. Первый способ рекомендуется авторами, если вы уже используете Aspire.

Для новичков в FoundationDB есть пошаговая документация: от предварительных требований и объяснения, как работает соединение, до настройки кластера и первого чтения и записи. Обратите внимание, что это именно клиентский биндинг, а не серверная часть: для работы нужен развёрнутый кластер FoundationDB.