Tips & Troubleshooting — SQL Server Compare
Command Line and Reports
- Run
DBLenseCompare.exe compare --helpfor the full option list.compare,--compare, or--clistarts command-line mode and skips the main window - The report format is the
--reportextension:.html,.xlsx,.xml,.pdf, or.csv - Data compare from the command line uses row counts unless you pass
--depth hashor--depth full --config-scope instancedoes not need database names.databasedoes- Scripts Folder writes files for you to commit. Compare does not run
git, push, or sign in to a host - Open the app once on a build machine before a pipeline run, so a trial or license is already saved
Current Limitations
- A modified table scripts as
ALTER TABLEfor added and changed columns. Dropping a column stays a comment so it is not applied by accident. Modules get CREATE or ALTER - Security principals, permissions, synonyms, sequences, CLR, partition schemes, and filegroups are not compared yet
- Data compare does not remap differently named tables; pairs must share
schema.table - Scripts are generated for review — Compare does not execute them against the target automatically
System Requirements
| Component | Requirement |
|---|---|
| OS | Windows 10/11 or Windows Server 2016+ |
| Runtime | .NET 8.0 (or self-contained package) |
| SQL Server | SQL Server 2016+ |
| Azure | Azure SQL Database, Azure SQL Managed Instance |
| Permissions | Read access to sys catalogs / INFORMATION_SCHEMA / sys.sql_modules; data compare needs SELECT on compared tables |
| Installation | None — single portable .exe |