matrixone-python-sdk 0.1.0__tar.gz → 0.1.1__tar.gz

{matrixone_python_sdk-0.1.0/matrixone_python_sdk.egg-info → matrixone_python_sdk-0.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: matrixone-python-sdk
-Version: 0.1.0
+Version: 0.1.1
 Summary: A comprehensive Python SDK for MatrixOne database operations with vector search, fulltext search, and advanced features
 Home-page: https://github.com/matrixorigin/matrixone
 Author: MatrixOne Team
@@ -185,6 +185,22 @@ print(f"MatrixOne version: {version}")
 client.disconnect()
 ```
 
+> **📝 Connection Parameters**
+> 
+> The `connect()` method requires **keyword arguments** (not positional):
+> - `database` - **Required**, no default value
+> - `host` - Default: `'localhost'`
+> - `port` - Default: `6001`
+> - `user` - Default: `'root'`
+> - `password` - Default: `'111'`
+> 
+> **Minimal connection** (uses all defaults):
+> ```python
+> client.connect(database='test')
+> ```
+> 
+> By default, all features (IVF, HNSW, fulltext) are automatically enabled via `on_connect=[ConnectionAction.ENABLE_ALL]`.
+
 ### Async Usage
 
 ```python

{matrixone_python_sdk-0.1.0 → matrixone_python_sdk-0.1.1}/README.md

@@ -143,6 +143,22 @@ print(f"MatrixOne version: {version}")
 client.disconnect()
 ```
 
+> **📝 Connection Parameters**
+> 
+> The `connect()` method requires **keyword arguments** (not positional):
+> - `database` - **Required**, no default value
+> - `host` - Default: `'localhost'`
+> - `port` - Default: `6001`
+> - `user` - Default: `'root'`
+> - `password` - Default: `'111'`
+> 
+> **Minimal connection** (uses all defaults):
+> ```python
+> client.connect(database='test')
+> ```
+> 
+> By default, all features (IVF, HNSW, fulltext) are automatically enabled via `on_connect=[ConnectionAction.ENABLE_ALL]`.
+
 ### Async Usage
 
 ```python

{matrixone_python_sdk-0.1.0 → matrixone_python_sdk-0.1.1}/README_USER.md

@@ -120,6 +120,22 @@ print(f"MatrixOne version: {version}")
 client.disconnect()
 ```
 
+> **📝 Connection Parameters**
+> 
+> The `connect()` method requires **keyword arguments** (not positional):
+> - `database` - **Required**, no default value
+> - `host` - Default: `'localhost'`
+> - `port` - Default: `6001`
+> - `user` - Default: `'root'`
+> - `password` - Default: `'111'`
+> 
+> **Minimal connection** (uses all defaults):
+> ```python
+> client.connect(database='test')
+> ```
+> 
+> By default, all features (IVF, HNSW, fulltext) are automatically enabled via `on_connect=[ConnectionAction.ENABLE_ALL]`.
+
 ### Async Usage
 
 ```python

{matrixone_python_sdk-0.1.0 → matrixone_python_sdk-0.1.1}/examples/example_01_basic_connection.py

@@ -66,7 +66,7 @@ class BasicConnectionDemo:
             # Test 1: Simple connection
             self.logger.info("Test 1: Simple Connection")
             client = Client(logger=self.logger, sql_log_mode="full")
-            client.connect(host, port, user, password, database)
+            client.connect(host=host, port=port, user=user, password=password, database=database)
             self.logger.info("✅ Basic connection successful")
 
             # Test basic query
@@ -99,7 +99,7 @@ class BasicConnectionDemo:
             # Format 1: Legacy format (simple username)
             self.logger.info("Format 1: Legacy format (simple username)")
             client = Client(logger=self.logger, sql_log_mode="auto")
-            client.connect(host, port, user, password, database)
+            client.connect(host=host, port=port, user=user, password=password, database=database)
             login_info = client.get_login_info()
             self.logger.info(f"   ✅ Login info: {login_info}")
             client.disconnect()
@@ -107,7 +107,7 @@ class BasicConnectionDemo:
             # Format 2: Direct format (account#user)
             self.logger.info("Format 2: Direct format (account#user)")
             client = Client(logger=self.logger, sql_log_mode="auto")
-            client.connect(host, port, 'sys#root', password, database)
+            client.connect(host=host, port=port, user='sys#root', password=password, database=database)
             login_info = client.get_login_info()
             self.logger.info(f"   ✅ Login info: {login_info}")
             client.disconnect()
@@ -116,7 +116,7 @@ class BasicConnectionDemo:
             self.logger.info("Format 3: User with role (separate parameters)")
             try:
                 client = Client(logger=self.logger, sql_log_mode="auto")
-                client.connect(host, port, user, password, database, role='admin')
+                client.connect(host=host, port=port, user=user, password=password, database=database, role='admin')
                 # Try to execute a query to trigger role validation
                 client.execute("SELECT 1")
                 login_info = client.get_login_info()
@@ -128,7 +128,7 @@ class BasicConnectionDemo:
             # Format 4: Account with separate parameters
             self.logger.info("Format 4: Account with separate parameters")
             client = Client(logger=self.logger, sql_log_mode="auto")
-            client.connect(host, port, user, password, database, account='sys')
+            client.connect(host=host, port=port, user=user, password=password, database=database, account='sys')
             login_info = client.get_login_info()
             self.logger.info(f"   ✅ Login info: {login_info}")
             client.disconnect()
@@ -154,7 +154,7 @@ class BasicConnectionDemo:
             self.logger.info("Test invalid credentials")
             try:
                 client = Client(logger=self.logger, sql_log_mode="auto")
-                client.connect(host, port, 'invalid_user', 'invalid_pass', database)
+                client.connect(host=host, port=port, user='invalid_user', password='invalid_pass', database=database)
                 # Try to execute a query to trigger authentication
                 client.execute("SELECT 1")
                 self.logger.error("   ❌ Should have failed but didn't!")
@@ -165,7 +165,7 @@ class BasicConnectionDemo:
             self.logger.info("Test invalid host")
             try:
                 client = Client(logger=self.logger, sql_log_mode="auto")
-                client.connect('192.168.1.999', port, user, password, database)
+                client.connect(host='192.168.1.999', port=port, user=user, password=password, database=database)
                 # Try to execute a query to trigger connection validation
                 client.execute("SELECT 1")
                 self.logger.error("   ❌ Should have failed but didn't!")
@@ -176,7 +176,7 @@ class BasicConnectionDemo:
             self.logger.info("Test invalid port")
             try:
                 client = Client(logger=self.logger, sql_log_mode="auto")
-                client.connect(host, 9999, user, password, database)
+                client.connect(host=host, port=9999, user=user, password=password, database=database)
                 # Try to execute a query to trigger connection validation
                 client.execute("SELECT 1")
                 self.logger.error("   ❌ Should have failed but didn't!")
@@ -234,7 +234,7 @@ def demo_connection_info():
 
     try:
         client = Client(logger=logger, sql_log_mode="auto")
-        client.connect(host, port, user, password, database)
+        client.connect(host=host, port=port, user=user, password=password, database=database)
 
         # Get login info
         login_info = client.get_login_info()
@@ -266,7 +266,7 @@ async def demo_async_connection():
     client = None
     try:
         client = AsyncClient(logger=logger)
-        await client.connect(host, port, user, password, database)
+        await client.connect(host=host, port=port, user=user, password=password, database=database)
         logger.info("✅ Async connection successful")
 
         # Test async query
@@ -300,7 +300,7 @@ def demo_connection_pooling():
         # Create multiple connections
         for i in range(3):
             client = Client(logger=logger, sql_log_mode="auto")
-            client.connect(host, port, user, password, database)
+            client.connect(host=host, port=port, user=user, password=password, database=database)
             clients.append(client)
             logger.info(f"   ✅ Created connection {i+1}")
 

{matrixone_python_sdk-0.1.0 → matrixone_python_sdk-0.1.1}/examples/example_02_account_management.py

@@ -67,7 +67,7 @@ class AccountManagementDemo:
 
             # Connect as root for account management
             root_client = Client(logger=self.logger, sql_log_mode="full")
-            root_client.connect(host, port, user, password, database)
+            root_client.connect(host=host, port=port, user=user, password=password, database=database)
             account_manager = AccountManager(root_client)
 
             # Clean up any existing demo accounts
@@ -112,7 +112,9 @@ class AccountManagementDemo:
             try:
                 # Connect as demo account admin
                 demo_admin_client = Client(sql_log_mode="full")
-                demo_admin_client.connect(host, port, 'demo_account#demo_admin', 'adminpass123', 'mo_catalog')
+                demo_admin_client.connect(
+                    host=host, port=port, user='demo_account#demo_admin', password='adminpass123', database='mo_catalog'
+                )
                 demo_account_manager = AccountManager(demo_admin_client)
 
                 # Create users
@@ -145,7 +147,9 @@ class AccountManagementDemo:
             try:
                 # Connect as demo account admin
                 demo_admin_client = Client(sql_log_mode="full")
-                demo_admin_client.connect(host, port, 'demo_account#demo_admin', 'adminpass123', 'mo_catalog')
+                demo_admin_client.connect(
+                    host=host, port=port, user='demo_account#demo_admin', password='adminpass123', database='mo_catalog'
+                )
                 demo_account_manager = AccountManager(demo_admin_client)
 
                 # Create roles
@@ -219,7 +223,7 @@ class AccountManagementDemo:
 
             # Connect as root
             root_client = AsyncClient(sql_log_mode="full")
-            await root_client.connect(host, port, user, password, database)
+            await root_client.connect(host=host, port=port, user=user, password=password, database=database)
             self.logger.info("✅ Async connection successful")
 
             # Test basic async operations

{matrixone_python_sdk-0.1.0 → matrixone_python_sdk-0.1.1}/examples/example_03_async_operations.py

@@ -67,7 +67,7 @@ class AsyncOperationsDemo:
             self.logger.info("Test 1: Basic Async Connection")
             try:
                 client = AsyncClient(logger=self.logger, sql_log_mode="full")
-                await client.connect(host, port, user, password, database)
+                await client.connect(host=host, port=port, user=user, password=password, database=database)
                 self.logger.info("✅ Async connection successful")
 
                 # Test basic async query
@@ -107,7 +107,7 @@ class AsyncOperationsDemo:
             self.logger.info("Test: Async Query Execution")
             try:
                 client = AsyncClient(logger=self.logger, sql_log_mode="full")
-                await client.connect(host, port, user, password, database)
+                await client.connect(host=host, port=port, user=user, password=password, database=database)
 
                 # Test various query types
                 queries = [
@@ -149,7 +149,7 @@ class AsyncOperationsDemo:
             self.logger.info("Test: Async Transaction Management")
             try:
                 client = AsyncClient(logger=self.logger, sql_log_mode="full")
-                await client.connect(host, port, user, password, database)
+                await client.connect(host=host, port=port, user=user, password=password, database=database)
 
                 # Test transaction operations
                 await client.execute("START TRANSACTION")
@@ -193,7 +193,7 @@ class AsyncOperationsDemo:
                 clients = []
                 for i in range(3):
                     client = AsyncClient(logger=self.logger, sql_log_mode="full")
-                    await client.connect(host, port, user, password, database)
+                    await client.connect(host=host, port=port, user=user, password=password, database=database)
                     clients.append(client)
                     self.logger.info(f"   ✅ Created async connection {i+1}")
 
@@ -239,7 +239,7 @@ class AsyncOperationsDemo:
             self.logger.info("Test: Async Error Handling")
             try:
                 client = AsyncClient(logger=self.logger, sql_log_mode="full")
-                await client.connect(host, port, user, password, database)
+                await client.connect(host=host, port=port, user=user, password=password, database=database)
 
                 # Test invalid query (should raise error)
                 try:

{matrixone_python_sdk-0.1.0 → matrixone_python_sdk-0.1.1}/examples/example_04_transaction_management.py

@@ -59,7 +59,7 @@ class TransactionManagementDemo:
             host, port, user, password, database = get_connection_params()
 
             client = Client(logger=self.logger, sql_log_mode="full")
-            client.connect(host, port, user, password, database)
+            client.connect(host=host, port=port, user=user, password=password, database=database)
 
             # Test 1: Simple transaction with commit
             self.logger.info("Test 1: Simple Transaction with Commit")
@@ -163,7 +163,7 @@ class TransactionManagementDemo:
             host, port, user, password, database = get_connection_params()
 
             client = Client(logger=self.logger, sql_log_mode="full")
-            client.connect(host, port, user, password, database)
+            client.connect(host=host, port=port, user=user, password=password, database=database)
 
             # Test error handling in transaction
             self.logger.info("Test: Transaction Error Handling")
@@ -236,7 +236,7 @@ class TransactionManagementDemo:
             host, port, user, password, database = get_connection_params()
 
             client = AsyncClient(logger=self.logger, sql_log_mode="full")
-            await client.connect(host, port, user, password, database)
+            await client.connect(host=host, port=port, user=user, password=password, database=database)
 
             # Test async transaction
             self.logger.info("Test: Async Transaction Management")

{matrixone_python_sdk-0.1.0 → matrixone_python_sdk-0.1.1}/examples/example_05_snapshot_restore.py

@@ -59,7 +59,7 @@ class SnapshotRestoreDemo:
             host, port, user, password, database = get_connection_params()
 
             client = Client(logger=self.logger, sql_log_mode="full")
-            client.connect(host, port, user, password, database)
+            client.connect(host=host, port=port, user=user, password=password, database=database)
 
             # Test 1: Create test data
             self.logger.info("Test 1: Create Test Data")
@@ -186,7 +186,7 @@ class SnapshotRestoreDemo:
             host, port, user, password, database = get_connection_params()
 
             client = Client(logger=self.logger, sql_log_mode="full")
-            client.connect(host, port, user, password, database)
+            client.connect(host=host, port=port, user=user, password=password, database=database)
 
             # Test snapshot enumeration
             self.logger.info("Test: Snapshot Enumeration")
@@ -223,7 +223,7 @@ class SnapshotRestoreDemo:
             host, port, user, password, database = get_connection_params()
 
             client = Client(logger=self.logger, sql_log_mode="full")
-            client.connect(host, port, user, password, database)
+            client.connect(host=host, port=port, user=user, password=password, database=database)
 
             # Test error handling
             self.logger.info("Test: Snapshot Error Handling")
@@ -266,7 +266,7 @@ class SnapshotRestoreDemo:
             host, port, user, password, database = get_connection_params()
 
             client = AsyncClient(logger=self.logger, sql_log_mode="full")
-            await client.connect(host, port, user, password, database)
+            await client.connect(host=host, port=port, user=user, password=password, database=database)
 
             # Test async snapshot operations
             self.logger.info("Test: Async Snapshot Operations")

{matrixone_python_sdk-0.1.0 → matrixone_python_sdk-0.1.1}/examples/example_06_sqlalchemy_integration.py

@@ -30,8 +30,8 @@ This example shows the complete SQLAlchemy integration capabilities.
 
 import logging
 import asyncio
-from sqlalchemy import create_engine, Column, Integer, String, DateTime, Text, ForeignKey, text
-from sqlalchemy.orm import declarative_base, sessionmaker, relationship
+from sqlalchemy import create_engine, Column, Integer, String, DateTime, Text, ForeignKey, text, and_
+from sqlalchemy.orm import declarative_base, sessionmaker, relationship, foreign
 from sqlalchemy.ext.asyncio import create_async_engine, AsyncSession
 from sqlalchemy.pool import QueuePool
 from matrixone import Client, AsyncClient
@@ -67,8 +67,8 @@ class User(Base):
     email = Column(String(100), unique=True, nullable=False)
     created_at = Column(DateTime)
 
-    # Relationship
-    posts = relationship("Post", back_populates="author")
+    # Relationship (ORM-level only)
+    posts = relationship("Post", back_populates="author", primaryjoin="User.id==foreign(Post.author_id)")
 
 
 class Post(Base):
@@ -77,11 +77,13 @@ class Post(Base):
     id = Column(Integer, primary_key=True)
     title = Column(String(200), nullable=False)
     content = Column(Text)
-    author_id = Column(Integer, ForeignKey('users.id'))
+    # Note: MatrixOne may have limitations with foreign key constraints
+    # Using Integer column without FK constraint, but keeping ORM relationship
+    author_id = Column(Integer)
     created_at = Column(DateTime)
 
-    # Relationship
-    author = relationship("User", back_populates="posts")
+    # Relationship (ORM-level only, no database FK constraint)
+    author = relationship("User", back_populates="posts", primaryjoin="foreign(Post.author_id)==User.id")
 
 
 class SQLAlchemyIntegrationDemo:
@@ -156,7 +158,8 @@ class SQLAlchemyIntegrationDemo:
             # Test ORM operations
             self.logger.info("Test: ORM Operations")
             try:
-                # Create tables
+                # Drop and recreate tables to ensure clean state
+                Base.metadata.drop_all(engine)
                 Base.metadata.create_all(engine)
                 self.logger.info("   Created tables")
 
@@ -218,7 +221,8 @@ class SQLAlchemyIntegrationDemo:
             # Test transactions
             self.logger.info("Test: SQLAlchemy Transactions")
             try:
-                # Create tables
+                # Drop and recreate tables to ensure clean state
+                Base.metadata.drop_all(engine)
                 Base.metadata.create_all(engine)
 
                 # Test transaction with commit

{matrixone_python_sdk-0.1.0 → matrixone_python_sdk-0.1.1}/examples/example_07_advanced_features.py

@@ -64,7 +64,7 @@ class AdvancedFeaturesDemo:
             host, port, user, password, database = get_connection_params()
 
             client = Client(logger=self.logger, sql_log_mode="full")
-            client.connect(host, port, user, password, database)
+            client.connect(host=host, port=port, user=user, password=password, database=database)
 
             # Test PubSub operations
             self.logger.info("Test: PubSub Operations")
@@ -111,7 +111,7 @@ class AdvancedFeaturesDemo:
             host, port, user, password, database = get_connection_params()
 
             client = Client(logger=self.logger, sql_log_mode="full")
-            client.connect(host, port, user, password, database)
+            client.connect(host=host, port=port, user=user, password=password, database=database)
 
             # Test clone operations
             self.logger.info("Test: Clone Operations")
@@ -157,7 +157,7 @@ class AdvancedFeaturesDemo:
             host, port, user, password, database = get_connection_params()
 
             client = Client(logger=self.logger, sql_log_mode="full")
-            client.connect(host, port, user, password, database)
+            client.connect(host=host, port=port, user=user, password=password, database=database)
 
             # Test MoCTL integration
             self.logger.info("Test: MoCTL Integration")
@@ -202,7 +202,7 @@ class AdvancedFeaturesDemo:
             host, port, user, password, database = get_connection_params()
 
             client = Client(logger=self.logger, sql_log_mode="full")
-            client.connect(host, port, user, password, database)
+            client.connect(host=host, port=port, user=user, password=password, database=database)
 
             # Test version information
             self.logger.info("Test: Version Information")
@@ -251,7 +251,7 @@ class AdvancedFeaturesDemo:
             host, port, user, password, database = get_connection_params()
 
             client = Client(logger=self.logger, sql_log_mode="full")
-            client.connect(host, port, user, password, database)
+            client.connect(host=host, port=port, user=user, password=password, database=database)
 
             # Test performance monitoring
             self.logger.info("Test: Performance Monitoring")
@@ -297,7 +297,7 @@ class AdvancedFeaturesDemo:
             host, port, user, password, database = get_connection_params()
 
             client = AsyncClient(logger=self.logger, sql_log_mode="full")
-            await client.connect(host, port, user, password, database)
+            await client.connect(host=host, port=port, user=user, password=password, database=database)
 
             # Test async advanced features
             self.logger.info("Test: Async Advanced Features")

{matrixone_python_sdk-0.1.0 → matrixone_python_sdk-0.1.1}/examples/example_08_pubsub_operations.py

@@ -62,7 +62,7 @@ class PubSubOperationsDemo:
             host, port, user, password, database = get_connection_params()
 
             client = Client(sql_log_mode="full")
-            client.connect(host, port, user, password, database)
+            client.connect(host=host, port=port, user=user, password=password, database=database)
 
             # Test basic PubSub operations
             self.logger.info("Test: Basic PubSub Operations")
@@ -145,7 +145,7 @@ def demo_cross_account_pubsub():
 
     try:
         # Connect as admin
-        admin_client.connect(host, port, user, password, "mo_catalog")
+        admin_client.connect(host=host, port=port, user=user, password=password, database="mo_catalog")
         logger.info("✅ Connected as admin")
 
         # Clean up any existing accounts first
@@ -193,23 +193,31 @@ def demo_cross_account_pubsub():
         publisher_client = Client(sql_log_mode="full")
 
         # Connect as publisher account admin
-        publisher_client.connect(host, port, "pub_publisher#pub_admin", "pub_pass", "mo_catalog")
+        publisher_client.connect(
+            host=host, port=port, user="pub_publisher#pub_admin", password="pub_pass", database="mo_catalog"
+        )
         logger.info("   ✅ Connected as publisher account admin")
 
         # Create publisher database
         pub_admin_client = Client(sql_log_mode="full")
-        pub_admin_client.connect(host, port, "pub_publisher#pub_admin", "pub_pass", "mo_catalog")
+        pub_admin_client.connect(
+            host=host, port=port, user="pub_publisher#pub_admin", password="pub_pass", database="mo_catalog"
+        )
         pub_admin_client.execute("CREATE DATABASE IF NOT EXISTS publisher_data")
         pub_admin_client.disconnect()
 
         # Connect to publisher database
         publisher_client.disconnect()
-        publisher_client.connect(host, port, "pub_publisher#pub_admin", "pub_pass", "publisher_data")
+        publisher_client.connect(
+            host=host, port=port, user="pub_publisher#pub_admin", password="pub_pass", database="publisher_data"
+        )
         logger.info("   ✅ Connected to publisher database")
 
         # Create tables for publishing
         pub_admin_client = Client(sql_log_mode="full")
-        pub_admin_client.connect(host, port, "pub_publisher#pub_admin", "pub_pass", "publisher_data")
+        pub_admin_client.connect(
+            host=host, port=port, user="pub_publisher#pub_admin", password="pub_pass", database="publisher_data"
+        )
 
         pub_admin_client.execute(
             """
@@ -281,7 +289,9 @@ def demo_cross_account_pubsub():
         subscriber_client = Client(sql_log_mode="full")
 
         # Connect as subscriber account admin
-        subscriber_client.connect(host, port, "pub_subscriber#sub_admin", "sub_pass", "mo_catalog")
+        subscriber_client.connect(
+            host=host, port=port, user="pub_subscriber#sub_admin", password="sub_pass", database="mo_catalog"
+        )
         logger.info("   ✅ Connected as subscriber account admin")
 
         # Create subscriptions
@@ -300,7 +310,9 @@ def demo_cross_account_pubsub():
 
         # Add new data as publisher
         pub_admin_client = Client(sql_log_mode="full")
-        pub_admin_client.connect(host, port, "pub_publisher#pub_admin", "pub_pass", "publisher_data")
+        pub_admin_client.connect(
+            host=host, port=port, user="pub_publisher#pub_admin", password="pub_pass", database="publisher_data"
+        )
 
         pub_admin_client.execute(f"INSERT INTO sales_data (product_name, quantity, price) VALUES ('Apple Watch', 3, 399.99)")
         logger.info("   📤 Added new sales data: Apple Watch")
@@ -334,7 +346,9 @@ def demo_cross_account_pubsub():
         try:
             # Create new connection for cleanup
             cleanup_client = Client(sql_log_mode="full")
-            cleanup_client.connect(host, port, "pub_publisher#pub_admin", "pub_pass", "mo_catalog")
+            cleanup_client.connect(
+                host=host, port=port, user="pub_publisher#pub_admin", password="pub_pass", database="mo_catalog"
+            )
             cleanup_client.execute("DROP DATABASE publisher_data")
             cleanup_client.disconnect()
             logger.info("   ✅ Dropped publisher database")
@@ -376,7 +390,7 @@ async def demo_async_pubsub_operations():
 
     try:
         # Connect to MatrixOne
-        await client.connect(host, port, user, password, database)
+        await client.connect(host=host, port=port, user=user, password=password, database=database)
         logger.info("✅ Connected to MatrixOne (async)")
 
         # Create test database and tables
@@ -497,7 +511,7 @@ def demo_pubsub_best_practices():
 
     try:
         # Connect to MatrixOne
-        client.connect(host, port, user, password, database)
+        client.connect(host=host, port=port, user=user, password=password, database=database)
         logger.info("✅ Connected to MatrixOne")
 
         # Create a realistic e-commerce scenario

{matrixone_python_sdk-0.1.0 → matrixone_python_sdk-0.1.1}/examples/example_09_logger_integration.py

@@ -71,7 +71,7 @@ class LoggerIntegrationDemo:
             self.logger.info("Test: Default Logger Configuration")
             try:
                 # Connect to MatrixOne
-                client.connect(host, port, user, password, database)
+                client.connect(host=host, port=port, user=user, password=password, database=database)
 
                 # Execute some queries to see logging in action
                 client.execute("SELECT 1 as test_value")
@@ -127,7 +127,7 @@ class LoggerIntegrationDemo:
             try:
                 # Create client with custom logger
                 client = Client(logger=custom_logger)
-                client.connect(host, port, user, password, database)
+                client.connect(host=host, port=port, user=user, password=password, database=database)
 
                 # Execute queries with custom logging
                 client.execute("SELECT 1 as custom_test")
@@ -276,7 +276,7 @@ class LoggerIntegrationDemo:
             try:
                 # Create client with auto SQL logging
                 client = Client(sql_log_mode="auto")
-                client.connect(host, port, user, password, database)
+                client.connect(host=host, port=port, user=user, password=password, database=database)
 
                 # Execute queries to test performance logging
                 client.execute("SELECT 1 as performance_test")
@@ -312,7 +312,7 @@ class LoggerIntegrationDemo:
             try:
                 # Create async client with auto SQL logging
                 client = AsyncClient(sql_log_mode="auto")
-                await client.connect(host, port, user, password, database)
+                await client.connect(host=host, port=port, user=user, password=password, database=database)
 
                 # Execute async queries
                 await client.execute("SELECT 1 as async_test")

{matrixone_python_sdk-0.1.0 → matrixone_python_sdk-0.1.1}/examples/example_10_version_management.py

@@ -118,7 +118,7 @@ class VersionManagementDemo:
             print("Test: Backend Version Detection")
             try:
                 client = Client()
-                client.connect(host, port, user, password, database)
+                client.connect(host=host, port=port, user=user, password=password, database=database)
 
                 # Get version information
                 version_info = client.version()

{matrixone_python_sdk-0.1.0 → matrixone_python_sdk-0.1.1}/examples/example_11_matrixone_version_demo.py

@@ -231,7 +231,7 @@ class MatrixOneVersionDemo:
                 from matrixone import Client
 
                 client = Client()
-                client.connect(host, port, user, password, database)
+                client.connect(host=host, port=port, user=user, password=password, database=database)
 
                 # Get version information
                 version_info = client.version()

{matrixone_python_sdk-0.1.0 → matrixone_python_sdk-0.1.1}/examples/example_13_vector_indexes.py

@@ -554,7 +554,7 @@ class VectorIndexDemo:
                 # Create async client
                 host, port, user, password, database = get_connection_params()
                 async_client = AsyncClient()
-                await async_client.connect(host, port, user, password, database)
+                await async_client.connect(host=host, port=port, user=user, password=password, database=database)
 
                 try:
                     # Enable fulltext indexing

{matrixone_python_sdk-0.1.0 → matrixone_python_sdk-0.1.1}/examples/example_18_snapshot_orm.py

@@ -56,7 +56,7 @@ class SnapshotORMDemo:
             host, port, user, password, database = get_connection_params()
 
             client = Client(logger=self.logger)
-            client.connect(host, port, user, password, database)
+            client.connect(host=host, port=port, user=user, password=password, database=database)
 
             # Test sync snapshot ORM
             self.logger.info("Test: Sync Snapshot ORM")
@@ -144,7 +144,7 @@ class SnapshotORMDemo:
             host, port, user, password, database = get_connection_params()
 
             client = AsyncClient(logger=self.logger)
-            await client.connect(host, port, user, password, database)
+            await client.connect(host=host, port=port, user=user, password=password, database=database)
 
             # Test async snapshot ORM
             self.logger.info("Test: Async Snapshot ORM")
@@ -225,7 +225,7 @@ class SnapshotORMDemo:
             host, port, user, password, database = get_connection_params()
 
             client = Client(logger=self.logger)
-            client.connect(host, port, user, password, database)
+            client.connect(host=host, port=port, user=user, password=password, database=database)
 
             # Test complex snapshot queries
             self.logger.info("Test: Complex Snapshot Queries")
@@ -320,7 +320,7 @@ class SnapshotORMDemo:
             host, port, user, password, database = get_connection_params()
 
             client = Client(logger=self.logger)
-            client.connect(host, port, user, password, database)
+            client.connect(host=host, port=port, user=user, password=password, database=database)
 
             # Test snapshot query builder methods
             self.logger.info("Test: Snapshot Query Builder Methods")

{matrixone_python_sdk-0.1.0 → matrixone_python_sdk-0.1.1}/examples/example_19_sqlalchemy_style_orm.py

@@ -86,7 +86,7 @@ class SQLAlchemyStyleORMDemo:
             host, port, user, password, database = get_connection_params()
 
             client = Client(logger=self.logger)
-            client.connect(host, port, user, password, database)
+            client.connect(host=host, port=port, user=user, password=password, database=database)
 
             # Test sync SQLAlchemy-style ORM
             self.logger.info("Test: Sync SQLAlchemy-style ORM")
@@ -94,10 +94,13 @@ class SQLAlchemyStyleORMDemo:
                 # Create test database and table
                 client.execute("CREATE DATABASE IF NOT EXISTS sqlalchemy_orm_test")
                 client.execute("USE sqlalchemy_orm_test")
+
+                # Drop both tables to ensure clean state
                 client.drop_table(Product)
+                client.drop_table(Order)
 
-                # Create table using ORM
-                Base.metadata.create_all(client._engine)
+                # Create only the Product table (we don't need Order in this test)
+                Product.__table__.create(client._engine)
 
                 # Insert test data
                 client.execute(
@@ -145,7 +148,7 @@ class SQLAlchemyStyleORMDemo:
             host, port, user, password, database = get_connection_params()
 
             client = AsyncClient(logger=self.logger)
-            await client.connect(host, port, user, password, database)
+            await client.connect(host=host, port=port, user=user, password=password, database=database)
 
             # Test async SQLAlchemy-style ORM
             self.logger.info("Test: Async SQLAlchemy-style ORM")
@@ -153,11 +156,14 @@ class SQLAlchemyStyleORMDemo:
                 # Create test database and table
                 await client.execute("CREATE DATABASE IF NOT EXISTS async_sqlalchemy_orm_test")
                 await client.execute("USE async_sqlalchemy_orm_test")
+
+                # Drop both tables to ensure clean state
                 await client.drop_table(Order)
+                await client.drop_table(Product)
 
-                # Create table using ORM
+                # Create only the Order table (we don't need Product in async test)
                 async with client._engine.begin() as conn:
-                    await conn.run_sync(Base.metadata.create_all)
+                    await conn.run_sync(Order.__table__.create)
 
                 # Insert test data
                 await client.execute(
@@ -205,7 +211,7 @@ class SQLAlchemyStyleORMDemo:
             host, port, user, password, database = get_connection_params()
 
             client = Client(logger=self.logger)
-            client.connect(host, port, user, password, database)
+            client.connect(host=host, port=port, user=user, password=password, database=database)
 
             # Test ORM query methods
             self.logger.info("Test: ORM Query Methods")
@@ -213,10 +219,13 @@ class SQLAlchemyStyleORMDemo:
                 # Create test database and table
                 client.execute("CREATE DATABASE IF NOT EXISTS orm_query_methods_test")
                 client.execute("USE orm_query_methods_test")
+
+                # Drop both tables to ensure clean state
                 client.drop_table(Product)
+                client.drop_table(Order)
 
-                # Create table using ORM
-                Base.metadata.create_all(client._engine)
+                # Create only the Product table (we don't need Order in this test)
+                Product.__table__.create(client._engine)
 
                 # Insert test data
                 client.execute(
@@ -271,7 +280,7 @@ class SQLAlchemyStyleORMDemo:
             host, port, user, password, database = get_connection_params()
 
             client = Client(logger=self.logger)
-            client.connect(host, port, user, password, database)
+            client.connect(host=host, port=port, user=user, password=password, database=database)
 
             # Test ORM with snapshots
             self.logger.info("Test: ORM with Snapshots")
@@ -282,8 +291,8 @@ class SQLAlchemyStyleORMDemo:
                 client.drop_table(Product)
                 client.drop_table(Order)
 
-                # Create table using ORM
-                Base.metadata.create_all(client._engine)
+                # Create only the Product table (we only use Product in this test)
+                Product.__table__.create(client._engine)
 
                 # Insert test data
                 client.execute(

{matrixone_python_sdk-0.1.0 → matrixone_python_sdk-0.1.1}/examples/example_21_advanced_orm_features.py

@@ -112,7 +112,7 @@ class AdvancedORMFeaturesDemo:
             host, port, user, password, database = get_connection_params()
 
             client = Client()
-            client.connect(host, port, user, password, database)
+            client.connect(host=host, port=port, user=user, password=password, database=database)
 
             # Create demo database
             demo_db = "demo_advanced_orm"

{matrixone_python_sdk-0.1.0 → matrixone_python_sdk-0.1.1}/examples/example_22_unified_sql_builder.py

@@ -71,8 +71,9 @@ class UnifiedSQLBuilderDemo:
         try:
             print("🔗 Setting up database connection...")
             connection_params = get_connection_params()
-            self.client = Client(*connection_params)
-            self.client.connect(*connection_params)
+            self.client = Client()
+            host, port, user, password, database = connection_params
+            self.client.connect(host=host, port=port, user=user, password=password, database=database)
             print("✅ Connected to MatrixOne successfully")
             return True
         except Exception as e:

{matrixone_python_sdk-0.1.0 → matrixone_python_sdk-0.1.1}/examples/example_25_metadata_operations.py

@@ -75,7 +75,8 @@ class MetadataOperationsDemo:
 
         # Create client and connect
         self.client = Client(logger=self.logger)
-        self.client.connect(*self.connection_params)
+        host, port, user, password, database = self.connection_params
+        self.client.connect(host=host, port=port, user=user, password=password, database=database)
 
         # Get SQLAlchemy engine and create session
         self.engine = self.client.get_sqlalchemy_engine()
@@ -357,7 +358,8 @@ class MetadataOperationsDemo:
         self.logger.info("\n=== Asynchronous Metadata Operations ===")
 
         client = AsyncClient()
-        await client.connect(*self.connection_params)
+        host, port, user, password, database = self.connection_params
+        await client.connect(host=host, port=port, user=user, password=password, database=database)
 
         try:
             # Async metadata scan with raw results

{matrixone_python_sdk-0.1.0 → matrixone_python_sdk-0.1.1}/examples/example_dynamic_logging.py

@@ -39,7 +39,7 @@ def demo_dynamic_config_update():
     # Start with 'simple' logging mode
     logger = create_default_logger(sql_log_mode='simple')
     client = Client(logger=logger)
-    client.connect(host, port, user, password, database)
+    client.connect(host=host, port=port, user=user, password=password, database=database)
 
     # Create test table
     client.execute("DROP TABLE IF EXISTS dynamic_log_test")
@@ -100,7 +100,7 @@ def demo_per_operation_override():
     # Start with 'off' logging mode
     logger = create_default_logger(sql_log_mode='off')
     client = Client(logger=logger)
-    client.connect(host, port, user, password, database)
+    client.connect(host=host, port=port, user=user, password=password, database=database)
 
     # Create test table
     client.execute("DROP TABLE IF EXISTS override_log_test")
@@ -162,7 +162,7 @@ def demo_debugging_scenario():
     # Production setup: minimal logging
     logger = create_default_logger(sql_log_mode='simple', slow_query_threshold=1.0)
     client = Client(logger=logger)
-    client.connect(host, port, user, password, database)
+    client.connect(host=host, port=port, user=user, password=password, database=database)
 
     # Create test table
     client.execute("DROP TABLE IF EXISTS debug_scenario")

{matrixone_python_sdk-0.1.0 → matrixone_python_sdk-0.1.1}/matrixone/async_client.py

@@ -1488,11 +1488,12 @@ class AsyncClient(BaseMatrixOneClient):
 
     async def connect(
         self,
-        host: str,
-        port: int,
-        user: str,
-        password: str,
-        database: str = None,
+        *,
+        host: str = "localhost",
+        port: int = 6001,
+        user: str = "root",
+        password: str = "111",
+        database: str,
         account: Optional[str] = None,
         role: Optional[str] = None,
         charset: str = "utf8mb4",
@@ -1573,8 +1574,12 @@ class AsyncClient(BaseMatrixOneClient):
 
             self.logger.log_connection(host, port, final_user, database or "default", success=True)
 
-            # Setup connection hook if provided
-            if on_connect:
+            # Setup connection hook (default to ENABLE_ALL if not provided)
+            # Allow empty list [] to explicitly disable hooks
+            if on_connect is None:
+                on_connect = [ConnectionAction.ENABLE_ALL]
+
+            if on_connect:  # Only setup if not empty list
                 self._setup_connection_hook(on_connect)
                 # Execute the hook once immediately for the initial connection
                 await self._execute_connection_hook_immediately(on_connect)
@@ -1582,7 +1587,18 @@ class AsyncClient(BaseMatrixOneClient):
         except Exception as e:
             self.logger.log_connection(host, port, final_user, database or "default", success=False)
             self.logger.log_error(e, context="Async connection")
-            raise ConnectionError(f"Failed to connect to MatrixOne: {e}")
+
+            # Provide user-friendly error messages for common issues
+            error_msg = str(e)
+            if 'Unknown database' in error_msg or '1049' in error_msg:
+                db_name = database or "default"
+                raise ConnectionError(
+                    f"Database '{db_name}' does not exist. Please create it first:\n"
+                    f"  mysql -h{host} -P{port} -u{user.split('#')[0] if '#' in user else user} -p{password} "
+                    f"-e \"CREATE DATABASE {db_name}\""
+                ) from e
+            else:
+                raise ConnectionError(f"Failed to connect to MatrixOne: {e}") from e
 
     def _setup_connection_hook(
         self, on_connect: Union[ConnectionHook, List[Union[ConnectionAction, str]], Callable]

{matrixone_python_sdk-0.1.0 → matrixone_python_sdk-0.1.1}/matrixone/client.py

@@ -244,10 +244,11 @@ class Client(BaseMatrixOneClient):
 
     def connect(
         self,
-        host: str,
-        port: int,
-        user: str,
-        password: str,
+        *,
+        host: str = "localhost",
+        port: int = 6001,
+        user: str = "root",
+        password: str = "111",
         database: str,
         ssl_mode: str = "preferred",
         ssl_ca: Optional[str] = None,
@@ -345,8 +346,12 @@ class Client(BaseMatrixOneClient):
             except Exception as e:
                 self.logger.warning(f"Failed to detect backend version: {e}")
 
-            # Setup connection hook if provided
-            if on_connect:
+            # Setup connection hook (default to ENABLE_ALL if not provided)
+            # Allow empty list [] to explicitly disable hooks
+            if on_connect is None:
+                on_connect = [ConnectionAction.ENABLE_ALL]
+
+            if on_connect:  # Only setup if not empty list
                 self._setup_connection_hook(on_connect)
                 # Execute the hook once immediately for the initial connection
                 self._execute_connection_hook_immediately(on_connect)
@@ -354,7 +359,17 @@ class Client(BaseMatrixOneClient):
         except Exception as e:
             self.logger.log_connection(host, port, final_user, database, success=False)
             self.logger.log_error(e, context="Connection")
-            raise ConnectionError(f"Failed to connect to MatrixOne: {e}")
+
+            # Provide user-friendly error messages for common issues
+            error_msg = str(e)
+            if 'Unknown database' in error_msg or '1049' in error_msg:
+                raise ConnectionError(
+                    f"Database '{database}' does not exist. Please create it first:\n"
+                    f"  mysql -h{host} -P{port} -u{user.split('#')[0] if '#' in user else user} -p{password} "
+                    f"-e \"CREATE DATABASE {database}\""
+                ) from e
+            else:
+                raise ConnectionError(f"Failed to connect to MatrixOne: {e}") from e
 
     def _setup_connection_hook(
         self, on_connect: Union[ConnectionHook, List[Union[ConnectionAction, str]], Callable]
@@ -1686,7 +1701,25 @@ class Client(BaseMatrixOneClient):
             from .sqlalchemy_ext import FulltextIndex, VectorIndex
             from sqlalchemy.schema import CreateTable, CreateIndex
 
-            with self.get_sqlalchemy_engine().begin() as conn:
+            try:
+                engine_context = self.get_sqlalchemy_engine().begin()
+            except Exception as e:
+                # Handle database connection errors with user-friendly messages
+                error_msg = str(e)
+                if 'Unknown database' in error_msg or '1049' in error_msg:
+                    db_name = self._connection_params.get('database', 'unknown')
+                    raise ConnectionError(
+                        f"Database '{db_name}' does not exist. Please create it first:\n"
+                        f"  mysql -h{self._connection_params.get('host', 'localhost')} "
+                        f"-P{self._connection_params.get('port', 6001)} "
+                        f"-u{self._connection_params.get('user', 'root')} "
+                        f"-p{self._connection_params.get('password', '***')} "
+                        f"-e \"CREATE DATABASE {db_name}\""
+                    ) from e
+                else:
+                    raise ConnectionError(f"Failed to connect to database: {error_msg}") from e
+
+            with engine_context as conn:
                 # Create table without indexes first
                 # Build CREATE TABLE statement without indexes
                 create_table_sql = str(CreateTable(table).compile(dialect=conn.dialect))

{matrixone_python_sdk-0.1.0 → matrixone_python_sdk-0.1.1}/matrixone/restore.py

@@ -204,7 +204,9 @@ class RestoreManager:
             result = self._client.execute(sql)
             return result is not None
         except Exception as e:
-            raise RestoreError(f"Failed to restore database '{database_name}' from snapshot '{snapshot_name}': {e}") from None
+            raise RestoreError(
+                f"Failed to restore database '{database_name}' from snapshot '{snapshot_name}': {e}"
+            ) from None
 
     def restore_table(
         self,
@@ -323,7 +325,9 @@ class RestoreManager:
                     )
             elif restore_type == "table":
                 if not all([account_name, database_name, table_name]):
-                    raise RestoreError("Account name, database name, and table name are required for table restore") from None
+                    raise RestoreError(
+                        "Account name, database name, and table name are required for table restore"
+                    ) from None
                 if to_account:
                     sql = (
                         f"RESTORE ACCOUNT {self._client._escape_identifier(account_name)} "

{matrixone_python_sdk-0.1.0 → matrixone_python_sdk-0.1.1/matrixone_python_sdk.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: matrixone-python-sdk
-Version: 0.1.0
+Version: 0.1.1
 Summary: A comprehensive Python SDK for MatrixOne database operations with vector search, fulltext search, and advanced features
 Home-page: https://github.com/matrixorigin/matrixone
 Author: MatrixOne Team
@@ -185,6 +185,22 @@ print(f"MatrixOne version: {version}")
 client.disconnect()
 ```
 
+> **📝 Connection Parameters**
+> 
+> The `connect()` method requires **keyword arguments** (not positional):
+> - `database` - **Required**, no default value
+> - `host` - Default: `'localhost'`
+> - `port` - Default: `6001`
+> - `user` - Default: `'root'`
+> - `password` - Default: `'111'`
+> 
+> **Minimal connection** (uses all defaults):
+> ```python
+> client.connect(database='test')
+> ```
+> 
+> By default, all features (IVF, HNSW, fulltext) are automatically enabled via `on_connect=[ConnectionAction.ENABLE_ALL]`.
+
 ### Async Usage
 
 ```python

{matrixone_python_sdk-0.1.0 → matrixone_python_sdk-0.1.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "matrixone-python-sdk"
-version = "0.1.0"
+version = "0.1.1"
 description = "A comprehensive Python SDK for MatrixOne database operations with vector search, fulltext search, and advanced features"
 readme = "README_USER.md"
 license = {text = "Apache-2.0"}