CamusDB.Client
0.19.0
dotnet add package CamusDB.Client --version 0.19.0
NuGet\Install-Package CamusDB.Client -Version 0.19.0
<PackageReference Include="CamusDB.Client" Version="0.19.0" />
<PackageVersion Include="CamusDB.Client" Version="0.19.0" />
<PackageReference Include="CamusDB.Client" />
paket add CamusDB.Client --version 0.19.0
#r "nuget: CamusDB.Client, 0.19.0"
#:package CamusDB.Client@0.19.0
#addin nuget:?package=CamusDB.Client&version=0.19.0
#tool nuget:?package=CamusDB.Client&version=0.19.0
CamusDB Connector for .NET
.NET client libraries for CamusDB, a distributed SQL database.
| Package | Use it to |
|---|---|
CamusDB.Client |
Run SQL from .NET through ADO.NET, the standard .NET database API (DbConnection, DbCommand, DbDataReader). |
CamusDB.EntityFrameworkCore |
Use Entity Framework Core (EF Core), the .NET object-relational mapper, with CamusDB. It is built on CamusDB.Client. |
CamusDB.Dapper |
Use Dapper, a small mapper from SQL rows to C# objects, with the CamusDB types. |
CamusDB.OpenTelemetry |
Collect the traces and metrics of the driver with the OpenTelemetry SDK. |
Quick start
Start a CamusDB server. This example uses the REST port
5095on your computer.Add the package:
dotnet add package CamusDB.ClientConnect and run a query:
using CamusDB.Client; CamusConnectionStringBuilder builder = new("Endpoint=http://localhost:5095;Database=test"); await using CamusConnection connection = new(builder); await connection.OpenAsync(); await connection.CreateDatabaseAsync(ifNotExists: true); // a database must exist before you use it await using CamusCommand command = connection.CreateCamusCommand("SELECT 1"); await using CamusDataReader reader = await command.ExecuteReaderAsync();
Documentation
The links are absolute because NuGet shows this file as the package page.
CamusDB.Client (ADO.NET)
| Document | Contents |
|---|---|
| Connection | Installation, connection string keys, endpoint pools |
| Authentication | Users, passwords, tokens, TLS, error codes |
| Transport | REST or gRPC, HTTP/2 and HTTP/3 |
| Learned routing | Send statements directly to the node that leads the data |
| Databases and DDL | Create and drop databases, ping, schema statements, truncate |
| Data types | Column types, NUMERIC, JSONB, large values |
| Writing data | INSERT, RETURNING, ON CONFLICT, UPSERT |
| Reading data | SELECT, streaming results, query result cache |
| Transactions | Transactions, isolation, locking, retries |
| Prepared statements | Automatic and explicit statement preparation |
| C# extensions | Stored procedures, triggers, extension functions and inline functions written in C# |
| Backups | Online backups and point-in-time recovery |
| Node stats | Disk, CPU and memory of a node |
| Provider factory | DbProviderFactory and DbDataSource |
| OpenTelemetry | Traces and metrics |
CamusDB.EntityFrameworkCore (EF Core)
| Document | Contents |
|---|---|
| Configuration | Installation, UseCamusDB, retries, isolation defaults |
| Model and types | Entities, type mapping, database lifecycle |
| Saving data | Insert, update, delete, bulk update and delete, truncate |
| Queries | LINQ translation, strings, JSON, vector search, joins |
| Migrations | Schema migrations, comments, large values |
| Views | Views and materialized views |
| Relationships and concurrency | Foreign keys, concurrency tokens |
| Functions and limitations | Extension functions, what the provider does not support |
CamusDB.Dapper
| Document | Contents |
|---|---|
| Dapper | Typed values, arrays, IN lists, limitations |
Run the tests
The tests need a CamusDB server on your computer. Start the server, then run:
dotnet test -l "console;verbosity=normal" --filter "FullyQualifiedName~CamusDB.Client.Tests"
Contribution
Contributions are welcome: bug fixes, features and documentation. Open an issue or a pull request on GitHub.
License
MIT License.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 is compatible. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. 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
- Flurl (>= 4.0.0)
- Flurl.Http (>= 4.0.2)
- Google.Protobuf (>= 3.36.2)
- Grpc.Net.Client (>= 2.85.0)
-
net8.0
- Flurl (>= 4.0.0)
- Flurl.Http (>= 4.0.2)
- Google.Protobuf (>= 3.36.2)
- Grpc.Net.Client (>= 2.85.0)
-
net9.0
- Flurl (>= 4.0.0)
- Flurl.Http (>= 4.0.2)
- Google.Protobuf (>= 3.36.2)
- Grpc.Net.Client (>= 2.85.0)
NuGet packages (5)
Showing the top 5 NuGet packages that depend on CamusDB.Client:
| Package | Downloads |
|---|---|
|
CamusDB.EntityFrameworkCore
CamusDB.EntityFrameworkCore provides Entity Framework Core support for CamusDB. |
|
|
CamusDB.Dapper
CamusDB.Dapper adds CamusDB-specific parameter types and type handlers to Dapper. |
|
|
CamusDB.OpenTelemetry
CamusDB.OpenTelemetry registers the CamusDB.Client activity source and meter with the OpenTelemetry SDK. |
|
|
CamusDB.Aspire.Client
Aspire client integration for CamusDB: AddCamusDBClient() registers CamusDB.Client connections in dependency injection, with health checks, tracing and metrics. |
|
|
CamusDB.Aspire.Hosting
Aspire hosting integration for CamusDB: AddCamusDB() runs a CamusDB server container in an Aspire AppHost, AddCamusDBCluster() runs a CamusDB cluster, and AddDatabase() creates their databases. |
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 0.19.0 | 0 | 11/16/2026 |
| 0.18.3 | 51 | 11/15/2026 |
| 0.18.2 | 59 | 11/14/2026 |
| 0.18.1 | 336 | 11/11/2026 |
| 0.18.0 | 135 | 11/9/2026 |
| 0.17.5 | 137 | 11/6/2026 |
| 0.17.4 | 348 | 11/3/2026 |
| 0.17.3 | 137 | 11/3/2026 |
| 0.17.2 | 166 | 11/1/2026 |
| 0.17.1 | 138 | 10/31/2026 |
| 0.17.0 | 145 | 10/31/2026 |
| 0.16.9 | 394 | 10/28/2026 |
| 0.16.6 | 138 | 10/28/2026 |
| 0.16.5 | 138 | 10/27/2026 |
| 0.16.4 | 301 | 10/26/2026 |
| 0.16.3 | 134 | 10/26/2026 |
| 0.16.2 | 151 | 10/25/2026 |
| 0.16.1 | 194 | 10/22/2026 |
| 0.16.0 | 184 | 10/19/2026 |
| 0.15.4 | 137 | 10/17/2026 |