Excel-to-SQL_Server/CLAUDE.md

Excel to SQL Server Migration

用途

将局域网共享目录中的 Excel (.xlsm) 生产执行卡数据同步并迁移到 SQL Server。

部署

python -m venv .venv
.venv\Scripts\pip install -r requirements.txt
cp config.yaml.example config.yaml  # 编辑数据库连接和 LAN 路径

命令

# 单次同步 LAN 文件并迁移变更的表
.venv\Scripts\python watch.py --once

# 守护进程模式（定时同步+迁移）
.venv\Scripts\pythonw watch.py

# 全量迁移（所有表，首次使用）
.venv\Scripts\python migrate.py

# 全量迁移（仅预览，不写库）
.venv\Scripts\python migrate.py --dry-run

# 清空后重写指定表
.venv\Scripts\python migrate.py --truncate --table PG_2025 TM_2026

配置 (config.yaml)

• sql_server: 数据库连接信息
• lan_sources: 本地相对路径 → LAN UNC 绝对路径
• tables: 目标表名与 Excel 源文件/sheet 的映射
• check_interval_minutes: watch 守护进程同步间隔（分钟）
• logging: 日志级别、目录、保留天数