简介这份组件包是数据库比较器Clever Database Comparer v8.2.955.0适用于Delphi 7到13.1 Florence。它主要面向Delphi开发者或数据库管理员用于快速发现两个数据库之间的结构差异并生成或执行同步脚本降低人工维护表、存储过程、视图和触发器时出错的可能。压缩包内共有2000个文件整体大小仅3MB文件类型以Delphi与CBuilder的工程文件为主同时包含大量Pascal/C源代码、窗体和资源文件、SQL脚本以及CHM/HTML帮助文档方便查看工程组织、组件实现和使用方法。该组件还支持灵活设置比较范围比如是否包含存储过程、视图和触发器的比较是否忽略注释或格式差异也能导出同步脚本。借助该工具可形成可控且可重复的同步流程对持续集成或部署尤其有帮助当前已有38人学习下载适合需要维护多个数据库版本或在Delphi项目中完成数据库结构同步的开发人员与数据库管理员选用。1. 为什么我拿到 Delphi 13.1 的 Clever Database Comparer 先不急着点 Compare开发库和测试库分明是同一套脚本发布的可每次上线前抽查总有几处对不上存储过程少了个过滤条件、某张表的字段默认值被顺手改过、数据字典里多出两条没人记得的记录。Delphi 13.1 的 Clever Database Comparer v8.2.955.0支持 D7 到 D13 Florence就是用来治这个黑匣子问题的它把两个数据库之间的结构差异和数据差异扫出来再生成一份可以直接执行的同步 SQL。适合手里管着老版本 Delphi、数据库环境不止一套的开发者或 DBA也适合想把数据库版本校验收进脚本而不是靠人工抽查的团队。这一类工具在数据库比较领域不算冷门但“带 Delphi 控件包分发”和“支持 D7-D13 全部 IDE 版本”这两个特征放在一起就比较少见。下面的内容全部围绕怎么装、怎么配、怎么跑、踩在哪几个坑上展开照着做能少走很多弯路。2. 安装到 Delphi 13.1先处理包版本匹配再谈组件注册2.1 先分清包里哪份文件属于 Delphi 13.1“Florence”解压开 7z 之后第一件事不是双击 install而是看目录结构。我见过太多人拿到这类控件包直接复制旧版本目录里的 bpl 到新 IDE 里结果 IDE 起来就报“package not found”。Clever 的包通常把编译产物按 Delphi 版本拆分D7、D10、D11、D12、D13 会分别对应不同后缀或不同子目录。Delphi 13.1 的代号是 Florence所以你要找的是文件名里带“D13”或“Florence”的那一组文件而不是带“D7”或“D11”的。为什么要分这么细因为不同版本的 Delphi 使用不同的 RTL 包名、编译器和 ABI 规则。Delphi 7 时代的原生 Pascal 代码、字符串内部表示、运行时包依赖体系和你现在用的 13.1 差别非常大跨版本安装一份 bpl轻则 IDE 拒绝加载重则触发内存访问冲突。版本越新这种隔离做得越严格。也就是说标题里那串“D7-13”不是营销话术而是实际存在的多套编译产物。压缩包内常见标记适用 IDE 版本安装位置D7 / D2007 / D2010Delphi 7 到 2010对应 BDS 版本的 bin 与 lib 目录D10.3 / D10.4Rio / SydneyRAD Studio 10.3 / 10.4 对应目录D11 / D12Alexandria / Athens对应版本目录D13 / FlorenceDelphi 13.1当前使用的 13.1 目录我一般会先把压缩包里的文件列表导出看一眼再决定复制哪些不凭文件名猜。这一步省下的时间远远多于点开 7z 的几秒钟。2.2 用批处理把 bpl / dcp / dcu 落到 IDE 目录如果包带了安装程序直接用即可如果没有常见做法是把编译产物手工复制到 RAD Studio 对应的目录并在注册表里登记设计期包。下面这个批处理脚本是通用的安装骨架路径里的方括号部分按你机器上的实际目录替换。echo off set BDSC:\Program Files (x86)\Embarcadero\Studio\[D13版本目录] set BPL%BDS%\bin set DCU%BDS%\lib\Win32\Release rem 请按压缩包里 D13 目录的实际文件扩展名调整 xcopy /Y .\D13\*.bpl %BPL%\ xcopy /Y .\D13\*.dcp %DCU%\ xcopy /Y .\D13\*.dcu %DCU%\ rem 注册设计期包bpl 文件名以包里实际文件为准 reg add HKCU\Software\Embarcadero\BDS\[内部版本号]\Known IDE Packages ^ /v %BPL%\CleverDBComparerD13.bpl /t REG_SZ /d Database Comparer Components /f echo install done. please restart bds.exe这段脚本做了三件事xcopy 把 bpl 复制到 IDE 的 bin 目录让 IDE 启动时能找到运行期包把 dcp 复制到 lib 下的 Win32\Release供编译工程链接使用再把 dcu 一起铺过去避免 IDE 后来重新编译时找不到源文件。最后用 reg add 写入当前用户的已知 IDE 包列表这一步是让组件出现在 Component Install Packages 里的关键。很多安装教程只提复制文件不提注册所以装完总是看不到组件。注意内部版本号不要照抄网上的旧值。查看办法是打开 Delphi 13.1 的 About 对话框或者查注册表 HKCU\Software\Embarcadero\BDS 下有几个数字子键选里面最大的那个。装错了 reg 路径IDE 不认。2.3 装好后怎么验证没白装启动 Delphi 13.1打开 Component Install Packages列表里应该能看到形如“Database Comparer Components”的条目。然后新建一个 VCL Application组件面板上如果多出比较器相关的图标说明设计期包加载成功。这里有个容易绕弯的点如果只是要用 Clever Database Comparer 做数据库差异比较其实不一定非要走 IDE 安装流程。Clever 这个产品比较特殊它既提供了可以嵌入你自己程序的 Delphi 组件也带了独立的可比对的 GUI 工具。很多团队的用法是只在某台机器上装完整包生成会话文件然后让其他人通过命令行调用。你按“控件”安装的同时把独立执行文件也找出来单独放一个目录后面跑批处理、做定时任务时都靠它不依赖 IDE。验证的时候我习惯顺手新建一个空工程拖一个组件到 Form 上编译一下看 IDE 会不会弹“找不到 dcu”这类错误。如果编译通过说明 dcp/dcu 路径也配置对了不只是 bpl 注册成功。3. 跑通第一组数据库比较从连接配置到生成同步 SQL安装只是热身真正决定你能不能把 Clever Database Comparer 用起来的是比较会话的配置。这里不聊 GUI 上每个按钮只讲从连接配置到产出同步 SQL 这条主链路。3.1 连接配置与驱动选择别把比较账号设成管理员第一次启动比较器先新建一个比较会话。以 MySQL 为例需要给出源库和目标库的服务器地址、端口、数据库名、账号、密码。这个步骤看起来简单坑在于权限设计。比较器要读取表结构、视图定义、存储过程源码、触发器它需要的不是 SELECT 权限还包括 SHOW VIEW、PROCEDURE、TRIGGER 这类元数据权限。但是不要图省事直接给管理员账号因为比较器会把目标库当成普通数据源连接万一同步脚本被误执行管理员账号带来的破坏比只读账号大得多。[Connection] SourceTypeMySQL SourceServer192.168.1.21 SourcePort3306 SourceDatabaseshop_dev SourceUsercompare_user SourcePassword****** TargetTypeMySQL TargetServer192.168.1.22 TargetPort3306 TargetDatabaseshop_test TargetUsercompare_user TargetPassword****** [CompareOptions] CompareSchema1 CompareData0 IgnoreRegEx^(sys|information_schema)上面的 INI 是脱敏后的示意结构不同版本的实际键名可能有差异。重点是 CompareSchema 和 CompareData 这两个开关结构比较和数据比较要分开做。第一次跑通建议只开结构比较数据比较放在后面对齐字段之后再开否则两个库的数据本来就不一样差异报告会膨胀到你不想看。端口和 SSL 这类参数也很容易翻车。MySQL 在高版本默认开启 caching_sha2_password旧客户端驱动可能连握手都过不了SQL Server 那边又涉及实例名和 TCP/IP 端口是否启用。遇到连不上的问题先换一个客户端库版本试试不要一开始就怀疑比较器有问题。3.2 对象范围别一张表不剩全选选择比较范围时大多数人习惯“全选”这是比较报告进去出不来的主要原因。系统表、临时表、没有权限读取的对象都会被列进差异里识别为“未知状态”干扰你判断真实差异。我建议按对象类型做一次筛选只保留这次发布真正关心的对象。下面这张表可以作为勾选参照。对象类型比较内容常见差异来源表字段名、类型、长度、默认值、约束、索引有人直接改过测试库没同步脚本自增起点不同视图SELECT 文本、字段列表schema 前缀不同、with check option 差异存储过程/函数参数、返回类型、过程体源码修改后没在开发库升级脚本里登记触发器触发时机、事件、体源码环境手工修复时新增序列/自增当前值、步长、缓存大小数据导入后自增起点漂移比较器一般会把上面的对象打平成一份列表直接勾选即可。我习惯只勾“表和存储过程”先跑一轮其他对象等确认这两个大头干净后再放开做全量。3.3 生成同步脚本前后的检查点差异列表确认之后比较器会生成同步脚本。这个脚本不是拿来就执行的它只是根据两个库的实际差别推算出的“目标对齐动作”。常见情况是它生成一条 ALTER TABLE 把测试库字段改成开发库样式然后生成若干条 UPDATE 把数据也拉齐。如果结构脚本和数据脚本混在一起执行顺序错了就会报字段不存在。-- 同步脚本片段由比较器生成这里是脱敏后的形式 ALTER TABLE shop_test.order_detail ADD COLUMN channel_id INT NULL AFTER pay_at; UPDATE shop_test.sku SET status1 WHERE status0;同步脚本里 ALTER 是结构差异UPDATE 是数据差异。执行时应该先跑结构脚本再跑数据脚本否则 UPDATE 的目标列可能在测试库里还不存在直接报 1054 Unknown column。另外一个检查点凡是数据比较带来的 UPDATE/DELETE都要仔细看 WHERE 条件。比较器依据主键匹配行但如果源库和目标库的主键定义不一致WHERE 子句可能匹配不到任何行或者更危险匹配到错的行。生成脚本前我会把差异列表按对象类型排序扫一遍重点看有没有“索引被重复创建”“字段顺序调整”这类看似差异、实际不影响业务的噪音。Clever 一般会提供忽略规则比如忽略对象限定名差异、忽略默认值里的空白符。把噪音过滤掉再把脚本交给 DBA这才是这个工具的正确用法。4. 命令行与 CI把数据库差异检查变成自动化巡检手工在 GUI 里点比较能解决临时问题但数据库一致性不是一次性工作——开发库每周更新测试库每天有人乱动新同事可能直接在测试环境改表结构。这时候就需要把 Clever Database Comparer 的比价能力接进命令行做成可重复执行的巡检项。4.1 为什么不直接用 GUI 一次一次点GUI 适合分析和确认不适合重复劳动。假设你有三套环境每套环境要对比结构、数据、索引手动点一遍要 20 分钟而且中间很容易选错对象范围。命令行模式可以把所有参数固化到一个会话文件里以后每次运行都是同一套规则结果也便于留存。用命令行之前先确认控制台程序的真实参数名。不同版本对命令行的支持方式不一样但通常都支持把一个会话文件传进去再指定输出脚本和日志文件。先用帮助命令看一下实际参数名。DatabaseComparerConsole.exe /? help.txt注意这里用 /in /out /log 其实是一种常见约定不一定和你手头版本完全一致。运行一次 /? 或 /help看到真实参数名后再写脚本别硬套网上流传的老版本参数。4.2 一个能直接排进任务计划的批处理我一般把比较会话做成独立文件放在和批处理同级的 sessions 目录下名称就叫 compare_job.cdc 或类似后缀。批处理里只需要做三件事接受会话文件路径、调用控制台程序、根据结果决定是否让任务失败。echo off set SESSION%1 if %SESSION% set SESSIONcompare_job.cdc set TODAY%date:~0,4%%date:~5,2%%date:~8,2% DatabaseComparerConsole.exe /in:%SESSION% /out:sync_%TODAY%.sql /log:log_%TODAY%.txt if errorlevel 1 goto :fail findstr /C:差异数量 /C:Conflict log_%TODAY%.txt nul || goto :report :fail echo job failed or differences found exit /b 1 :report echo compare done, differences detected这段脚本里有一个很关键的设计if errorlevel 1 是留给控制台程序内部错误的比如数据库连不上、会话文件读不出来。但大多数比较器在“正常完成比较发现差异”时退出码往往是 0因为它把差异当成正常业务结果。所以你还需要第二步用 findstr 去日志里查“差异数量”或“Conflict”这样的关键字发现存在差异时主动把退出码置为 1。这一步是给定时任务和 CI 用的没有它你的任务永远“成功”等于白跑。日志文件名带上日期是方便事后追溯。我还会在批处理末尾加一条“复制 sync_%TODAY%.sql 到报告目录”的操作把每次生成的脚本归档。这样即使一个月后要查某次发布前测试库和开发库差了什么也能凭日志还原现场。4.3 接进 GitLab CI 的最小配置如果你所在团队用 GitLab CI 或Jenkins可以在流水线里加一个数据库检查任务。下面是一个 GitLab CI 的片段示例核心是调用上一节的批处理并把生成物设为 artifacts。database-check: stage: test script: - cmd /c scripts\db_compare.bat scripts\compare_job.cdc artifacts: paths: - scripts\sync_*.sql - scripts\log_*.txt expire_in: 2 weeks when: always这里有两个习惯值得提。一是 artifacts 里保留同步 SQL 和日志而不是只保留“通过/失败”状态。DBA 审核时可以直接打开 SQL 文件看差异细节不必重新跑一遍。二是 expire_in 设成两周既留足追溯周期又不占太多流水线存储。另一个习惯是不要在 CI 里直接执行同步脚本。比较器生成的 SQL 只是对齐两个库的手段不代表这个动作被业务允许自动执行到生产库上属于高风险操作一般建议 CI 只做“生成脚本和报告”执行留给人工确认。命令行接到 CI 之后还有一个附加价值每次合入代码前可以强制对比最新开发库和稳定测试库如果结构差异超出预期流水线直接变红。这在多人协作、且有人绕过升级脚本直接改数据库的团队里等于多了一道自动拦截。5. 避坑Clever Database Comparer 用得越深越容易忽略的几个坑工具本身不复杂复杂的是数据库环境。这一章按“现象 → 原因 → 解决”的顺序写五条踩坑记录都是我能明确复现的典型问题。5.1 现象装完包 IDE 启动报 package not found装完后重启 Delphi 13.1IDE 直接弹窗说找不到某个 bpl甚至 IDE 起都没起来。原因是把包复制到了错误的位置或者复制了旧版本目录下的 bpl。尤其是在同一台机器上装了多个 Delphi 版本时bin 目录路径容易搞混系统会把文件复制到 D7 或 D11 的目录里D13 启动时自然找不到。解决卸载已注册的包把错误目录下的 bpl/dcp 清干净重新按 2.2 节脚本执行并确认 xcopy 的目标路径确实是 Studio[D13版本目录]\bin。重复出问题时直接在 reg 编辑器里搜“Database Comparer”找到后删掉再装就能绕开注册表残留。5.2 现象视图和存储过程几乎全部显示不一致两个库明明没人改过这些对象可差异列表里几乎每条视图、每个存储过程都被标红。我遇到过的最常见原因是连接账号缺少查看对象定义的权限。MySQL 下 SHOW VIEW 权限缺失会让工具拿到空文本SQL Server 下缺少 VIEW DEFINITION 权限也会有类似现象。另一个原因是字符集排序规则不同两个库的校对规则不一致导致工具比较源码文本时认为每个字符都不同。解决给比较账号单独授予元数据读取权限例如 MySQL 下 grant show view on 库名.* to 比较账号同时在比较选项里勾选“忽略排序规则差异”或“忽略对象限定名”。这两个选项别一起开先开一个看效果避免把真实差异也过滤掉。5.3 现象表结构一致数据比较结果却冒出大量差异这类问题最容易让人怀疑工具是不是坏了。实际上bit 字段、timestamp 字段、计算列都会造成误报。bit 在源库返回 true/false目标库返回 0/1timestamp 在行更新时可能自动变化计算列根本不该纳入数据比较但默认配置可能把它算进去。解决进入数据比较的列设置把计算列、自动时间戳、行版本列排除再重新比较。对 bit 类型的差异如果业务上确实允许 0/1 和 true/false 等价可以用比较器的值映射功能把它们归一化。处理完成后再跑一轮误报数量会大幅下降。5.4 现象生成的同步脚本执行到一半失败把同步脚本拿到目标库执行跑到中间报外键冲突或字段不存在。原因通常是对象执行顺序不对。结构脚本可能先生成带外键的表再生成被引用的表数据脚本可能在结构脚本之前执行导致 UPDATE 的列还不存在。解决这类比较器一般会有“执行顺序”相关选项我一般把结构脚本和数据脚本拆成两个文件先执行纯结构脚本再执行数据脚本。如果结构脚本内部还有依赖问题可以在目标库里临时禁用外键检查MySQL 下执行 set foreign_key_checks0 再跑脚本跑完改回来。SQL Server 下可以用 ALTER TABLE ... NOCHECK CONSTRAINT ALL 临时绕过。5.5 现象命令行在 CI 里永远返回成功这是整个工具最容易埋雷的地方。控制台程序正常把两个库比较完发现一大票差异但退出码仍然是 0。原因在于“比较完成”和“比较结果是否可接受”是两件事工具默认把差异当成正常结果带过。解决按 4.2 节的做法用 findstr 在日志文件里查“差异数量”关键字或者定义一个规则只要生成的 SQL 文件大小超过阈值就认为存在需要人处理的差异。不要依赖退出码。这个坑如果不处理定时任务跑半年你以为数据库一直很干净实际可能早就漂移得面目全非了。6. 进阶让同步脚本更接近生产级的两个技巧把比较器接入日常流程之后真正拉开差距的是怎么处理脚本细节。第一个技巧是维护一份忽略规则清单。我一般把这类规则和会话文件放在同一个目录当作配置资产管理。比如忽略系统表名前缀、忽略默认值里的大小写差异、忽略索引名称差异这些规则能过滤掉大量噪音。但要注意忽略规则也会把真实差异吞掉所以每次重大版本发布前我会把忽略规则临时全关跑一次全量确认没有“被漏掉的意外”。第二个技巧是构建回滚目录。同步脚本发布到预发环境前我先用比较器反方向比较一次也就是以目标库为基准、源库为目标生成一份“反向脚本”。这个反向脚本就是后悔药正向着齐后如果业务发现异常立刻执行反向脚本回退。我不建议只靠数据库备份做回滚备份恢复时间长而且会覆盖备份点之后新增的数据反向脚本只对你刚才同步过的对象做操作影响面小得多。我现在每个周四下午固定跑一次三套环境的差异检查输出文件名都带日期然后花十分钟扫一眼差异报告。这个习惯已经救过我好几次因为很多数据库漂移不是一次搞坏的而是被一次次临时修复慢慢带偏的。工具能自动找出差异但要不要执行、什么时候执行始终得人确认。希望记录这些配置方式和踩坑经验能让你少走几趟弯路。本文还有配套的精品资源点击获取 
长河君 · 2026/10/10 20:07:44 · 阅读 1.2k Delphi 13.1 安装 Clever Database Comparer：数据库比较与同步 SQL 生成实战
简介这份组件包是数据库比较器Clever Database Comparer v8.2.955.0适用于Delphi 7到13.1 Florence。它主要面向Delphi开发者或数据库管理员用于快速发现两个数据库之间的结构差异并生成或执行同步脚本降低人工维护表、存储过程、视图和触发器时出错的可能。压缩包内共有2000个文件整体大小仅3MB文件类型以Delphi与CBuilder的工程文件为主同时包含大量Pascal/C源代码、窗体和资源文件、SQL脚本以及CHM/HTML帮助文档方便查看工程组织、组件实现和使用方法。该组件还支持灵活设置比较范围比如是否包含存储过程、视图和触发器的比较是否忽略注释或格式差异也能导出同步脚本。借助该工具可形成可控且可重复的同步流程对持续集成或部署尤其有帮助当前已有38人学习下载适合需要维护多个数据库版本或在Delphi项目中完成数据库结构同步的开发人员与数据库管理员选用。1. 为什么我拿到 Delphi 13.1 的 Clever Database Comparer 先不急着点 Compare开发库和测试库分明是同一套脚本发布的可每次上线前抽查总有几处对不上存储过程少了个过滤条件、某张表的字段默认值被顺手改过、数据字典里多出两条没人记得的记录。Delphi 13.1 的 Clever Database Comparer v8.2.955.0支持 D7 到 D13 Florence就是用来治这个黑匣子问题的它把两个数据库之间的结构差异和数据差异扫出来再生成一份可以直接执行的同步 SQL。适合手里管着老版本 Delphi、数据库环境不止一套的开发者或 DBA也适合想把数据库版本校验收进脚本而不是靠人工抽查的团队。这一类工具在数据库比较领域不算冷门但“带 Delphi 控件包分发”和“支持 D7-D13 全部 IDE 版本”这两个特征放在一起就比较少见。下面的内容全部围绕怎么装、怎么配、怎么跑、踩在哪几个坑上展开照着做能少走很多弯路。2. 安装到 Delphi 13.1先处理包版本匹配再谈组件注册2.1 先分清包里哪份文件属于 Delphi 13.1“Florence”解压开 7z 之后第一件事不是双击 install而是看目录结构。我见过太多人拿到这类控件包直接复制旧版本目录里的 bpl 到新 IDE 里结果 IDE 起来就报“package not found”。Clever 的包通常把编译产物按 Delphi 版本拆分D7、D10、D11、D12、D13 会分别对应不同后缀或不同子目录。Delphi 13.1 的代号是 Florence所以你要找的是文件名里带“D13”或“Florence”的那一组文件而不是带“D7”或“D11”的。为什么要分这么细因为不同版本的 Delphi 使用不同的 RTL 包名、编译器和 ABI 规则。Delphi 7 时代的原生 Pascal 代码、字符串内部表示、运行时包依赖体系和你现在用的 13.1 差别非常大跨版本安装一份 bpl轻则 IDE 拒绝加载重则触发内存访问冲突。版本越新这种隔离做得越严格。也就是说标题里那串“D7-13”不是营销话术而是实际存在的多套编译产物。压缩包内常见标记适用 IDE 版本安装位置D7 / D2007 / D2010Delphi 7 到 2010对应 BDS 版本的 bin 与 lib 目录D10.3 / D10.4Rio / SydneyRAD Studio 10.3 / 10.4 对应目录D11 / D12Alexandria / Athens对应版本目录D13 / FlorenceDelphi 13.1当前使用的 13.1 目录我一般会先把压缩包里的文件列表导出看一眼再决定复制哪些不凭文件名猜。这一步省下的时间远远多于点开 7z 的几秒钟。2.2 用批处理把 bpl / dcp / dcu 落到 IDE 目录如果包带了安装程序直接用即可如果没有常见做法是把编译产物手工复制到 RAD Studio 对应的目录并在注册表里登记设计期包。下面这个批处理脚本是通用的安装骨架路径里的方括号部分按你机器上的实际目录替换。echo off set BDSC:\Program Files (x86)\Embarcadero\Studio\[D13版本目录] set BPL%BDS%\bin set DCU%BDS%\lib\Win32\Release rem 请按压缩包里 D13 目录的实际文件扩展名调整 xcopy /Y .\D13\*.bpl %BPL%\ xcopy /Y .\D13\*.dcp %DCU%\ xcopy /Y .\D13\*.dcu %DCU%\ rem 注册设计期包bpl 文件名以包里实际文件为准 reg add HKCU\Software\Embarcadero\BDS\[内部版本号]\Known IDE Packages ^ /v %BPL%\CleverDBComparerD13.bpl /t REG_SZ /d Database Comparer Components /f echo install done. please restart bds.exe这段脚本做了三件事xcopy 把 bpl 复制到 IDE 的 bin 目录让 IDE 启动时能找到运行期包把 dcp 复制到 lib 下的 Win32\Release供编译工程链接使用再把 dcu 一起铺过去避免 IDE 后来重新编译时找不到源文件。最后用 reg add 写入当前用户的已知 IDE 包列表这一步是让组件出现在 Component Install Packages 里的关键。很多安装教程只提复制文件不提注册所以装完总是看不到组件。注意内部版本号不要照抄网上的旧值。查看办法是打开 Delphi 13.1 的 About 对话框或者查注册表 HKCU\Software\Embarcadero\BDS 下有几个数字子键选里面最大的那个。装错了 reg 路径IDE 不认。2.3 装好后怎么验证没白装启动 Delphi 13.1打开 Component Install Packages列表里应该能看到形如“Database Comparer Components”的条目。然后新建一个 VCL Application组件面板上如果多出比较器相关的图标说明设计期包加载成功。这里有个容易绕弯的点如果只是要用 Clever Database Comparer 做数据库差异比较其实不一定非要走 IDE 安装流程。Clever 这个产品比较特殊它既提供了可以嵌入你自己程序的 Delphi 组件也带了独立的可比对的 GUI 工具。很多团队的用法是只在某台机器上装完整包生成会话文件然后让其他人通过命令行调用。你按“控件”安装的同时把独立执行文件也找出来单独放一个目录后面跑批处理、做定时任务时都靠它不依赖 IDE。验证的时候我习惯顺手新建一个空工程拖一个组件到 Form 上编译一下看 IDE 会不会弹“找不到 dcu”这类错误。如果编译通过说明 dcp/dcu 路径也配置对了不只是 bpl 注册成功。3. 跑通第一组数据库比较从连接配置到生成同步 SQL安装只是热身真正决定你能不能把 Clever Database Comparer 用起来的是比较会话的配置。这里不聊 GUI 上每个按钮只讲从连接配置到产出同步 SQL 这条主链路。3.1 连接配置与驱动选择别把比较账号设成管理员第一次启动比较器先新建一个比较会话。以 MySQL 为例需要给出源库和目标库的服务器地址、端口、数据库名、账号、密码。这个步骤看起来简单坑在于权限设计。比较器要读取表结构、视图定义、存储过程源码、触发器它需要的不是 SELECT 权限还包括 SHOW VIEW、PROCEDURE、TRIGGER 这类元数据权限。但是不要图省事直接给管理员账号因为比较器会把目标库当成普通数据源连接万一同步脚本被误执行管理员账号带来的破坏比只读账号大得多。[Connection] SourceTypeMySQL SourceServer192.168.1.21 SourcePort3306 SourceDatabaseshop_dev SourceUsercompare_user SourcePassword****** TargetTypeMySQL TargetServer192.168.1.22 TargetPort3306 TargetDatabaseshop_test TargetUsercompare_user TargetPassword****** [CompareOptions] CompareSchema1 CompareData0 IgnoreRegEx^(sys|information_schema)上面的 INI 是脱敏后的示意结构不同版本的实际键名可能有差异。重点是 CompareSchema 和 CompareData 这两个开关结构比较和数据比较要分开做。第一次跑通建议只开结构比较数据比较放在后面对齐字段之后再开否则两个库的数据本来就不一样差异报告会膨胀到你不想看。端口和 SSL 这类参数也很容易翻车。MySQL 在高版本默认开启 caching_sha2_password旧客户端驱动可能连握手都过不了SQL Server 那边又涉及实例名和 TCP/IP 端口是否启用。遇到连不上的问题先换一个客户端库版本试试不要一开始就怀疑比较器有问题。3.2 对象范围别一张表不剩全选选择比较范围时大多数人习惯“全选”这是比较报告进去出不来的主要原因。系统表、临时表、没有权限读取的对象都会被列进差异里识别为“未知状态”干扰你判断真实差异。我建议按对象类型做一次筛选只保留这次发布真正关心的对象。下面这张表可以作为勾选参照。对象类型比较内容常见差异来源表字段名、类型、长度、默认值、约束、索引有人直接改过测试库没同步脚本自增起点不同视图SELECT 文本、字段列表schema 前缀不同、with check option 差异存储过程/函数参数、返回类型、过程体源码修改后没在开发库升级脚本里登记触发器触发时机、事件、体源码环境手工修复时新增序列/自增当前值、步长、缓存大小数据导入后自增起点漂移比较器一般会把上面的对象打平成一份列表直接勾选即可。我习惯只勾“表和存储过程”先跑一轮其他对象等确认这两个大头干净后再放开做全量。3.3 生成同步脚本前后的检查点差异列表确认之后比较器会生成同步脚本。这个脚本不是拿来就执行的它只是根据两个库的实际差别推算出的“目标对齐动作”。常见情况是它生成一条 ALTER TABLE 把测试库字段改成开发库样式然后生成若干条 UPDATE 把数据也拉齐。如果结构脚本和数据脚本混在一起执行顺序错了就会报字段不存在。-- 同步脚本片段由比较器生成这里是脱敏后的形式 ALTER TABLE shop_test.order_detail ADD COLUMN channel_id INT NULL AFTER pay_at; UPDATE shop_test.sku SET status1 WHERE status0;同步脚本里 ALTER 是结构差异UPDATE 是数据差异。执行时应该先跑结构脚本再跑数据脚本否则 UPDATE 的目标列可能在测试库里还不存在直接报 1054 Unknown column。另外一个检查点凡是数据比较带来的 UPDATE/DELETE都要仔细看 WHERE 条件。比较器依据主键匹配行但如果源库和目标库的主键定义不一致WHERE 子句可能匹配不到任何行或者更危险匹配到错的行。生成脚本前我会把差异列表按对象类型排序扫一遍重点看有没有“索引被重复创建”“字段顺序调整”这类看似差异、实际不影响业务的噪音。Clever 一般会提供忽略规则比如忽略对象限定名差异、忽略默认值里的空白符。把噪音过滤掉再把脚本交给 DBA这才是这个工具的正确用法。4. 命令行与 CI把数据库差异检查变成自动化巡检手工在 GUI 里点比较能解决临时问题但数据库一致性不是一次性工作——开发库每周更新测试库每天有人乱动新同事可能直接在测试环境改表结构。这时候就需要把 Clever Database Comparer 的比价能力接进命令行做成可重复执行的巡检项。4.1 为什么不直接用 GUI 一次一次点GUI 适合分析和确认不适合重复劳动。假设你有三套环境每套环境要对比结构、数据、索引手动点一遍要 20 分钟而且中间很容易选错对象范围。命令行模式可以把所有参数固化到一个会话文件里以后每次运行都是同一套规则结果也便于留存。用命令行之前先确认控制台程序的真实参数名。不同版本对命令行的支持方式不一样但通常都支持把一个会话文件传进去再指定输出脚本和日志文件。先用帮助命令看一下实际参数名。DatabaseComparerConsole.exe /? help.txt注意这里用 /in /out /log 其实是一种常见约定不一定和你手头版本完全一致。运行一次 /? 或 /help看到真实参数名后再写脚本别硬套网上流传的老版本参数。4.2 一个能直接排进任务计划的批处理我一般把比较会话做成独立文件放在和批处理同级的 sessions 目录下名称就叫 compare_job.cdc 或类似后缀。批处理里只需要做三件事接受会话文件路径、调用控制台程序、根据结果决定是否让任务失败。echo off set SESSION%1 if %SESSION% set SESSIONcompare_job.cdc set TODAY%date:~0,4%%date:~5,2%%date:~8,2% DatabaseComparerConsole.exe /in:%SESSION% /out:sync_%TODAY%.sql /log:log_%TODAY%.txt if errorlevel 1 goto :fail findstr /C:差异数量 /C:Conflict log_%TODAY%.txt nul || goto :report :fail echo job failed or differences found exit /b 1 :report echo compare done, differences detected这段脚本里有一个很关键的设计if errorlevel 1 是留给控制台程序内部错误的比如数据库连不上、会话文件读不出来。但大多数比较器在“正常完成比较发现差异”时退出码往往是 0因为它把差异当成正常业务结果。所以你还需要第二步用 findstr 去日志里查“差异数量”或“Conflict”这样的关键字发现存在差异时主动把退出码置为 1。这一步是给定时任务和 CI 用的没有它你的任务永远“成功”等于白跑。日志文件名带上日期是方便事后追溯。我还会在批处理末尾加一条“复制 sync_%TODAY%.sql 到报告目录”的操作把每次生成的脚本归档。这样即使一个月后要查某次发布前测试库和开发库差了什么也能凭日志还原现场。4.3 接进 GitLab CI 的最小配置如果你所在团队用 GitLab CI 或Jenkins可以在流水线里加一个数据库检查任务。下面是一个 GitLab CI 的片段示例核心是调用上一节的批处理并把生成物设为 artifacts。database-check: stage: test script: - cmd /c scripts\db_compare.bat scripts\compare_job.cdc artifacts: paths: - scripts\sync_*.sql - scripts\log_*.txt expire_in: 2 weeks when: always这里有两个习惯值得提。一是 artifacts 里保留同步 SQL 和日志而不是只保留“通过/失败”状态。DBA 审核时可以直接打开 SQL 文件看差异细节不必重新跑一遍。二是 expire_in 设成两周既留足追溯周期又不占太多流水线存储。另一个习惯是不要在 CI 里直接执行同步脚本。比较器生成的 SQL 只是对齐两个库的手段不代表这个动作被业务允许自动执行到生产库上属于高风险操作一般建议 CI 只做“生成脚本和报告”执行留给人工确认。命令行接到 CI 之后还有一个附加价值每次合入代码前可以强制对比最新开发库和稳定测试库如果结构差异超出预期流水线直接变红。这在多人协作、且有人绕过升级脚本直接改数据库的团队里等于多了一道自动拦截。5. 避坑Clever Database Comparer 用得越深越容易忽略的几个坑工具本身不复杂复杂的是数据库环境。这一章按“现象 → 原因 → 解决”的顺序写五条踩坑记录都是我能明确复现的典型问题。5.1 现象装完包 IDE 启动报 package not found装完后重启 Delphi 13.1IDE 直接弹窗说找不到某个 bpl甚至 IDE 起都没起来。原因是把包复制到了错误的位置或者复制了旧版本目录下的 bpl。尤其是在同一台机器上装了多个 Delphi 版本时bin 目录路径容易搞混系统会把文件复制到 D7 或 D11 的目录里D13 启动时自然找不到。解决卸载已注册的包把错误目录下的 bpl/dcp 清干净重新按 2.2 节脚本执行并确认 xcopy 的目标路径确实是 Studio[D13版本目录]\bin。重复出问题时直接在 reg 编辑器里搜“Database Comparer”找到后删掉再装就能绕开注册表残留。5.2 现象视图和存储过程几乎全部显示不一致两个库明明没人改过这些对象可差异列表里几乎每条视图、每个存储过程都被标红。我遇到过的最常见原因是连接账号缺少查看对象定义的权限。MySQL 下 SHOW VIEW 权限缺失会让工具拿到空文本SQL Server 下缺少 VIEW DEFINITION 权限也会有类似现象。另一个原因是字符集排序规则不同两个库的校对规则不一致导致工具比较源码文本时认为每个字符都不同。解决给比较账号单独授予元数据读取权限例如 MySQL 下 grant show view on 库名.* to 比较账号同时在比较选项里勾选“忽略排序规则差异”或“忽略对象限定名”。这两个选项别一起开先开一个看效果避免把真实差异也过滤掉。5.3 现象表结构一致数据比较结果却冒出大量差异这类问题最容易让人怀疑工具是不是坏了。实际上bit 字段、timestamp 字段、计算列都会造成误报。bit 在源库返回 true/false目标库返回 0/1timestamp 在行更新时可能自动变化计算列根本不该纳入数据比较但默认配置可能把它算进去。解决进入数据比较的列设置把计算列、自动时间戳、行版本列排除再重新比较。对 bit 类型的差异如果业务上确实允许 0/1 和 true/false 等价可以用比较器的值映射功能把它们归一化。处理完成后再跑一轮误报数量会大幅下降。5.4 现象生成的同步脚本执行到一半失败把同步脚本拿到目标库执行跑到中间报外键冲突或字段不存在。原因通常是对象执行顺序不对。结构脚本可能先生成带外键的表再生成被引用的表数据脚本可能在结构脚本之前执行导致 UPDATE 的列还不存在。解决这类比较器一般会有“执行顺序”相关选项我一般把结构脚本和数据脚本拆成两个文件先执行纯结构脚本再执行数据脚本。如果结构脚本内部还有依赖问题可以在目标库里临时禁用外键检查MySQL 下执行 set foreign_key_checks0 再跑脚本跑完改回来。SQL Server 下可以用 ALTER TABLE ... NOCHECK CONSTRAINT ALL 临时绕过。5.5 现象命令行在 CI 里永远返回成功这是整个工具最容易埋雷的地方。控制台程序正常把两个库比较完发现一大票差异但退出码仍然是 0。原因在于“比较完成”和“比较结果是否可接受”是两件事工具默认把差异当成正常结果带过。解决按 4.2 节的做法用 findstr 在日志文件里查“差异数量”关键字或者定义一个规则只要生成的 SQL 文件大小超过阈值就认为存在需要人处理的差异。不要依赖退出码。这个坑如果不处理定时任务跑半年你以为数据库一直很干净实际可能早就漂移得面目全非了。6. 进阶让同步脚本更接近生产级的两个技巧把比较器接入日常流程之后真正拉开差距的是怎么处理脚本细节。第一个技巧是维护一份忽略规则清单。我一般把这类规则和会话文件放在同一个目录当作配置资产管理。比如忽略系统表名前缀、忽略默认值里的大小写差异、忽略索引名称差异这些规则能过滤掉大量噪音。但要注意忽略规则也会把真实差异吞掉所以每次重大版本发布前我会把忽略规则临时全关跑一次全量确认没有“被漏掉的意外”。第二个技巧是构建回滚目录。同步脚本发布到预发环境前我先用比较器反方向比较一次也就是以目标库为基准、源库为目标生成一份“反向脚本”。这个反向脚本就是后悔药正向着齐后如果业务发现异常立刻执行反向脚本回退。我不建议只靠数据库备份做回滚备份恢复时间长而且会覆盖备份点之后新增的数据反向脚本只对你刚才同步过的对象做操作影响面小得多。我现在每个周四下午固定跑一次三套环境的差异检查输出文件名都带日期然后花十分钟扫一眼差异报告。这个习惯已经救过我好几次因为很多数据库漂移不是一次搞坏的而是被一次次临时修复慢慢带偏的。工具能自动找出差异但要不要执行、什么时候执行始终得人确认。希望记录这些配置方式和踩坑经验能让你少走几趟弯路。本文还有配套的精品资源点击获取