# [Your product] and ClickHouse
[One to three sentences: what the integration does and why a
ClickHouse user would want it.]
## Prerequisites
- [Your product, version X.Y or later]
- ClickHouse Cloud, or self-hosted ClickHouse version [X.Y] or later
- [Anything else: driver, plugin, network access requirements]
### Version matrix
| [Your product] | ClickHouse Cloud | ClickHouse open source | Notes |
| -------------- | ---------------- | ---------------------- | -------- |
| X.Y | ✅ | ✅ 24.x+ | [if any] |
## Setup
### Connect to ClickHouse Cloud
1. In the ClickHouse Cloud console, select your service and click **Connect**.
2. Choose **HTTPS**. Copy the host, port (8443), username, and password.
3. In [your product], [steps to configure the connection].
### Connect to self-hosted ClickHouse
1. [How to point at a self-hosted instance — host, port 8123 or 9000, TLS notes.]
2. In [your product], [steps to configure the connection].
## 인증
[List supported auth modes — username/password over TLS, mTLS, etc. — and how
to configure each.]
## Example: querying the [dataset] dataset
[Walkthrough using one of the ClickHouse example datasets, end-to-end.]
## Known limits
- [Types not yet supported, e.g., deeply nested JSON]
- [Result-set size thresholds or other performance notes]
- [Feature gaps]
## Troubleshooting
### [Common error message]
[Cause and resolution.]
### [Another common error]
[Cause and resolution.]
