pyobvector 0.2.12__tar.gz → 0.2.13__tar.gz

{pyobvector-0.2.12 → pyobvector-0.2.13}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: pyobvector
-Version: 0.2.12
+Version: 0.2.13
 Summary: A python SDK for OceanBase Vector Store, based on SQLAlchemy, compatible with Milvus API.
 Author: shanhaikang.shk
 Author-email: shanhaikang.shk@oceanbase.com
@@ -36,7 +36,7 @@ poetry install
 - install with pip:
 
 ```shell
-pip install pyobvector==0.2.12
+pip install pyobvector==0.2.13
 ```
 
 ## Build Doc

{pyobvector-0.2.12 → pyobvector-0.2.13}/README.md

@@ -15,7 +15,7 @@ poetry install
 - install with pip:
 
 ```shell
-pip install pyobvector==0.2.12
+pip install pyobvector==0.2.13
 ```
 
 ## Build Doc

{pyobvector-0.2.12 → pyobvector-0.2.13}/pyobvector/client/ob_vec_client.py

@@ -89,6 +89,13 @@ class ObVecClient:
                         message=ExceptionsMessage.ClusterVersionIsLow,
                     )
 
+    def refresh_metadata(self, tables: Optional[list[str]] = None):
+        """Reload metadata from the database."""
+        if tables is None:
+            self.metadata_obj.reflect(bind=self.engine, extend_existing=True)
+        else:
+            self.metadata_obj.reflect(bind=self.engine, only=tables, extend_existing=True)
+
     def _insert_partition_hint_for_query_sql(self, sql: str, partition_hint: str):
         from_index = sql.find("FROM")
         assert from_index != -1

{pyobvector-0.2.12 → pyobvector-0.2.13}/pyobvector/schema/array.py

@@ -10,7 +10,6 @@ class ARRAY(UserDefinedType):
     """ARRAY data type definition with support for up to 6 levels of nesting."""
     cache_ok = True
     _string = String()
-    _max_nesting_level = 6
 
     def __init__(self, item_type: Union[TypeEngine, type]):
         """Construct an ARRAY.
@@ -18,25 +17,17 @@ class ARRAY(UserDefinedType):
         Args:
             item_type: The data type of items in this array. For nested arrays,
                       pass another ARRAY type.
-
-        Raises:
-            ValueError: If nesting level exceeds the maximum allowed level (6).
         """
         super(UserDefinedType, self).__init__()
         if isinstance(item_type, type):
             item_type = item_type()
         self.item_type = item_type
-        self._validate_nesting_level()
-
-    def _validate_nesting_level(self):
-        """Validate that the nesting level does not exceed the maximum allowed level."""
-        level = 1
-        current_type = self.item_type
-        while isinstance(current_type, ARRAY):
-            level += 1
-            if level > self._max_nesting_level:
-                raise ValueError(f"Maximum nesting level of {self._max_nesting_level} exceeded")
-            current_type = current_type.item_type
+        if isinstance(item_type, ARRAY):
+            self.dim = item_type.dim + 1
+        else:
+            self.dim = 1
+        if self.dim > 6:
+            raise ValueError("Maximum nesting level of 6 exceeded")
 
     def get_col_spec(self, **kw):  # pylint: disable=unused-argument
         """Parse to array data type definition in text SQL."""
@@ -46,12 +37,33 @@ class ARRAY(UserDefinedType):
             base_type = str(self.item_type)
         return f"ARRAY({base_type})"
 
+    def _get_list_depth(self, value: Any) -> int:
+        if not isinstance(value, list):
+            return 0
+        max_depth = 0
+        for element in value:
+            current_depth = self._get_list_depth(element)
+            if current_depth > max_depth:
+                max_depth = current_depth
+        return 1 + max_depth
+
+    def _validate_dimension(self, value: list[Any]):
+        arr_depth = self._get_list_depth(value)
+        assert arr_depth == self.dim, "Array dimension mismatch, expected {}, got {}".format(self.dim, arr_depth)
+
     def bind_processor(self, dialect):
-        item_proc = self.item_type.dialect_impl(dialect).bind_processor(dialect)
+        item_type = self.item_type
+        while isinstance(item_type, ARRAY):
+            item_type = item_type.item_type
 
-        def process(value: Optional[Sequence[Any]]) -> Optional[str]:
+        item_proc = item_type.dialect_impl(dialect).bind_processor(dialect)
+
+        def process(value: Optional[Sequence[Any] | str]) -> Optional[str]:
             if value is None:
                 return None
+            if isinstance(value, str):
+                self._validate_dimension(json.loads(value))
+                return value
 
             def convert(val):
                 if isinstance(val, (list, tuple)):
@@ -61,12 +73,17 @@ class ARRAY(UserDefinedType):
                 return val
 
             processed = convert(value)
+            self._validate_dimension(processed)
             return json.dumps(processed)
 
         return process
 
     def result_processor(self, dialect, coltype):
-        item_proc = self.item_type.dialect_impl(dialect).result_processor(dialect, coltype)
+        item_type = self.item_type
+        while isinstance(item_type, ARRAY):
+            item_type = item_type.item_type
+
+        item_proc = item_type.dialect_impl(dialect).result_processor(dialect, coltype)
 
         def process(value: Optional[str]) -> Optional[List[Any]]:
             if value is None:
@@ -85,7 +102,11 @@ class ARRAY(UserDefinedType):
         return process
 
     def literal_processor(self, dialect):
-        item_proc = self.item_type.dialect_impl(dialect).literal_processor(dialect)
+        item_type = self.item_type
+        while isinstance(item_type, ARRAY):
+            item_type = item_type.item_type
+
+        item_proc = item_type.dialect_impl(dialect).literal_processor(dialect)
 
         def process(value: Sequence[Any]) -> str:
             def convert(val):
@@ -100,21 +121,6 @@ class ARRAY(UserDefinedType):
 
         return process
 
-    def __repr__(self):
-        """Return a string representation of the array type."""
-        current_type = self.item_type
-        nesting_level = 1
-        base_type = current_type
-
-        # Find the innermost type and count nesting level
-        while isinstance(current_type, ARRAY):
-            nesting_level += 1
-            current_type = current_type.item_type
-            if not isinstance(current_type, ARRAY):
-                base_type = current_type
-
-        return f"{nesting_level}D_Array({base_type})"
-
 
 def nested_array(dim: int) -> Type[ARRAY]:
     """Create a nested array type class with specified dimensions.
@@ -131,12 +137,22 @@ def nested_array(dim: int) -> Type[ARRAY]:
     if not 1 <= dim <= 6:
         raise ValueError("Dimension must be between 1 and 6")
 
-    class ArrayType(ARRAY):
+    class NestedArray(ARRAY):
+        cache_ok = True
+        _string = String()
+
         def __init__(self, item_type: Union[TypeEngine, type]):
+            super(UserDefinedType, self).__init__()
+            if isinstance(item_type, type):
+                item_type = item_type()
+
+            assert not isinstance(item_type, ARRAY), "The item_type of NestedArray should not be an ARRAY type"
+
             nested_type = item_type
-            for _ in range(dim - 1):
+            for _ in range(dim):
                 nested_type = ARRAY(nested_type)
-            super().__init__(nested_type)
 
-    ArrayType.__name__ = f"{dim}D_Array"
-    return ArrayType
+            self.item_type = nested_type.item_type
+            self.dim = dim
+
+    return NestedArray

{pyobvector-0.2.12 → pyobvector-0.2.13}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "pyobvector"
-version = "0.2.12"
+version = "0.2.13"
 description = "A python SDK for OceanBase Vector Store, based on SQLAlchemy, compatible with Milvus API."
 authors = ["shanhaikang.shk <shanhaikang.shk@oceanbase.com>"]
 readme = "README.md"