Creating a ClickHouse Database

This page covers the configuration specific to ClickHouse — its Database Mode and any engine-specific settings shown below. The rest of the creation flow — opening the wizard, namespace and name, version, machine profile, storage, and optional features — is the same for every engine and is documented in Common Steps.

Database Mode

Select the topology under Database Mode:

  • Standalone — A single-node ClickHouse instance.
  • Topology — A distributed ClickHouse cluster with sharding/replication, coordinated by ClickHouse Keeper.

Topology mode selected showing Cluster and ClickHouse Keeper configuration

Cluster

FieldDescription
ShardsNumber of shard partitions. Required.
ReplicasNumber of replicas per shard. Required.

ClickHouse Keeper — Provides coordination/metadata for the cluster (the ClickHouse-native alternative to ZooKeeper). Configure its node count and resources.

Create a ClickHouse Database

  1. Open the wizard and select ClickHouse — see Getting Started and Select a Database Type.
  2. Set the namespace and name.
  3. Pick the database version and the Database Mode described above, then set the machine profile and storage — see Configure the Database.
  4. Optionally configure Advanced Configuration (labels, deletion policy, credentials, point-in-time recovery) and Additional Options (monitoring, backup, TLS, gateway).
  5. Click Deploy.