veadk-python 0.2.7__py3-none-any.whl → 0.2.9__py3-none-any.whl

veadk/database/database_adapter.py

@@ -1,533 +0,0 @@
-# Copyright (c) 2025 Beijing Volcano Engine Technology Co., Ltd. and/or its affiliates.
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#     http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-import re
-import time
-from typing import BinaryIO, TextIO
-
-from veadk.database.base_database import BaseDatabase
-from veadk.utils.logger import get_logger
-
-logger = get_logger(__name__)
-
-
-class KVDatabaseAdapter:
-    def __init__(self, client):
-        from veadk.database.kv.redis_database import RedisDatabase
-
-        self.client: RedisDatabase = client
-
-    def index_exists(self, index: str) -> bool:
-        """
-        Check if the index (key) exists in Redis.
-
-        Args:
-            index: The Redis key to check
-
-        Returns:
-            bool: True if the key exists, False otherwise
-        """
-        try:
-            # Use Redis EXISTS command to check if key exists
-            return bool(self.client._client.exists(index))
-        except Exception as e:
-            logger.error(
-                f"Failed to check if key exists in Redis: index={index} error={e}"
-            )
-            return False
-
-    def add(self, data: list[str], index: str, **kwargs):
-        logger.debug(f"Adding documents to Redis database: index={index}")
-
-        try:
-            for _data in data:
-                self.client.add(key=index, value=_data)
-            logger.debug(f"Added {len(data)} texts to Redis database: index={index}")
-        except Exception as e:
-            logger.error(
-                f"Failed to add data to Redis database: index={index} error={e}"
-            )
-            raise e
-
-    def query(self, query: str, index: str, top_k: int = 0) -> list:
-        logger.debug(f"Querying Redis database: index={index} query={query}")
-
-        # ignore top_k, as KV search only return one result
-        _ = top_k
-
-        try:
-            result = self.client.query(key=index, query=query)
-            return result
-        except Exception as e:
-            logger.error(f"Failed to search from Redis: index={index} error={e}")
-            raise e
-
-    def delete(self, index: str) -> bool:
-        logger.debug(f"Deleting key from Redis database: index={index}")
-        try:
-            self.client.delete(key=index)
-            return True
-        except Exception as e:
-            logger.error(
-                f"Failed to delete key from Redis database: index={index} error={e}"
-            )
-            return False
-
-    def delete_doc(self, index: str, id: str) -> bool:
-        logger.debug(f"Deleting document from Redis database: index={index} id={id}")
-        try:
-            # For Redis, we need to handle deletion differently since RedisDatabase.delete_doc
-            # takes a key and a single id
-            result = self.client.delete_doc(key=index, id=id)
-            return result
-        except Exception as e:
-            logger.error(
-                f"Failed to delete document from Redis database: index={index} id={id} error={e}"
-            )
-            return False
-
-    def list_chunks(self, index: str, offset: int = 0, limit: int = 100) -> list[dict]:
-        logger.debug(f"Listing documents from Redis database: index={index}")
-        try:
-            # Get all documents from Redis
-            docs = self.client.list_docs(key=index)
-
-            # Apply offset and limit for pagination
-            return docs[offset : offset + limit]
-        except Exception as e:
-            logger.error(
-                f"Failed to list documents from Redis database: index={index} error={e}"
-            )
-            return []
-
-
-class RelationalDatabaseAdapter:
-    def __init__(self, client):
-        from veadk.database.relational.mysql_database import MysqlDatabase
-
-        self.client: MysqlDatabase = client
-
-    def index_exists(self, index: str) -> bool:
-        """
-        Check if the table (index) exists in MySQL database.
-
-        Args:
-            index: The table name to check
-
-        Returns:
-            bool: True if the table exists, False otherwise
-        """
-        try:
-            return self.client.table_exists(index)
-        except Exception as e:
-            logger.error(
-                f"Failed to check if table exists in MySQL: index={index} error={e}"
-            )
-            return False
-
-    def create_table(self, table_name: str):
-        logger.debug(f"Creating table for SQL database: table_name={table_name}")
-
-        sql = f"""
-            CREATE TABLE `{table_name}` (
-                `id` BIGINT AUTO_INCREMENT PRIMARY KEY,
-                `data` TEXT NOT NULL,
-                `created_at` TIMESTAMP DEFAULT CURRENT_TIMESTAMP
-            ) ENGINE=InnoDB DEFAULT CHARSET={self.client.config.charset};
-        """
-        self.client.add(sql)
-
-    def add(self, data: list[str], index: str, **kwargs):
-        logger.debug(
-            f"Adding documents to SQL database: table_name={index} data_len={len(data)}"
-        )
-
-        if not self.client.table_exists(index):
-            logger.warning(f"Table {index} does not exist, creating a new table.")
-            self.create_table(index)
-
-        for _data in data:
-            sql = f"""
-                INSERT INTO `{index}` (`data`)
-                VALUES (%s);
-                """
-            self.client.add(sql, params=(_data,))
-        logger.debug(f"Added {len(data)} texts to table {index}.")
-
-    def query(self, query: str, index: str, top_k: int) -> list[str]:
-        logger.debug(
-            f"Querying SQL database: table_name={index} query={query} top_k={top_k}"
-        )
-
-        if not self.client.table_exists(index):
-            logger.warning(
-                f"Querying SQL database, but table `{index}` does not exist, returning empty list."
-            )
-            return []
-
-        sql = f"""
-            SELECT `data` FROM `{index}` ORDER BY `created_at` DESC LIMIT {top_k};
-            """
-        results = self.client.query(sql)
-
-        return [item["data"] for item in results]
-
-    def delete(self, index: str) -> bool:
-        logger.debug(f"Deleting table from SQL database: table_name={index}")
-        try:
-            self.client.delete(table=index)
-            return True
-        except Exception as e:
-            logger.error(
-                f"Failed to delete table from SQL database: table_name={index} error={e}"
-            )
-            return False
-
-    def delete_doc(self, index: str, id: str) -> bool:
-        logger.debug(f"Deleting document from SQL database: table_name={index} id={id}")
-        try:
-            # Convert single id to list for the client method
-            result = self.client.delete_doc(table=index, ids=[int(id)])
-            return result
-        except Exception as e:
-            logger.error(
-                f"Failed to delete document from SQL database: table_name={index} id={id} error={e}"
-            )
-            return False
-
-    def list_docs(self, index: str, offset: int = 0, limit: int = 100) -> list[dict]:
-        logger.debug(f"Listing documents from SQL database: table_name={index}")
-        try:
-            return self.client.list_docs(table=index, offset=offset, limit=limit)
-        except Exception as e:
-            logger.error(
-                f"Failed to list documents from SQL database: table_name={index} error={e}"
-            )
-            return []
-
-
-class VectorDatabaseAdapter:
-    def __init__(self, client):
-        from veadk.database.vector.opensearch_vector_database import (
-            OpenSearchVectorDatabase,
-        )
-
-        self.client: OpenSearchVectorDatabase = client
-
-    def index_exists(self, index: str) -> bool:
-        """
-        Check if the collection (index) exists in OpenSearch.
-
-        Args:
-            index: The collection name to check
-
-        Returns:
-            bool: True if the collection exists, False otherwise
-        """
-        try:
-            self._validate_index(index)
-            return self.client.collection_exists(index)
-        except Exception as e:
-            logger.error(
-                f"Failed to check if collection exists in OpenSearch: index={index} error={e}"
-            )
-            return False
-
-    def _validate_index(self, index: str):
-        """
-        Verify whether the string conforms to the naming rules of index_name in OpenSearch.
-        https://docs.opensearch.org/2.8/api-reference/index-apis/create-index/
-        """
-        if not (
-            isinstance(index, str)
-            and not index.startswith(("_", "-"))
-            and index.islower()
-            and re.match(r"^[a-z0-9_\-.]+$", index)
-        ):
-            raise ValueError(
-                "The index name does not conform to the naming rules of OpenSearch"
-            )
-
-    def add(self, data: list[str], index: str, **kwargs):
-        self._validate_index(index)
-
-        logger.debug(
-            f"Adding documents to vector database: index={index} data_len={len(data)}"
-        )
-
-        self.client.add(data, collection_name=index)
-
-    def query(self, query: str, index: str, top_k: int) -> list[str]:
-        logger.debug(
-            f"Querying vector database: collection_name={index} query={query} top_k={top_k}"
-        )
-
-        return self.client.query(
-            query=query,
-            collection_name=index,
-            top_k=top_k,
-        )
-
-    def delete(self, index: str) -> bool:
-        self._validate_index(index)
-        logger.debug(f"Deleting collection from vector database: index={index}")
-        try:
-            self.client.delete(collection_name=index)
-            return True
-        except Exception as e:
-            logger.error(
-                f"Failed to delete collection from vector database: index={index} error={e}"
-            )
-            return False
-
-    def delete_doc(self, index: str, id: str) -> bool:
-        self._validate_index(index)
-        logger.debug(f"Deleting documents from vector database: index={index} id={id}")
-        try:
-            self.client.delete_by_id(collection_name=index, id=id)
-            return True
-        except Exception as e:
-            logger.error(
-                f"Failed to delete document from vector database: index={index} id={id} error={e}"
-            )
-            return False
-
-    def list_chunks(self, index: str, offset: int = 0, limit: int = 1000) -> list[dict]:
-        self._validate_index(index)
-        logger.debug(f"Listing documents from vector database: index={index}")
-        return self.client.list_docs(collection_name=index, offset=offset, limit=limit)
-
-
-class VikingDatabaseAdapter:
-    def __init__(self, client):
-        from veadk.database.viking.viking_database import VikingDatabase
-
-        self.client: VikingDatabase = client
-
-    def index_exists(self, index: str) -> bool:
-        """
-        Check if the collection (index) exists in VikingDB.
-
-        Args:
-            index: The collection name to check
-
-        Returns:
-            bool: True if the collection exists, False otherwise
-        """
-        try:
-            self._validate_index(index)
-            return self.client.collection_exists(index)
-        except Exception as e:
-            logger.error(
-                f"Failed to check if collection exists in VikingDB: index={index} error={e}"
-            )
-            return False
-
-    def _validate_index(self, index: str):
-        """
-        Only English letters, numbers, and underscores (_) are allowed.
-        It must start with an English letter and cannot be empty. Length requirement: [1, 128].
-        For details, please see: https://www.volcengine.com/docs/84313/1254542?lang=zh
-        """
-        if not (
-            isinstance(index, str)
-            and 0 < len(index) <= 128
-            and re.fullmatch(r"^[a-zA-Z][a-zA-Z0-9_]*$", index)
-        ):
-            raise ValueError(
-                "The index name does not conform to the rules: it must start with an English letter, contain only letters, numbers, and underscores, and have a length of 1-128."
-            )
-
-    def get_or_create_collection(self, collection_name: str):
-        if not self.client.collection_exists(collection_name):
-            logger.warning(
-                f"Collection {collection_name} does not exist, creating a new collection."
-            )
-            self.client.create_collection(collection_name)
-
-        # After creation, it is necessary to wait for a while.
-        count = 0
-        while not self.client.collection_exists(collection_name):
-            print("here")
-            time.sleep(1)
-            count += 1
-            if count > 60:
-                raise TimeoutError(
-                    f"Collection {collection_name} not created after 50 seconds"
-                )
-
-    def add(
-        self, data: str | list[str] | TextIO | BinaryIO | bytes, index: str, **kwargs
-    ):
-        self._validate_index(index)
-
-        logger.debug(f"Adding documents to Viking database: collection_name={index}")
-
-        self.get_or_create_collection(index)
-        self.client.add(data, collection_name=index, **kwargs)
-
-    def query(self, query: str, index: str, top_k: int) -> list[str]:
-        self._validate_index(index)
-
-        logger.debug(f"Querying Viking database: collection_name={index} query={query}")
-
-        if not self.client.collection_exists(index):
-            return []
-
-        return self.client.query(query, collection_name=index, top_k=top_k)
-
-    def delete(self, index: str) -> bool:
-        self._validate_index(index)
-        logger.debug(f"Deleting collection from Viking database: index={index}")
-        return self.client.delete(name=index)
-
-    def delete_doc(self, index: str, id: str) -> bool:
-        self._validate_index(index)
-        logger.debug(f"Deleting documents from vector database: index={index} id={id}")
-        return self.client.delete_by_id(collection_name=index, id=id)
-
-    def list_chunks(self, index: str, offset: int, limit: int) -> list[dict]:
-        self._validate_index(index)
-        logger.debug(f"Listing documents from vector database: index={index}")
-        return self.client.list_chunks(
-            collection_name=index, offset=offset, limit=limit
-        )
-
-    def list_docs(self, index: str, offset: int, limit: int) -> list[dict]:
-        self._validate_index(index)
-        logger.debug(f"Listing documents from vector database: index={index}")
-        return self.client.list_docs(collection_name=index, offset=offset, limit=limit)
-
-
-class VikingMemoryDatabaseAdapter:
-    def __init__(self, client):
-        from veadk.database.viking.viking_memory_db import VikingMemoryDatabase
-
-        self.client: VikingMemoryDatabase = client
-
-    def index_exists(self, index: str) -> bool:
-        """
-        Check if the collection (index) exists in VikingMemoryDB.
-
-        Note:
-            VikingMemoryDatabase does not support checking if a collection exists.
-            This method always returns False.
-
-        Args:
-            index: The collection name to check
-
-        Returns:
-            bool: Always returns False as VikingMemoryDatabase does not support this functionality
-        """
-        logger.warning(
-            "VikingMemoryDatabase does not support checking if a collection exists"
-        )
-        raise NotImplementedError("VikingMemoryDatabase does not support index_exists")
-
-    def _validate_index(self, index: str):
-        if not (
-            isinstance(index, str)
-            and 1 <= len(index) <= 128
-            and re.fullmatch(r"^[a-zA-Z][a-zA-Z0-9_]*$", index)
-        ):
-            raise ValueError(
-                "The index name does not conform to the rules: it must start with an English letter, contain only letters, numbers, and underscores, and have a length of 1-128."
-            )
-
-    def add(self, data: list[str], index: str, **kwargs):
-        self._validate_index(index)
-
-        logger.debug(
-            f"Adding documents to Viking database memory: collection_name={index} data_len={len(data)}"
-        )
-
-        self.client.add(data, collection_name=index, **kwargs)
-
-    def query(self, query: str, index: str, top_k: int, **kwargs):
-        self._validate_index(index)
-
-        logger.debug(
-            f"Querying Viking database memory: collection_name={index} query={query} top_k={top_k}"
-        )
-
-        result = self.client.query(query, collection_name=index, top_k=top_k, **kwargs)
-        return result
-
-    def delete(self, index: str) -> bool:
-        self._validate_index(index)
-        logger.debug(f"Deleting collection from Viking database memory: index={index}")
-        raise NotImplementedError("VikingMemoryDatabase does not support delete")
-
-    def delete_docs(self, index: str, ids: list[int]):
-        raise NotImplementedError("VikingMemoryDatabase does not support delete_docs")
-
-    def list_chunks(self, index: str):
-        raise NotImplementedError("VikingMemoryDatabase does not support list_docs")
-
-
-class LocalDatabaseAdapter:
-    def __init__(self, client):
-        from veadk.database.local_database import LocalDataBase
-
-        self.client: LocalDataBase = client
-
-    def index_exists(self, index: str) -> bool:
-        """
-        Check if the index exists in LocalDataBase.
-
-        Note:
-            LocalDataBase does not support checking if an index exists.
-            This method always returns False.
-
-        Args:
-            index: The index name to check (not used in LocalDataBase)
-
-        Returns:
-            bool: Always returns False as LocalDataBase does not support this functionality
-        """
-        logger.warning("LocalDataBase does not support checking if an index exists")
-        return True
-
-    def add(self, data: list[str], **kwargs):
-        self.client.add(data)
-
-    def query(self, query: str, **kwargs):
-        return self.client.query(query, **kwargs)
-
-    def delete(self, index: str) -> bool:
-        return self.client.delete()
-
-    def delete_doc(self, index: str, id: str) -> bool:
-        return self.client.delete_doc(id)
-
-    def list_chunks(self, index: str, offset: int = 0, limit: int = 100) -> list[dict]:
-        return self.client.list_docs(offset=offset, limit=limit)
-
-
-MAPPING = {
-    "RedisDatabase": KVDatabaseAdapter,
-    "MysqlDatabase": RelationalDatabaseAdapter,
-    "LocalDataBase": LocalDatabaseAdapter,
-    "VikingDatabase": VikingDatabaseAdapter,
-    "OpenSearchVectorDatabase": VectorDatabaseAdapter,
-    "VikingMemoryDatabase": VikingMemoryDatabaseAdapter,
-}
-
-
-def get_knowledgebase_database_adapter(database_client: BaseDatabase):
-    return MAPPING[type(database_client).__name__](client=database_client)
-
-
-def get_long_term_memory_database_adapter(database_client: BaseDatabase):
-    return MAPPING[type(database_client).__name__](client=database_client)

veadk/database/database_factory.py

@@ -1,80 +0,0 @@
-# Copyright (c) 2025 Beijing Volcano Engine Technology Co., Ltd. and/or its affiliates.
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#     http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-from veadk.utils.logger import get_logger
-
-from .base_database import BaseDatabase
-
-logger = get_logger(__name__)
-
-
-class DatabaseBackend:
-    OPENSEARCH = "opensearch"
-    LOCAL = "local"
-    MYSQL = "mysql"
-    REDIS = "redis"
-    VIKING = "viking"
-    VIKING_MEM = "viking_mem"
-
-    @classmethod
-    def get_attr(cls) -> set[str]:
-        return {
-            value
-            for attr, value in cls.__dict__.items()
-            if not attr.startswith("__") and attr != "get_attr"
-        }
-
-
-class DatabaseFactory:
-    @staticmethod
-    def create(backend: str, config=None) -> BaseDatabase:
-        if backend not in DatabaseBackend.get_attr():
-            logger.warning(f"Unknown backend: {backend}), change backend to `local`")
-            backend = "local"
-
-        if backend == DatabaseBackend.LOCAL:
-            from .local_database import LocalDataBase
-
-            return LocalDataBase()
-        if backend == DatabaseBackend.OPENSEARCH:
-            from .vector.opensearch_vector_database import OpenSearchVectorDatabase
-
-            return (
-                OpenSearchVectorDatabase()
-                if config is None
-                else OpenSearchVectorDatabase(config=config)
-            )
-        if backend == DatabaseBackend.MYSQL:
-            from .relational.mysql_database import MysqlDatabase
-
-            return MysqlDatabase() if config is None else MysqlDatabase(config=config)
-        if backend == DatabaseBackend.REDIS:
-            from .kv.redis_database import RedisDatabase
-
-            return RedisDatabase() if config is None else RedisDatabase(config=config)
-        if backend == DatabaseBackend.VIKING:
-            from .viking.viking_database import VikingDatabase
-
-            return VikingDatabase() if config is None else VikingDatabase(config=config)
-
-        if backend == DatabaseBackend.VIKING_MEM:
-            from .viking.viking_memory_db import VikingMemoryDatabase
-
-            return (
-                VikingMemoryDatabase()
-                if config is None
-                else VikingMemoryDatabase(config=config)
-            )
-        else:
-            raise ValueError(f"Unsupported database type: {backend}")