Skip to content
This repository was archived by the owner on Nov 7, 2025. It is now read-only.

Commit 7f5dd2b

Browse files
authored
Add "ClickHouse engine" limitation (#936)
Currently Quesma auto-creates tables with `MergeTree` engine. It's automatically converted to `ReplicatedMergeTree` in case of ClickHouse Cloud, but not in case of a local multi-node cluster and the user can't control it. If the user has a local multi-node cluster, the tables automatically created by Quesma won't be replicated - the only solution is to create them manually with the correct `ReplicatedMergeTree` engine. Refs #934 Signed-off-by: Piotr Grabowski <[email protected]>
1 parent c61a7e3 commit 7f5dd2b

File tree

1 file changed

+5
-0
lines changed

1 file changed

+5
-0
lines changed

docs/public/docs/limitations.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,9 +14,14 @@ Quesma has been tested with the following software versions:
1414
| Docker | `24.0.7` |
1515
| Elasticsearch/Kibana | `8.11.1` |
1616
| ClickHouse | `24.1`, `23.12` |
17+
| ClickHouse Cloud | `24.5` |
1718
| OpenSearch/OpenSearch Dashboards | `2.12.0` |
1819
| Hydrolix | `v4.8.12` |
1920

21+
### ClickHouse limitations
22+
* When using a cluster deployment of ClickHouse, the tables automatically created by Quesma (during [Ingest](/ingest.md)) will use the `MergeTree` engine. If you wish to use the `ReplicatedMergeTree` engine instead, you will have to create the tables manually with `ReplicatedMergeTree` engine before ingesting data to Quesma.
23+
* *Note: On ClickHouse Cloud, the tables automatically created by Quesma will use the `ReplicatedMergeTree` engine (ClickHouse Cloud default engine).*
24+
2025
## Functional limitations
2126
Currently supported:
2227
- front-end support for Kibana and Open Search Dashboards, limited to Discover(LogExplorer) interface and Dashboard panels

0 commit comments

Comments
 (0)