add some util api for sdk (#22627)

add some util api for sdk

Approved by: @LeftHandCold

Author: XuPeng-SH

clients/python/Makefile

@@ -286,6 +286,20 @@ lint: ## Run code quality checks
 	flake8 matrixone --max-line-length=125 --ignore=E203,W503
 	@echo "$(GREEN)Code quality checks completed!$(NC)"
 
+.PHONY: lint-fix
+lint-fix: ## Auto-fix linting issues (trailing whitespace, imports, formatting)
+	@echo "$(BLUE)Auto-fixing linting issues...$(NC)"
+	@echo "$(YELLOW)Removing trailing whitespace...$(NC)"
+	find matrixone -name "*.py" -type f -exec sed -i '' 's/[[:space:]]*$$//' {} +
+	@echo "$(YELLOW)Removing unused imports with autoflake...$(NC)"
+	$(PYTHON) -m autoflake --remove-all-unused-imports --in-place --recursive matrixone || echo "$(YELLOW)⚠️  autoflake not available, skipping import cleanup$(NC)"
+	@echo "$(YELLOW)Sorting imports with isort...$(NC)"
+	$(PYTHON) -m isort matrixone || echo "$(YELLOW)⚠️  isort not available, skipping import sorting$(NC)"
+	@echo "$(YELLOW)Formatting code with black...$(NC)"
+	black matrixone --line-length=125
+	@echo "$(GREEN)Linting issues auto-fixed!$(NC)"
+	@echo "$(YELLOW)Run 'make lint' to verify fixes$(NC)"
+
 .PHONY: format
 format: ## Format code with black
 	@echo "$(BLUE)Formatting code...$(NC)"

clients/python/README.md

@@ -31,6 +31,10 @@ A comprehensive Python SDK for MatrixOne that provides SQLAlchemy-like interface
   - Table size and row count statistics
   - Column data distribution analysis
   - Index usage metrics
+- 🔍 **Secondary Index Verification**: Verify consistency of secondary indexes with main table
+  - Get all secondary index table names
+  - Get specific index table by index name
+  - Verify row counts across main table and all indexes in single query
 - 📸 **Snapshot Management**: Create and manage database snapshots at multiple levels
 - ⏰ **Point-in-Time Recovery**: PITR functionality for precise data recovery
 - 🔄 **Table Cloning**: Clone databases and tables efficiently with data replication
@@ -323,6 +327,27 @@ print(f"Original size: {table_stats['original_size']} bytes")
 print(f"Compressed size: {table_stats['compress_size']} bytes")
 ```
 
+### Secondary Index Verification
+
+```python
+# Get all secondary index tables
+index_tables = client.get_secondary_index_tables('my_table')
+print(f"Found {len(index_tables)} secondary indexes")
+
+# Get specific index by name
+physical_table = client.get_secondary_index_table_by_name('my_table', 'idx_name')
+print(f"Index 'idx_name' -> {physical_table}")
+
+# Verify all indexes have same count as main table
+try:
+    count = client.verify_table_index_counts('my_table')
+    print(f"✓ Verification passed! Row count: {count}")
+except ValueError as e:
+    print(f"✗ Index mismatch detected:")
+    print(e)
+    # Error includes all count details for debugging
+```
+
 ### Version Management
 
 ```python

clients/python/docs/examples.rst

@@ -930,6 +930,90 @@ Modern ORM-style fulltext search with boolean_match and natural_match:
 
    orm_fulltext_search_example()
 
+Secondary Index Verification Examples
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Verify consistency of secondary indexes with the main table:
+
+.. code-block:: python
+
+   from matrixone import Client
+   from matrixone.config import get_connection_params
+   from matrixone.orm import declarative_base
+   from sqlalchemy import Column, Integer, String, Index
+
+   def index_verification_example():
+       host, port, user, password, database = get_connection_params()
+       client = Client()
+       client.connect(host=host, port=port, user=user, password=password, database=database)
+
+       # Define model with secondary indexes
+       Base = declarative_base()
+
+       class Product(Base):
+           __tablename__ = 'products'
+           
+           id = Column(Integer, primary_key=True)
+           name = Column(String(100))
+           category = Column(String(50))
+           price = Column(Integer)
+           
+           # Define secondary indexes
+           __table_args__ = (
+               Index('idx_name', 'name'),
+               Index('idx_category', 'category'),
+               Index('idx_price', 'price'),
+           )
+
+       # Create table with indexes
+       client.create_table(Product)
+
+       # Insert data
+       products = [
+           {'id': i, 'name': f'Product {i}', 'category': f'Cat {i % 5}', 'price': i * 100}
+           for i in range(1, 1001)
+       ]
+       client.batch_insert(Product, products)
+
+       # 1. Get all secondary index tables
+       index_tables = client.get_secondary_index_tables('products')
+       print(f"Found {len(index_tables)} secondary indexes:")
+       for idx_table in index_tables:
+           print(f"  {idx_table}")
+
+       # 2. Get specific index by name
+       name_index = client.get_secondary_index_table_by_name('products', 'idx_name')
+       category_index = client.get_secondary_index_table_by_name('products', 'idx_category')
+       
+       print(f"\nIndex mappings:")
+       print(f"  idx_name -> {name_index}")
+       print(f"  idx_category -> {category_index}")
+
+       # 3. Verify all indexes have consistent row counts
+       try:
+           count = client.verify_table_index_counts('products')
+           print(f"\n✓ All indexes verified! Row count: {count}")
+       except ValueError as e:
+           print(f"\n✗ Verification failed:")
+           print(e)
+
+       # 4. Use in production monitoring
+       import time
+       for i in range(3):
+           try:
+               count = client.verify_table_index_counts('products')
+               print(f"{time.ctime()}: ✓ Indexes OK ({count} rows)")
+           except ValueError as e:
+               print(f"{time.ctime()}: ✗ INDEX MISMATCH!")
+               print(e)
+           time.sleep(1)
+
+       # Clean up
+       client.drop_table(Product)
+       client.disconnect()
+
+   index_verification_example()
+
 Error Handling Examples
 ~~~~~~~~~~~~~~~~~~~~~~~
 

clients/python/docs/index.rst

@@ -25,6 +25,7 @@ type safety and extensive documentation.
    fulltext_guide
    orm_guide
    metadata_guide
+   index_verification_guide
 
 .. toctree::
    :maxdepth: 2