agno 2.2.13__py3-none-any.whl

agno/vectordb/clickhouse/clickhousedb.py

@@ -0,0 +1,835 @@
+import asyncio
+from hashlib import md5
+from typing import Any, Dict, List, Optional, Union
+
+from agno.vectordb.clickhouse.index import HNSW
+
+try:
+    import clickhouse_connect
+    import clickhouse_connect.driver.asyncclient
+    import clickhouse_connect.driver.client
+except ImportError:
+    raise ImportError("`clickhouse-connect` not installed. Use `pip install clickhouse-connect` to install it")
+
+from agno.filters import FilterExpr
+from agno.knowledge.document import Document
+from agno.knowledge.embedder import Embedder
+from agno.utils.log import log_debug, log_info, log_warning, logger
+from agno.vectordb.base import VectorDb
+from agno.vectordb.distance import Distance
+
+
+class Clickhouse(VectorDb):
+    def __init__(
+        self,
+        table_name: str,
+        host: str,
+        name: Optional[str] = None,
+        description: Optional[str] = None,
+        username: Optional[str] = None,
+        password: str = "",
+        port: int = 0,
+        database_name: str = "ai",
+        dsn: Optional[str] = None,
+        compress: str = "lz4",
+        client: Optional[clickhouse_connect.driver.client.Client] = None,
+        asyncclient: Optional[clickhouse_connect.driver.asyncclient.AsyncClient] = None,
+        embedder: Optional[Embedder] = None,
+        distance: Distance = Distance.cosine,
+        index: Optional[HNSW] = HNSW(),
+    ):
+        # Store connection parameters as instance attributes
+        self.host = host
+        self.username = username
+        self.password = password
+        self.port = port
+        self.dsn = dsn
+        # Initialize base class with name and description
+        super().__init__(name=name, description=description)
+
+        self.compress = compress
+        self.database_name = database_name
+        if not client:
+            client = clickhouse_connect.get_client(
+                host=self.host,
+                username=self.username,  # type: ignore
+                password=self.password,
+                database=self.database_name,
+                port=self.port,
+                dsn=self.dsn,
+                compress=self.compress,
+            )
+
+        # Database attributes
+        self.client = client
+        self.async_client = asyncclient
+        self.table_name = table_name
+
+        # Embedder for embedding the document contents
+        _embedder = embedder
+        if _embedder is None:
+            from agno.knowledge.embedder.openai import OpenAIEmbedder
+
+            _embedder = OpenAIEmbedder()
+            log_info("Embedder not provided, using OpenAIEmbedder as default.")
+        self.embedder: Embedder = _embedder
+        self.dimensions: Optional[int] = self.embedder.dimensions
+
+        # Distance metric
+        self.distance: Distance = distance
+
+        # Index for the collection
+        self.index: Optional[HNSW] = index
+
+    async def _ensure_async_client(self):
+        """Ensure we have an initialized async client."""
+        if self.async_client is None:
+            self.async_client = await clickhouse_connect.get_async_client(
+                host=self.host,
+                username=self.username,  # type: ignore
+                password=self.password,
+                database=self.database_name,
+                port=self.port,
+                dsn=self.dsn,
+                compress=self.compress,
+                settings={"allow_experimental_vector_similarity_index": 1},
+            )
+        return self.async_client
+
+    def _get_base_parameters(self) -> Dict[str, Any]:
+        return {
+            "table_name": self.table_name,
+            "database_name": self.database_name,
+        }
+
+    def table_exists(self) -> bool:
+        log_debug(f"Checking if table exists: {self.table_name}")
+        try:
+            parameters = self._get_base_parameters()
+            return bool(
+                self.client.command(
+                    "EXISTS TABLE {database_name:Identifier}.{table_name:Identifier}",
+                    parameters=parameters,
+                )
+            )
+        except Exception as e:
+            logger.error(e)
+            return False
+
+    async def async_table_exists(self) -> bool:
+        """Check if a table exists asynchronously."""
+        log_debug(f"Async checking if table exists: {self.table_name}")
+        try:
+            async_client = await self._ensure_async_client()
+
+            parameters = self._get_base_parameters()
+            result = await async_client.command(
+                "EXISTS TABLE {database_name:Identifier}.{table_name:Identifier}",
+                parameters=parameters,
+            )
+            return bool(result)
+        except Exception as e:
+            logger.error(f"Async error checking if table exists: {e}")
+            return False
+
+    def create(self) -> None:
+        if not self.table_exists():
+            log_debug(f"Creating Database: {self.database_name}")
+            parameters = {"database_name": self.database_name}
+            self.client.command(
+                "CREATE DATABASE IF NOT EXISTS {database_name:Identifier}",
+                parameters=parameters,
+            )
+
+            log_debug(f"Creating table: {self.table_name}")
+
+            parameters = self._get_base_parameters()
+
+            if isinstance(self.index, HNSW):
+                index = (
+                    f"INDEX embedding_index embedding TYPE vector_similarity('hnsw', 'L2Distance', {self.embedder.dimensions}, {self.index.quantization}, "
+                    f"{self.index.hnsw_max_connections_per_layer}, {self.index.hnsw_candidate_list_size_for_construction})"
+                )
+                self.client.command("SET allow_experimental_vector_similarity_index = 1")
+            else:
+                raise NotImplementedError(f"Not implemented index {type(self.index)!r} is passed")
+
+            self.client.command("SET enable_json_type = 1")
+
+            self.client.command(
+                f"""CREATE TABLE IF NOT EXISTS {{database_name:Identifier}}.{{table_name:Identifier}}
+                (
+                    id String,
+                    name String,
+                    meta_data JSON DEFAULT '{{}}',
+                    filters JSON DEFAULT '{{}}',
+                    content String,
+                    content_id String,
+                    embedding Array(Float32),
+                    usage JSON,
+                    created_at DateTime('UTC') DEFAULT now(),
+                    content_hash String,
+                    PRIMARY KEY (id),
+                    {index}
+                ) ENGINE = ReplacingMergeTree ORDER BY id""",
+                parameters=parameters,
+            )
+
+    async def async_create(self) -> None:
+        """Create database and table asynchronously."""
+        if not await self.async_table_exists():
+            log_debug(f"Async creating Database: {self.database_name}")
+            async_client = await self._ensure_async_client()
+
+            parameters = {"database_name": self.database_name}
+            await async_client.command(
+                "CREATE DATABASE IF NOT EXISTS {database_name:Identifier}",
+                parameters=parameters,
+            )
+
+            log_debug(f"Async creating table: {self.table_name}")
+            parameters = self._get_base_parameters()
+
+            if isinstance(self.index, HNSW):
+                index = (
+                    f"INDEX embedding_index embedding TYPE vector_similarity('hnsw', 'L2Distance', {self.index.quantization}, "
+                    f"{self.index.hnsw_max_connections_per_layer}, {self.index.hnsw_candidate_list_size_for_construction})"
+                )
+                await async_client.command("SET allow_experimental_vector_similarity_index = 1")
+            else:
+                raise NotImplementedError(f"Not implemented index {type(self.index)!r} is passed")
+
+            await self.async_client.command("SET enable_json_type = 1")  # type: ignore
+
+            await self.async_client.command(  # type: ignore
+                f"""CREATE TABLE IF NOT EXISTS {{database_name:Identifier}}.{{table_name:Identifier}}
+                (
+                    id String,
+                    name String,
+                    meta_data JSON DEFAULT '{{}}',
+                    filters JSON DEFAULT '{{}}',
+                    content String,
+                    content_id String,
+                    embedding Array(Float32),
+                    usage JSON,
+                    created_at DateTime('UTC') DEFAULT now(),
+                    content_hash String,
+                    PRIMARY KEY (id),
+                    {index}
+                ) ENGINE = ReplacingMergeTree ORDER BY id""",
+                parameters=parameters,
+            )
+
+    def name_exists(self, name: str) -> bool:
+        """
+        Validate if a row with this name exists or not
+
+        Args:
+            name (str): Name to check
+        """
+        parameters = self._get_base_parameters()
+        parameters["name"] = name
+
+        result = self.client.query(
+            "SELECT name FROM {database_name:Identifier}.{table_name:Identifier} WHERE name = {name:String}",
+            parameters=parameters,
+        )
+        return len(result.result_rows) > 0 if result.result_rows else False
+
+    async def async_name_exists(self, name: str) -> bool:
+        """Check if a document with given name exists asynchronously."""
+        parameters = self._get_base_parameters()
+        async_client = await self._ensure_async_client()
+
+        parameters["name"] = name
+
+        result = await async_client.query(
+            "SELECT name FROM {database_name:Identifier}.{table_name:Identifier} WHERE name = {name:String}",
+            parameters=parameters,
+        )
+        return len(result.result_rows) > 0 if result.result_rows else False
+
+    def id_exists(self, id: str) -> bool:
+        """
+        Validate if a row with this id exists or not
+
+        Args:
+            id (str): Id to check
+        """
+        parameters = self._get_base_parameters()
+        parameters["id"] = id
+
+        result = self.client.query(
+            "SELECT id FROM {database_name:Identifier}.{table_name:Identifier} WHERE id = {id:String}",
+            parameters=parameters,
+        )
+        return len(result.result_rows) > 0 if result.result_rows else False
+
+    def insert(
+        self,
+        content_hash: str,
+        documents: List[Document],
+        filters: Optional[Dict[str, Any]] = None,
+    ) -> None:
+        rows: List[List[Any]] = []
+        for document in documents:
+            document.embed(embedder=self.embedder)
+            cleaned_content = document.content.replace("\x00", "\ufffd")
+            _id = md5(cleaned_content.encode()).hexdigest()
+
+            row: List[Any] = [
+                _id,
+                document.name,
+                document.meta_data,
+                filters,
+                cleaned_content,
+                document.content_id,
+                document.embedding,
+                document.usage,
+                content_hash,
+            ]
+            rows.append(row)
+
+        self.client.insert(
+            f"{self.database_name}.{self.table_name}",
+            rows,
+            column_names=[
+                "id",
+                "name",
+                "meta_data",
+                "filters",
+                "content",
+                "content_id",
+                "embedding",
+                "usage",
+                "content_hash",
+            ],
+        )
+        log_debug(f"Inserted {len(documents)} documents")
+
+    async def async_insert(
+        self, content_hash: str, documents: List[Document], filters: Optional[Dict[str, Any]] = None
+    ) -> None:
+        """Insert documents asynchronously."""
+        rows: List[List[Any]] = []
+        async_client = await self._ensure_async_client()
+
+        if self.embedder.enable_batch and hasattr(self.embedder, "async_get_embeddings_batch_and_usage"):
+            # Use batch embedding when enabled and supported
+            try:
+                # Extract content from all documents
+                doc_contents = [doc.content for doc in documents]
+
+                # Get batch embeddings and usage
+                embeddings, usages = await self.embedder.async_get_embeddings_batch_and_usage(doc_contents)
+
+                # Process documents with pre-computed embeddings
+                for j, doc in enumerate(documents):
+                    try:
+                        if j < len(embeddings):
+                            doc.embedding = embeddings[j]
+                            doc.usage = usages[j] if j < len(usages) else None
+                    except Exception as e:
+                        logger.error(f"Error assigning batch embedding to document '{doc.name}': {e}")
+
+            except Exception as e:
+                # Check if this is a rate limit error - don't fall back as it would make things worse
+                error_str = str(e).lower()
+                is_rate_limit = any(
+                    phrase in error_str
+                    for phrase in ["rate limit", "too many requests", "429", "trial key", "api calls / minute"]
+                )
+
+                if is_rate_limit:
+                    logger.error(f"Rate limit detected during batch embedding. {e}")
+                    raise e
+                else:
+                    logger.warning(f"Async batch embedding failed, falling back to individual embeddings: {e}")
+                    # Fall back to individual embedding
+                    embed_tasks = [doc.async_embed(embedder=self.embedder) for doc in documents]
+                    await asyncio.gather(*embed_tasks, return_exceptions=True)
+        else:
+            # Use individual embedding
+            embed_tasks = [document.async_embed(embedder=self.embedder) for document in documents]
+            await asyncio.gather(*embed_tasks, return_exceptions=True)
+
+        for document in documents:
+            cleaned_content = document.content.replace("\x00", "\ufffd")
+            _id = md5(cleaned_content.encode()).hexdigest()
+
+            row: List[Any] = [
+                _id,
+                document.name,
+                document.meta_data,
+                filters,
+                cleaned_content,
+                document.content_id,
+                document.embedding,
+                document.usage,
+                content_hash,
+            ]
+            rows.append(row)
+
+        await async_client.insert(
+            f"{self.database_name}.{self.table_name}",
+            rows,
+            column_names=[
+                "id",
+                "name",
+                "meta_data",
+                "filters",
+                "content",
+                "content_id",
+                "embedding",
+                "usage",
+                "content_hash",
+            ],
+        )
+        log_debug(f"Async inserted {len(documents)} documents")
+
+    def upsert_available(self) -> bool:
+        return True
+
+    def upsert(
+        self,
+        content_hash: str,
+        documents: List[Document],
+        filters: Optional[Dict[str, Any]] = None,
+    ) -> None:
+        """
+        Upsert documents into the database.
+        """
+        if self.content_hash_exists(content_hash):
+            self._delete_by_content_hash(content_hash)
+        self.insert(content_hash=content_hash, documents=documents, filters=filters)
+
+    def _upsert(
+        self,
+        content_hash: str,
+        documents: List[Document],
+        filters: Optional[Dict[str, Any]] = None,
+    ) -> None:
+        """
+        Upsert documents into the database.
+
+        Args:
+            documents (List[Document]): List of documents to upsert
+            filters (Optional[Dict[str, Any]]): Filters to apply while upserting documents
+            batch_size (int): Batch size for upserting documents
+        """
+        # We are using ReplacingMergeTree engine in our table, so we need to insert the documents,
+        # then call SELECT with FINAL
+        self.insert(content_hash=content_hash, documents=documents, filters=filters)
+
+        parameters = self._get_base_parameters()
+        self.client.query(
+            "SELECT id FROM {database_name:Identifier}.{table_name:Identifier} FINAL",
+            parameters=parameters,
+        )
+
+    async def async_upsert(
+        self, content_hash: str, documents: List[Document], filters: Optional[Dict[str, Any]] = None
+    ) -> None:
+        """Upsert documents asynchronously."""
+        if self.content_hash_exists(content_hash):
+            self._delete_by_content_hash(content_hash)
+        await self._async_upsert(content_hash=content_hash, documents=documents, filters=filters)
+
+    async def _async_upsert(
+        self, content_hash: str, documents: List[Document], filters: Optional[Dict[str, Any]] = None
+    ) -> None:
+        """Upsert documents asynchronously."""
+        # We are using ReplacingMergeTree engine in our table, so we need to insert the documents,
+        # then call SELECT with FINAL
+        await self.async_insert(content_hash=content_hash, documents=documents, filters=filters)
+
+        parameters = self._get_base_parameters()
+        await self.async_client.query(  # type: ignore
+            "SELECT id FROM {database_name:Identifier}.{table_name:Identifier} FINAL",
+            parameters=parameters,
+        )
+
+    def search(
+        self, query: str, limit: int = 5, filters: Optional[Union[Dict[str, Any], List[FilterExpr]]] = None
+    ) -> List[Document]:
+        if filters is not None:
+            log_warning("Filters are not yet supported in Clickhouse. No filters will be applied.")
+        query_embedding = self.embedder.get_embedding(query)
+        if query_embedding is None:
+            logger.error(f"Error getting embedding for Query: {query}")
+            return []
+
+        parameters = self._get_base_parameters()
+        where_query = ""
+
+        order_by_query = ""
+        if self.distance == Distance.l2 or self.distance == Distance.max_inner_product:
+            order_by_query = "ORDER BY L2Distance(embedding, {query_embedding:Array(Float32)})"
+            parameters["query_embedding"] = query_embedding
+        if self.distance == Distance.cosine:
+            order_by_query = "ORDER BY cosineDistance(embedding, {query_embedding:Array(Float32)})"
+            parameters["query_embedding"] = query_embedding
+
+        clickhouse_query = (
+            "SELECT name, meta_data, content, content_id, embedding, usage FROM "
+            "{database_name:Identifier}.{table_name:Identifier} "
+            f"{where_query} {order_by_query} LIMIT {limit}"
+        )
+        log_debug(f"Query: {clickhouse_query}")
+        log_debug(f"Params: {parameters}")
+
+        try:
+            results = self.client.query(
+                clickhouse_query,
+                parameters=parameters,
+            )
+        except Exception as e:
+            logger.error(f"Error searching for documents: {e}")
+            logger.error("Table might not exist, creating for future use")
+            self.create()
+            return []
+
+        # Build search results
+        search_results: List[Document] = []
+        for result in results.result_rows:
+            search_results.append(
+                Document(
+                    name=result[0],
+                    meta_data=result[1],
+                    content=result[2],
+                    content_id=result[3],
+                    embedder=self.embedder,
+                    embedding=result[4],
+                    usage=result[5],
+                )
+            )
+
+        return search_results
+
+    async def async_search(
+        self, query: str, limit: int = 5, filters: Optional[Union[Dict[str, Any], List[FilterExpr]]] = None
+    ) -> List[Document]:
+        """Search for documents asynchronously."""
+        async_client = await self._ensure_async_client()
+
+        if filters is not None:
+            log_warning("Filters are not yet supported in Clickhouse. No filters will be applied.")
+
+        query_embedding = self.embedder.get_embedding(query)
+        if query_embedding is None:
+            logger.error(f"Error getting embedding for Query: {query}")
+            return []
+
+        parameters = self._get_base_parameters()
+        where_query = ""
+
+        order_by_query = ""
+        if self.distance == Distance.l2 or self.distance == Distance.max_inner_product:
+            order_by_query = "ORDER BY L2Distance(embedding, {query_embedding:Array(Float32)})"
+            parameters["query_embedding"] = query_embedding
+        if self.distance == Distance.cosine:
+            order_by_query = "ORDER BY cosineDistance(embedding, {query_embedding:Array(Float32)})"
+            parameters["query_embedding"] = query_embedding
+
+        clickhouse_query = (
+            "SELECT name, meta_data, content, content_id, embedding, usage FROM "
+            "{database_name:Identifier}.{table_name:Identifier} "
+            f"{where_query} {order_by_query} LIMIT {limit}"
+        )
+        log_debug(f"Async Query: {clickhouse_query}")
+        log_debug(f"Async Params: {parameters}")
+
+        try:
+            results = await async_client.query(
+                clickhouse_query,
+                parameters=parameters,
+            )
+        except Exception as e:
+            logger.error(f"Async error searching for documents: {e}")
+            logger.error("Table might not exist, creating for future use")
+            await self.async_create()
+            return []
+
+        # Build search results
+        search_results: List[Document] = []
+        for result in results.result_rows:
+            search_results.append(
+                Document(
+                    name=result[0],
+                    meta_data=result[1],
+                    content=result[2],
+                    content_id=result[3],
+                    embedder=self.embedder,
+                    embedding=result[4],
+                    usage=result[5],
+                )
+            )
+
+        return search_results
+
+    def drop(self) -> None:
+        if self.table_exists():
+            log_debug(f"Deleting table: {self.table_name}")
+            parameters = self._get_base_parameters()
+            self.client.command(
+                "DROP TABLE {database_name:Identifier}.{table_name:Identifier}",
+                parameters=parameters,
+            )
+
+    async def async_drop(self) -> None:
+        """Drop the table asynchronously."""
+        if await self.async_exists():
+            log_debug(f"Async dropping table: {self.table_name}")
+            parameters = self._get_base_parameters()
+            await self.async_client.command(  # type: ignore
+                "DROP TABLE {database_name:Identifier}.{table_name:Identifier}",
+                parameters=parameters,
+            )
+
+    def exists(self) -> bool:
+        return self.table_exists()
+
+    async def async_exists(self) -> bool:
+        return await self.async_table_exists()
+
+    def get_count(self) -> int:
+        parameters = self._get_base_parameters()
+        result = self.client.query(
+            "SELECT count(*) FROM {database_name:Identifier}.{table_name:Identifier}",
+            parameters=parameters,
+        )
+
+        if result.first_row:
+            return int(result.first_row[0])
+        return 0
+
+    def optimize(self) -> None:
+        log_debug("==== No need to optimize Clickhouse DB. Skipping this step ====")
+
+    def delete(self) -> bool:
+        parameters = self._get_base_parameters()
+        self.client.command(
+            "DELETE FROM {database_name:Identifier}.{table_name:Identifier}",
+            parameters=parameters,
+        )
+        return True
+
+    def delete_by_id(self, id: str) -> bool:
+        """
+
+        Delete a document by its ID.
+
+        Args:
+            id (str): The document ID to delete
+
+        Returns:
+            bool: True if document was deleted, False otherwise
+        """
+        try:
+            log_debug(f"ClickHouse VectorDB : Deleting document with ID {id}")
+            if not self.id_exists(id):
+                return False
+
+            parameters = self._get_base_parameters()
+            parameters["id"] = id
+
+            self.client.command(
+                "DELETE FROM {database_name:Identifier}.{table_name:Identifier} WHERE id = {id:String}",
+                parameters=parameters,
+            )
+            return True
+        except Exception as e:
+            log_info(f"Error deleting document with ID {id}: {e}")
+            return False
+
+    def delete_by_name(self, name: str) -> bool:
+        """
+        Delete documents by name.
+
+        Args:
+            name (str): The document name to delete
+
+        Returns:
+            bool: True if documents were deleted, False otherwise
+        """
+        try:
+            log_debug(f"ClickHouse VectorDB : Deleting documents with name {name}")
+            if not self.name_exists(name):
+                return False
+
+            parameters = self._get_base_parameters()
+            parameters["name"] = name
+
+            self.client.command(
+                "DELETE FROM {database_name:Identifier}.{table_name:Identifier} WHERE name = {name:String}",
+                parameters=parameters,
+            )
+            return True
+        except Exception as e:
+            log_info(f"Error deleting documents with name {name}: {e}")
+            return False
+
+    def delete_by_metadata(self, metadata: Dict[str, Any]) -> bool:
+        """
+        Delete documents by metadata.
+
+        Args:
+            metadata (Dict[str, Any]): The metadata to match for deletion
+
+        Returns:
+            bool: True if documents were deleted, False otherwise
+        """
+        try:
+            log_debug(f"ClickHouse VectorDB : Deleting documents with metadata {metadata}")
+            parameters = self._get_base_parameters()
+
+            # Build WHERE clause for metadata matching using proper ClickHouse JSON syntax
+            where_conditions = []
+            for key, value in metadata.items():
+                if isinstance(value, bool):
+                    where_conditions.append(f"JSONExtractBool(toString(filters), '{key}') = {str(value).lower()}")
+                elif isinstance(value, (int, float)):
+                    where_conditions.append(f"JSONExtractFloat(toString(filters), '{key}') = {value}")
+                else:
+                    where_conditions.append(f"JSONExtractString(toString(filters), '{key}') = '{value}'")
+
+            if not where_conditions:
+                return False
+
+            where_clause = " AND ".join(where_conditions)
+
+            self.client.command(
+                f"DELETE FROM {{database_name:Identifier}}.{{table_name:Identifier}} WHERE {where_clause}",
+                parameters=parameters,
+            )
+            return True
+        except Exception as e:
+            log_info(f"Error deleting documents with metadata {metadata}: {e}")
+            return False
+
+    def delete_by_content_id(self, content_id: str) -> bool:
+        """
+        Delete documents by content ID.
+
+        Args:
+            content_id (str): The content ID to delete
+
+        Returns:
+            bool: True if documents were deleted, False otherwise
+        """
+        try:
+            log_debug(f"ClickHouse VectorDB : Deleting documents with content_id {content_id}")
+            parameters = self._get_base_parameters()
+            parameters["content_id"] = content_id
+
+            self.client.command(
+                "DELETE FROM {database_name:Identifier}.{table_name:Identifier} WHERE content_id = {content_id:String}",
+                parameters=parameters,
+            )
+            return True
+        except Exception as e:
+            log_info(f"Error deleting documents with content_id {content_id}: {e}")
+            return False
+
+    def content_hash_exists(self, content_hash: str) -> bool:
+        """
+        Validate if a row with this content_hash exists or not
+
+        Args:
+            content_hash (str): Content hash to check
+        """
+        parameters = self._get_base_parameters()
+        parameters["content_hash"] = content_hash
+
+        result = self.client.query(
+            "SELECT content_hash FROM {database_name:Identifier}.{table_name:Identifier} WHERE content_hash = {content_hash:String}",
+            parameters=parameters,
+        )
+        return len(result.result_rows) > 0 if result.result_rows else False
+
+    def _delete_by_content_hash(self, content_hash: str) -> bool:
+        """
+        Delete documents by content hash.
+        """
+        try:
+            parameters = self._get_base_parameters()
+            parameters["content_hash"] = content_hash
+
+            self.client.command(
+                "DELETE FROM {database_name:Identifier}.{table_name:Identifier} WHERE content_hash = {content_hash:String}",
+                parameters=parameters,
+            )
+            return True
+        except Exception:
+            return False
+
+    def update_metadata(self, content_id: str, metadata: Dict[str, Any]) -> None:
+        """
+        Update the metadata for documents with the given content_id.
+
+        Args:
+            content_id (str): The content ID to update
+            metadata (Dict[str, Any]): The metadata to update
+        """
+        import json
+
+        try:
+            parameters = self._get_base_parameters()
+            parameters["content_id"] = content_id
+
+            # First, get existing documents with their current metadata and filters
+            result = self.client.query(
+                "SELECT id, meta_data, filters FROM {database_name:Identifier}.{table_name:Identifier} WHERE content_id = {content_id:String}",
+                parameters=parameters,
+            )
+
+            if not result.result_rows:
+                logger.debug(f"No documents found with content_id: {content_id}")
+                return
+
+            # Update each document
+            updated_count = 0
+            for row in result.result_rows:
+                doc_id, current_meta_json, current_filters_json = row
+
+                # Parse existing metadata
+                try:
+                    current_metadata = json.loads(current_meta_json) if current_meta_json else {}
+                except (json.JSONDecodeError, TypeError):
+                    current_metadata = {}
+
+                # Parse existing filters
+                try:
+                    current_filters = json.loads(current_filters_json) if current_filters_json else {}
+                except (json.JSONDecodeError, TypeError):
+                    current_filters = {}
+
+                # Merge existing metadata with new metadata
+                updated_metadata = current_metadata.copy()
+                updated_metadata.update(metadata)
+
+                # Merge existing filters with new metadata
+                updated_filters = current_filters.copy()
+                updated_filters.update(metadata)
+
+                # Update the document
+                update_params = parameters.copy()
+                update_params["doc_id"] = doc_id
+                update_params["metadata_json"] = json.dumps(updated_metadata)
+                update_params["filters_json"] = json.dumps(updated_filters)
+
+                self.client.command(
+                    "ALTER TABLE {database_name:Identifier}.{table_name:Identifier} UPDATE meta_data = {metadata_json:String}, filters = {filters_json:String} WHERE id = {doc_id:String}",
+                    parameters=update_params,
+                )
+                updated_count += 1
+
+            logger.debug(f"Updated metadata for {updated_count} documents with content_id: {content_id}")
+
+        except Exception as e:
+            logger.error(f"Error updating metadata for content_id '{content_id}': {e}")
+            raise
+
+    def get_supported_search_types(self) -> List[str]:
+        """Get the supported search types for this vector database."""
+        return []  # Clickhouse doesn't use SearchType enum