https://github.com/DarkWanderer/ClickHouse.Client

.NET client for ClickHouse
https://github.com/DarkWanderer/ClickHouse.Client

ado-net clickhouse client database dotnet

Last synced: 3 months ago
JSON representation

.NET client for ClickHouse

• Host: GitHub
• URL: https://github.com/DarkWanderer/ClickHouse.Client
• Owner: DarkWanderer
• License: mit
• Created: 2019-10-15T20:29:16.000Z (about 5 years ago)
• Default Branch: main
• Last Pushed: 2024-04-08T01:58:03.000Z (7 months ago)
• Last Synced: 2024-04-08T19:13:08.281Z (7 months ago)
• Topics: ado-net, clickhouse, client, database, dotnet
• Language: C#
• Homepage:
• Size: 972 KB
• Stars: 279
• Watchers: 12
• Forks: 53
• Open Issues: 34
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

• awesome-clickhouse - DarkWanderer/ClickHouse.Client - ClickHouse.Client is a .NET ADO.NET client for the ultra-fast ClickHouse database. (Language bindings / .Net)

README

        
# ClickHouse.Client

ADO.NET client for [ClickHouse](https://github.com/ClickHouse/ClickHouse), ultra-fast 'big data' relational database

[![Latest version](https://img.shields.io/nuget/v/ClickHouse.Client)](https://www.nuget.org/packages/ClickHouse.Client/)

[![Downloads](https://img.shields.io/nuget/dt/ClickHouse.Client)](https://www.nuget.org/packages/ClickHouse.Client/)

[![License](https://img.shields.io/github/license/DarkWanderer/ClickHouse.Client)](https://github.com/DarkWanderer/ClickHouse.Client/blob/main/LICENSE)

[![Tests](https://github.com/DarkWanderer/ClickHouse.Client/actions/workflows/tests.yml/badge.svg)](https://github.com/DarkWanderer/ClickHouse.Client/actions/workflows/tests.yml)

## Key features

* High-throughput

* Fully supports ClickHouse-specific types:

  * Composite types: `Array`, `Tuple`, `Nullable`, `Nested`, `Map`, including combinations

  * Specialized types: `IPv4`, `IPv6`, `UUID`, `DateTime64`, `LowCardinality`, `Enum` etc.

  * Large arithmetic types: `(U)Int128`, `(U)Int256`, `Decimal128`, `Decimal256`

  * Note: JSON type support was officially dropped from ClickHouse itself

* Correctly handles `DateTime`, including time zones

* Supports [bulk insertion](https://github.com/DarkWanderer/ClickHouse.Client/wiki/Bulk-insertion)

* Uses compressed binary protocol over HTTP(S)

* Available for .NET Core/Framework/Standard

## Advantages

Compared to other existing .NET clients, `ClickHouse.Client` has following advantages 

* Does not have to buffer response, reducing memory usage

* Offers wider support for ClickHouse-specific types

* Is more compliant to ADO.NET standards (e.g. does not require calling 'NextResult' on `SELECT` queries)

* Works with ORM like Dapper, Linq2DB, Entity Framework Core etc.

## Documentation

Documentation for the library is available in [repository Wiki](https://github.com/DarkWanderer/ClickHouse.Client/wiki)