From bcdb558ed2d394c4aef12baea36b03f66ed74f95 Mon Sep 17 00:00:00 2001
From: Ishaan Jaff <ishaan@berri.ai>
Date: Tue, 29 Sep 2026 22:45:49 -0700
Subject: [PATCH] feat(agent-tracing): add async clickhouse http client

---
 .../clickhouse/clickhouse_client.py           | 73 +++++++++++++++++++
 1 file changed, 73 insertions(+)
 create mode 100644 litellm/integrations/clickhouse/clickhouse_client.py

diff --git a/litellm/integrations/clickhouse/clickhouse_client.py b/litellm/integrations/clickhouse/clickhouse_client.py
new file mode 100644
index 00000000000..859a44cb803
--- /dev/null
+++ b/litellm/integrations/clickhouse/clickhouse_client.py
@@ -0,0 +1,73 @@
+"""
+Minimal async ClickHouse client over the HTTP interface.
+
+Uses LiteLLM's shared httpx client — no clickhouse driver dependency.
+`AsyncHTTPHandler.post` raises on non-2xx, so callers see ClickHouse errors as exceptions.
+"""
+
+import gzip
+import json
+from typing import Any, Dict, List, Optional
+
+from litellm.llms.custom_httpx.http_handler import get_async_httpx_client
+from litellm.types.llms.custom_http import httpxSpecialProvider
+
+
+class ClickHouseClient:
+    def __init__(self, url: str, user: str, password: str, database: str):
+        if not url:
+            raise ValueError("ClickHouse url is required")
+        self.url = url.rstrip("/") + "/"
+        self.database = database
+        self.auth_headers = {"X-ClickHouse-User": user, "X-ClickHouse-Key": password}
+        self.http = get_async_httpx_client(
+            llm_provider=httpxSpecialProvider.LoggingCallback
+        )
+
+    async def execute(self, sql: str) -> None:
+        await self.http.post(self.url, content=sql.encode(), headers=self.auth_headers)
+
+    async def insert_json_each_row(
+        self, table: str, rows: List[Dict[str, Any]]
+    ) -> None:
+        if not rows:
+            return
+        body = gzip.compress(
+            "\n".join(json.dumps(r, default=str) for r in rows).encode()
+        )
+        await self.http.post(
+            self.url,
+            params={
+                "query": f"INSERT INTO {self.database}.{table} FORMAT JSONEachRow",
+                "async_insert": "1",
+                "wait_for_async_insert": "1",
+                "input_format_skip_unknown_fields": "1",
+                "date_time_input_format": "best_effort",
+            },
+            content=body,
+            headers={**self.auth_headers, "Content-Encoding": "gzip"},
+        )
+
+    async def query(
+        self, sql: str, params: Optional[Dict[str, Any]] = None
+    ) -> List[Dict[str, Any]]:
+        """Parameterized SELECT. Use `{name:Type}` placeholders in `sql`."""
+        query_params = {
+            f"param_{k}": (
+                "[" + ",".join(f"'{x}'" for x in v) + "]"
+                if isinstance(v, list)
+                else str(v)
+            )
+            for k, v in (params or {}).items()
+        }
+        response = await self.http.post(
+            self.url,
+            params={
+                "default_format": "JSON",
+                "database": self.database,
+                **query_params,
+            },
+            content=sql.encode(),
+            headers=self.auth_headers,
+        )
+        return response.json()["data"]