Docs: Update version references to v0.26.2 in READMEs and docs (#16387)

This commit is contained in:
Liu An
2026-06-29 09:40:45 +08:00
committed by yzc
parent 9d18f33296
commit f86a0e7386
33 changed files with 82 additions and 82 deletions

View File

@@ -275,8 +275,8 @@ python db_schema_sync.py [OPTIONS]
### Version Format
Version must be in format `vxx.xx.xx` where `xx` are digits:
- Valid: `v0.26.1`, `v1.0.0`, `v10.20.30`
- Invalid: `0.26.1`, `v0.25`, `v0.26.1.1`
- Valid: `v0.26.2`, `v1.0.0`, `v10.20.30`
- Invalid: `0.26.2`, `v0.25`, `v0.26.2.1`
### Migration File Location
@@ -287,7 +287,7 @@ tools/migrate/{version_dir}/
Where `{version_dir}` is the version with `.` replaced by `_`.
Example: Version `v0.26.1` → Directory `tools/migrate/v0_26_1/`
Example: Version `v0.26.2` → Directory `tools/migrate/v0_26_2/`
### Examples
@@ -295,32 +295,32 @@ Example: Version `v0.26.1` → Directory `tools/migrate/v0_26_1/`
# List all migrations
python db_schema_sync.py --list \
--host localhost --port 3306 --user root --password xxx --database rag_flow \
--version v0.26.1
--version v0.26.2
# Create a new auto-detected migration (new tables, new fields, type changes only)
python db_schema_sync.py --create \
--host localhost --port 3306 --user root --password xxx --database rag_flow \
--version v0.26.1
--version v0.26.2
# Create a migration including dropped fields (destructive!)
python db_schema_sync.py --create --drop \
--host localhost --port 3306 --user root --password xxx --database rag_flow \
--version v0.26.1
--version v0.26.2
# Create a named migration
python db_schema_sync.py --create --name add_user_table \
--host localhost --port 3306 --user root --password xxx --database rag_flow \
--version v0.26.1
--version v0.26.2
# Run all pending migrations
python db_schema_sync.py --migrate \
--host localhost --port 3306 --user root --password xxx --database rag_flow \
--version v0.26.1
--version v0.26.2
# Show schema differences (including removed fields)
python db_schema_sync.py --diff \
--host localhost --port 3306 --user root --password xxx --database rag_flow \
--version v0.26.1
--version v0.26.2
```
## How It Works

View File

@@ -55,7 +55,7 @@ def validate_version(version: str) -> bool:
def version_to_dirname(version: str) -> str:
"""Convert version string to valid directory name (e.g., 'v0.26.1' -> 'v0_26_1')"""
"""Convert version string to valid directory name (e.g., 'v0.26.2' -> 'v0_26_2')"""
return version.replace('.', '_')
@@ -839,19 +839,19 @@ def main():
epilog="""
Examples:
# List all migrations
python db_schema_sync.py --list --host localhost --port 3306 --user root --password xxx --database rag_flow --version v0.26.1
python db_schema_sync.py --list --host localhost --port 3306 --user root --password xxx --database rag_flow --version v0.26.2
# Create migration from model changes
python db_schema_sync.py --create --host localhost --port 3306 --user root --password xxx --database rag_flow --version v0.26.1
python db_schema_sync.py --create --host localhost --port 3306 --user root --password xxx --database rag_flow --version v0.26.2
# Create migration including dropped fields (destructive!)
python db_schema_sync.py --create --drop --host localhost --port 3306 --user root --password xxx --database rag_flow --version v0.26.1
python db_schema_sync.py --create --drop --host localhost --port 3306 --user root --password xxx --database rag_flow --version v0.26.2
# Run all pending migrations
python db_schema_sync.py --migrate --host localhost --port 3306 --user root --password xxx --database rag_flow --version v0.26.1
python db_schema_sync.py --migrate --host localhost --port 3306 --user root --password xxx --database rag_flow --version v0.26.2
# Show schema differences
python db_schema_sync.py --diff --host localhost --port 3306 --user root --password xxx --database rag_flow --version v0.26.1
python db_schema_sync.py --diff --host localhost --port 3306 --user root --password xxx --database rag_flow --version v0.26.2
"""
)
@@ -864,7 +864,7 @@ Examples:
# Version option
parser.add_argument('--version', '-v', type=str, required=True,
help='Version number in format vxx.xx.xx (e.g., v0.26.1)')
help='Version number in format vxx.xx.xx (e.g., v0.26.2)')
# Action options
parser.add_argument('--list', '-l', action='store_true', help='List all migrations')
@@ -882,7 +882,7 @@ Examples:
# Validate version format
if not validate_version(args.version):
logger.error(f"Invalid version format: {args.version}. Expected format: vxx.xx.xx (e.g., v0.26.1)")
logger.error(f"Invalid version format: {args.version}. Expected format: vxx.xx.xx (e.g., v0.26.2)")
sys.exit(1)
# Validate at least one action is specified

View File

@@ -1426,10 +1426,10 @@ Examples:
python mysql_migration.py --list-stages
# Check whether migration is needed for a target version
python mysql_migration.py --check-database-version --database-version v0.26.1 --config /path/to/config.yaml
python mysql_migration.py --check-database-version --database-version v0.26.2 --config /path/to/config.yaml
# Mark database version separately
python mysql_migration.py --mark-database-version --database-version v0.26.1 --config /path/to/config.yaml
python mysql_migration.py --mark-database-version --database-version v0.26.2 --config /path/to/config.yaml
# Dry run (default - check only, no write) with config file
python mysql_migration.py --stages tenant_model_provider --config /path/to/config.yaml
@@ -1443,11 +1443,11 @@ Examples:
# Execute full migration (create tables and migrate data)
python mysql_migration.py --stages tenant_model_provider --config /path/to/config.yaml --execute
# Execute migration only when database version is lower than v0.26.1
python mysql_migration.py --stages tenant_model_provider --config /path/to/config.yaml --execute --database-version v0.26.1
# Execute migration only when database version is lower than v0.26.2
python mysql_migration.py --stages tenant_model_provider --config /path/to/config.yaml --execute --database-version v0.26.2
# Execute migration and mark the database version when all stages succeed
python mysql_migration.py --stages tenant_model_provider,tenant_model_instance,tenant_model,model_id_config --config /path/to/config.yaml --execute --database-version v0.26.1 --mark-database-version-on-success
python mysql_migration.py --stages tenant_model_provider,tenant_model_instance,tenant_model,model_id_config --config /path/to/config.yaml --execute --database-version v0.26.2 --mark-database-version-on-success
# Normalize legacy model IDs in stored configs
python mysql_migration.py --stages model_id_config --config /path/to/config.yaml --execute