Skip to content

questdb/c-questdb-client

Repository files navigation

c-questdb-client

QuestDB - Client Library for Rust, C and C++

This library makes it easy to insert data into QuestDB.

This client library implements the InfluxDB Line Protocol (ILP) over HTTP and TCP.

  • Implementation is in Rust, with no additional run-time or link-time dependencies on the C++ standard library or other libraries.
  • We ship both a static and a dynamic library.
  • The library exposes Rust, C11 and C++17 APIs.
  • The C++ API is a header-only wrapper over the C API.
  • This library also has separate Python bindings.

Insertion Protocols Overview

Inserting data into QuestDB can be done in several ways.

This library supports ILP/HTTP (default-recommended) and ILP/TCP (specific streaming use cases).

Protocol Record Insertion Reporting Data Insertion Performance
ILP/HTTP Transaction-level (on flush) Excellent
ILP/TCP Errors in logs; Disconnect on error Best (tolerates higher-latency networks)
CSV Upload via HTTP Configurable Very Good
PostgreSQL Transaction-level Good

Server errors are only reported back to the client for ILP/HTTP. See the flush troubleshooting docs for more details on how to debug ILP/TCP.

For an overview and code examples, see the Ingestion overview page of the developer docs.

To understand the protocol in more depth, consult the protocol reference docs.

Getting Started

To get started, read the language-specific guides.

C

C++

Rust

Python

Further Topics

Community

If you need help, have additional questions or want to provide feedback, you may find us on our Community Forum.

You can also sign up to our mailing list to get notified of new releases.

License

The code is released under the Apache License.