[#9548] improvement(python-client): Add TableUpdateRequest and TableUpdatesRequest (#9870)

### What changes were proposed in this pull request?

Add `TableUpdateRequest` and `TableUpdatesRequest`

### Why are the changes needed?

Fix: #9548

### Does this PR introduce _any_ user-facing change?

no

### How was this patch tested?

local unittest

Author: Abyss-lord

clients/client-python/gravitino/api/rel/table_change.py

@@ -35,16 +35,14 @@ class TableChange(ABC):
     """
 
     @staticmethod
-    def rename(new_name: str) -> "RenameTable":
+    def rename(new_name: str, new_schema_name: Optional[str] = None) -> "RenameTable":
         """Create a `TableChange` for renaming a table.
 
         Args:
             new_name: The new table name.
-
-        Returns:
-            RenameTable: A `TableChange` for the rename.
+            new_schema_name: The new schema name if cross-schema rename is requested.
         """
-        return TableChange.RenameTable(new_name)
+        return TableChange.RenameTable(new_name, new_schema_name)
 
     @staticmethod
     def update_comment(new_comment: str) -> "UpdateComment":
@@ -315,6 +313,9 @@ class RenameTable:
         """A `TableChange` to rename a table."""
 
         _new_name: str = field(metadata=config(field_name="new_name"))
+        _new_schema_name: Optional[str] = field(
+            default=None, metadata=config(field_name="new_schema_name")
+        )
 
         def get_new_name(self) -> str:
             """Retrieves the new name for the table.
@@ -324,17 +325,26 @@ def get_new_name(self) -> str:
             """
             return self._new_name
 
+        def get_new_schema_name(self) -> Optional[str]:
+            """Retrieves the new schema name for the table."""
+            return self._new_schema_name
+
         def __str__(self):
-            return f"RENAMETABLE {self._new_name}"
+            if self._new_schema_name is None:
+                return f"RENAMETABLE {self._new_name}"
+            return f"RENAMETABLE {self._new_schema_name}.{self._new_name}"
 
         def __eq__(self, value: object) -> bool:
             if not isinstance(value, TableChange.RenameTable):
                 return False
             other = cast(TableChange.RenameTable, value)
-            return self._new_name == other.get_new_name()
+            return (
+                self._new_name == other.get_new_name()
+                and self._new_schema_name == other.get_new_schema_name()
+            )
 
         def __hash__(self) -> int:
-            return hash(self._new_name)
+            return hash((self._new_name, self._new_schema_name))
 
     @final
     @dataclass(frozen=True)

clients/client-python/gravitino/dto/rel/indexes/index_dto.py

@@ -15,6 +15,8 @@
 # specific language governing permissions and limitations
 # under the License.
 
+from __future__ import annotations
+
 from functools import reduce
 from typing import ClassVar, List, Optional, Dict
 

clients/client-python/gravitino/dto/rel/json_serdes/__init__.py

@@ -14,3 +14,13 @@
 # KIND, either express or implied.  See the License for the
 # specific language governing permissions and limitations
 # under the License.
+
+from gravitino.dto.rel.json_serdes.column_position_serdes import ColumnPositionSerdes
+from gravitino.dto.rel.json_serdes.distribution_serdes import DistributionSerDes
+from gravitino.dto.rel.json_serdes.sort_order_serdes import SortOrderSerdes
+
+__all__ = [
+    "ColumnPositionSerdes",
+    "DistributionSerDes",
+    "SortOrderSerdes",
+]

clients/client-python/gravitino/dto/rel/json_serdes/column_position_serdes.py

@@ -0,0 +1,61 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you 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 typing import Union
+
+from dataclasses_json.core import Json
+
+from gravitino.api.rel.table_change import After, Default, First, TableChange
+from gravitino.api.rel.types.json_serdes.base import JsonSerializable
+
+
+class ColumnPositionSerdes(JsonSerializable[TableChange.ColumnPosition]):
+    """JSON serializer/deserializer for table column positions."""
+
+    _POSITION_FIRST = "first"
+    _POSITION_AFTER = "after"
+    _POSITION_DEFAULT = "default"
+
+    @classmethod
+    def serialize(
+        cls,
+        value: TableChange.ColumnPosition,
+    ) -> Union[str, dict[str, str]]:
+        if isinstance(value, First):
+            return cls._POSITION_FIRST
+        if isinstance(value, After):
+            return {cls._POSITION_AFTER: value.get_column()}
+        if isinstance(value, Default):
+            return cls._POSITION_DEFAULT
+
+        raise ValueError(f"Unknown column position: {value}")
+
+    @classmethod
+    def deserialize(cls, data: Json) -> Union[First, After, Default]:
+        if isinstance(data, str):
+            data = data.lower()
+            if data == cls._POSITION_FIRST:
+                return TableChange.ColumnPosition.first()
+            if data == cls._POSITION_DEFAULT:
+                return TableChange.ColumnPosition.default_pos()
+
+        if isinstance(data, dict):
+            after_column = data.get(cls._POSITION_AFTER)
+            if after_column:
+                return TableChange.ColumnPosition.after(after_column)
+
+        raise ValueError(f"Unknown json column position: {data}")