★ FEATURED ARTICLE 简介这是一套基于C#开发的SQL Server数据库脚本导出与导入工具面向.NET开发者、DBA及数据库运维人员解决日常开发中频繁迁移表结构、存储过程、视图等数据库对象时手动操作繁琐、易出错的问题。工具功能对标SQL Server 2014 Management Studio的“生成脚本”向导支持批量导出完整数据库或指定对象的可执行SQL脚本并实现安全、可控的脚本回滚式导入。压缩包共66个文件含10个核心C#源码如Program.cs、SqlHelper.cs、frmMain.cs、9个运行依赖DLL、8个示例SQL脚本、4个可执行EXE文件及配套配置App.config、资源文件.resx和Visual Studio项目文件.sln、.csproj结构完整开箱即用。资源包仅2.16MB轻量高效已有1493人学习下载适合快速集成到本地开发环境、理解SQL Server元数据提取逻辑或作为数据库自动化部署的轻量级脚本管理方案。1. SQL Server 脚本导出导入不是备份替代品它解决的是结构可复现、跨环境部署和版本可控这三件事你有没有遇到过这样的场景开发环境改完存储过程测试环境没同步上线前才发现逻辑不一致或者新同事拉下代码仓库后本地数据库空空如也手动建表建索引建约束一上午就没了又或者客户现场要求“把当前库的全部对象定义导出来我们审计用”你打开 SSMS 点右键 → 生成脚本 → 下一页 → 下一页 → 勾到手抖最后导出一个 200MB 的 .sql 文件连注释都带乱码——这个SQLSERVER脚本导出导入.zip就是为这类真实痛点设计的轻量级工程化工具包。它不替代BACKUP DATABASE也不做高可用复制而是专注把数据库的结构定义DDL拆成可读、可审、可 Git 管理、可 CI/CD 自动执行的纯文本脚本。核心能力包括自动识别依赖顺序比如先建表再建外键、过滤系统对象与临时对象、支持按 schema / object type / name pattern 精确筛选、导出结果自带IF NOT EXISTS安全包裹、导入时自动跳过已存在对象或强制重建。适合 DBA 做基线快照、开发团队做数据库即代码Database-as-Code、运维人员做灰度环境初始化。它用 C# 实现不依赖 SQL Server Management Studio命令行即可驱动Windows/Linux通过 dotnet runtime双平台可用。2. 导出脚本从连接字符串到可提交的 .sql 文件每一步都可控2.1 连接配置与目标范围定义为什么不能只写服务器名导出的第一步不是点按钮而是明确「导什么」和「从哪来」。这个工具包不接受模糊输入所有连接参数必须显式声明。常见错误是只填Server192.168.1.100结果报错Login failed for user —— 因为它默认走 Windows 身份验证而你的目标实例可能禁用了该模式。正确做法是构造完整连接字符串并通过-c参数传入dotnet SqlScriptExporter.dll -c Server192.168.1.100;DatabaseMyAppDB;User Idsa;PasswordStrongPass123!;EncryptFalse;TrustServerCertificateTrue;提示EncryptFalse和TrustServerCertificateTrue是本地测试或内网环境的合理组合生产环境必须启用加密并配置有效证书否则连接会被拒绝。Database参数指定源数据库不可省略若想导出整个实例的所有用户数据库需配合-all-dbs参数见后文。2.2 对象类型与筛选策略不是所有对象都该进 Git 仓库盲目导出全部对象包括sysdiagrams、queue_messages、MSreplication_options等系统表会导致脚本体积膨胀、可读性下降、Git Diff 失效。本工具提供三级筛选机制层级一对象大类必选用-t参数指定支持Table,View,StoredProcedure,Function,Trigger,Index,Constraint,Schema,User,Role,Permission。可多次使用例如-t Table -t View -t StoredProcedure层级二Schema 过滤推荐用-s指定 schema 名如-s dbo或-s Sales。若需排除sys和INFORMATION_SCHEMA无需显式写工具默认跳过。层级三名称正则匹配精准控制用-n后接 .NET 风格正则表达式例如只导出以usp_开头的存储过程-n ^usp_.*或排除所有测试用对象命名含_test或_dev-n ^(?!.*(_test|_dev)).*$实际项目中我一般会分两轮导出第一轮-t Table -t Constraint -t Index -s dbo得到核心数据结构第二轮-t StoredProcedure -t Function -n ^usp_[a-zA-Z0-9_]{3,}$得到业务逻辑层。这样 Git 提交历史清晰Code Review 有焦点。2.3 输出格式与安全包装为什么IF NOT EXISTS不是可选项导出的 SQL 脚本若直接在目标库执行极易因对象已存在而中断。本工具默认开启--wrap-if-not-exists等价于-w对每个CREATE语句自动包裹IF NOT EXISTS (SELECT * FROM sys.objects WHERE object_id OBJECT_ID(N[dbo].[Users]) AND type in (NU)) BEGIN CREATE TABLE [dbo].[Users]( [Id] [int] IDENTITY(1,1) NOT NULL, [Name] [nvarchar](50) NOT NULL, CONSTRAINT [PK_Users] PRIMARY KEY CLUSTERED ([Id] ASC) ) ON [PRIMARY] END参数说明-w开启包裹-W大写则强制使用DROP CREATE模式慎用仅限开发环境重置。若需关闭包裹如导出用于文档归档加--no-wrap。另外--include-dependencies简写-d会自动分析对象依赖关系确保Table在ForeignKey之前导出Schema在Table之前导出——这是避免“对象不存在”错误的关键逻辑不是简单排序。2.4 批量导出多库与自动化集成一个命令生成 12 个库的脚本当管理多个租户库如Tenant_A,Tenant_B…或微服务拆分后的分库OrderDB,UserDB,PaymentDB手动逐个导出效率极低。工具支持-all-dbs参数但需配合-exclude-dbs排除系统库和临时库dotnet SqlScriptExporter.dll -c Serverlocalhost;User Idsa;Password123; \ -all-dbs \ -exclude-dbs master,model,msdb,tempdb,ReportServer,ReportServerTempDB \ -t Table -t View -t StoredProcedure \ -o ./scripts/此命令会在./scripts/目录下生成Tenant_A.sql,Tenant_B.sql等独立文件。更进一步可结合 PowerShell 脚本实现每日凌晨自动导出并推送到 Git# export-daily.ps1 $timestamp Get-Date -Format yyyyMMdd_HHmm $exportDir ./daily-backup/$timestamp New-Item -ItemType Directory -Path $exportDir -Force dotnet SqlScriptExporter.dll -c $env:SQL_CONN_STR -all-dbs -exclude-dbs master,model,msdb -t Table -o $exportDir git add $exportDir git commit -m Auto-export: $timestamp git push关键点在于$env:SQL_CONN_STR应设为环境变量避免密码硬编码-o指定输出目录工具会自动按库名创建子目录如./daily-backup/20240520_0200/Tenant_A/Tables.sql结构清晰可追溯。3. 导入脚本从 .sql 文件到目标库如何避免“执行一半失败”的灾难3.1 导入前检查为什么必须先运行--dry-run导入操作具有破坏性尤其开启-W强制重建时绝不能跳过预检。--dry-run参数会模拟执行全过程连接目标库、解析 SQL 文件、检查语法、验证对象依赖、列出将被执行的语句但不真正执行任何 DDL。典型输出[DRY RUN] Connected to server 192.168.1.100, database TargetDB [DRY RUN] Parsed 1 file: ./scripts/MyAppDB.sql (327 lines) [DRY RUN] Will execute 42 statements: - CREATE SCHEMA [dbo] (skipped: exists) - CREATE TABLE [dbo].[Users] (will create) - CREATE INDEX [IX_Users_Email] ON [dbo].[Users] (will create) - CREATE PROCEDURE [dbo].[usp_GetUserById] (will create) - ... (truncated) [DRY RUN] All dependencies resolved. No syntax errors.注意若--dry-run报错Could not resolve dependency: [dbo].[Orders] referenced by [dbo].[usp_GetOrderDetails]说明脚本中Orders表定义缺失或顺序错误——此时应回溯导出步骤确认是否漏选了Table类型或--include-dependencies未启用。3.2 执行模式选择--mode safe与--mode force的本质区别工具提供两种执行策略对应不同场景--mode safe默认对每个CREATE语句加IF NOT EXISTS判断若对象已存在则跳过。适用于增量部署、CI/CD 流水线中的“确保环境一致”阶段。优点是安全缺点是无法更新已有对象如修改字段长度。--mode force-f先DROP再CREATE强制覆盖。适用于开发环境重置、测试库重建。警告此模式下若脚本包含CREATE DATABASE会直接删除并重建整个库生产环境严禁使用。实际项目中我严格区分流水线部署用--mode safe配合 Git 分支策略如main分支对应生产结构develop对应开发结构本地开发重置用--mode force但必须限定在LocalDB或容器实例中且命令中显式写死DatabaseMyAppDB_Local。3.3 错误处理与事务控制单文件内是否回滚SQL Server 的 DDL 语句如CREATE TABLE默认在隐式事务中执行但跨语句不保证原子性。本工具在导入时采用以下策略单个.sql文件内的所有语句在一个SqlConnection中顺序执行若某条语句失败如CREATE INDEX因字段不存在报错后续语句不会自动跳过而是继续执行除非加--stop-on-error工具不开启显式事务BEGIN TRAN因为CREATE DATABASE等语句不允许在事务中执行强行包裹会导致Transaction context in use by another session错误。因此正确做法是使用--stop-on-error让失败立即终止推荐将大型脚本按逻辑拆分如01_schemas.sql,02_tables.sql,03_indexes.sql每个文件独立导入关键路径如主键、外键放在靠前文件依赖项如视图、存储过程放后。# 安全导入流程示例 dotnet SqlScriptImporter.dll -c Serverprod-sql;DatabaseMyAppDB;... \ --mode safe \ --stop-on-error \ -f ./scripts/01_schemas.sql \ -f ./scripts/02_tables.sql \ -f ./scripts/03_constraints.sql3.4 权限与上下文为什么sa权限不是万能钥匙即使连接字符串用sa导入仍可能失败原因在于数据库上下文权限。例如脚本中含CREATE SCHEMA [Sales]但sa用户在目标库中未被授予CREATE SCHEMA权限默认不授CREATE USER [app_user]要求ALTER ANY DATABASE权限GRANT SELECT ON [dbo].[Users] TO [app_user]要求执行者对[dbo].[Users]有TAKE OWNERSHIP或CONTROL权限。解决方案不是提权sa而是最小权限原则创建专用部署账号deploy_user在目标库执行CREATE USER [deploy_user] FOR LOGIN [deploy_user]; ALTER ROLE [db_owner] ADD MEMBER [deploy_user]; -- 仅限开发/测试库 -- 生产库用更细粒度 GRANT CREATE SCHEMA TO [deploy_user]; GRANT CREATE TABLE TO [deploy_user]; GRANT ALTER ANY ASSEMBLY TO [deploy_user]; -- 若脚本含 CLR连接字符串改用-c Server...;User Iddeploy_user;Password...。这样既保障执行又符合安全审计要求。4. 避坑指南五个血泪经验换来的高频问题排查清单4.1 现象导出脚本中中文列名/注释显示为?????导入时报错Incorrect syntax near ?原因SQL Server 默认使用SQL_Latin1_General_CP1_CI_AS排序规则对 Unicode 字符支持不完整而工具导出时若未指定编码Windows 控制台默认GBK导致 UTF-8 写入的文件被误读。解决强制指定输出编码为 UTF-8 with BOM兼容性最好dotnet SqlScriptExporter.dll -c ... -t Table -o ./scripts/ --encoding utf-8-bom同时SSMS 或 VS Code 打开脚本时确认右下角编码显示为UTF-8 with BOM而非UTF-8或GBK。4.2 现象导入时卡在CREATE PROCEDURECPU 占用 100%数分钟后超时原因存储过程中含WAITFOR DELAY 00:05:00或WHILE (11) BEGIN ... END等无限等待逻辑工具将其视为普通 T-SQL 执行无超时机制。解决导出时用-n过滤掉测试用存储过程如命名含_test,_debug或导入前用文本工具预处理脚本删除可疑语句。永远不要导出含WAITFOR或xp_cmdshell的生产脚本。4.3 现象--include-dependencies启用后导出的Table脚本中FOREIGN KEY约束未生成WITH CHECK导致导入后约束不生效原因SQL Server 系统视图sys.foreign_keys中is_not_trusted1表示约束未验证可能是WITH NOCHECK创建工具如实导出但NO CHECK约束在导入后处于“未启用”状态不阻止非法数据插入。解决导出后用正则批量替换VS Code 支持查找(CONSTRAINT \[.*?\] FOREIGN KEY.*?REFERENCES \[.*?\]\.\[.*?\]) WITH NOCHECK替换$1 WITH CHECK或在导入前执行ALTER TABLE [dbo].[ChildTable] WITH CHECK CHECK CONSTRAINT [FK_Child_Parent]启用。4.4 现象-all-dbs导出时某个库如ArchiveDB报错The database is not accessible整个导出中断原因工具默认串行处理一个库失败即退出。而ArchiveDB可能处于RESTORING状态或权限不足。解决加--continue-on-error参数失败库记录日志并跳过继续处理其余库dotnet SqlScriptExporter.dll -c ... -all-dbs --continue-on-error -o ./backup/日志中会明确写出Skipped database ArchiveDB: The database is not accessible便于事后单独排查。4.5 现象导入CREATE FUNCTION时失败错误CREATE FUNCTIONmust be the first statement in a query batch原因工具导出的函数脚本中CREATE FUNCTION前有GO批处理分隔符但某些旧版 SQL Server如 2008 R2或特定连接模式下GO不被识别。解决导出时禁用GO分隔符改用--no-godotnet SqlScriptExporter.dll -c ... -t Function --no-go此时函数定义会以CREATE OR ALTER FUNCTION形式导出SQL Server 2016兼容性更好若目标库版本低于 2016则需手动将CREATE OR ALTER替换为IF NOT EXISTS...CREATE。5. 进阶技巧用脚本校验结构一致性把“人工比对”变成自动化门禁5.1 生成结构哈希值三行命令判断两个库是否完全一致最朴素的“一致性校验”是比对导出的 SQL 文件内容但文件体积大、格式差异空格、换行干扰多。更可靠的方式是提取关键元数据生成哈希。本工具内置--hash模式不生成脚本只输出各对象的 SHA256 校验值# 导出源库哈希清单 dotnet SqlScriptExporter.dll -c Serversrc;DatabaseProdDB;... \ -t Table -t View -t StoredProcedure \ --hash \ -o ./hashes/prod.json # 导出目标库哈希清单 dotnet SqlScriptExporter.dll -c Servertgt;DatabaseStagingDB;... \ -t Table -t View -t StoredProcedure \ --hash \ -o ./hashes/staging.json生成的prod.json结构如下{ Tables: [ { Name: dbo.Users, Hash: a1b2c3d4e5f6... }, { Name: dbo.Orders, Hash: x9y8z7w6v5... } ], Views: [ /* ... */ ], StoredProcedures: [ /* ... */ ] }然后用 PowerShell 快速比对$prod Get-Content ./hashes/prod.json | ConvertFrom-Json $stg Get-Content ./hashes/staging.json | ConvertFrom-Json $prod.Tables | ForEach-Object { $tgt $stg.Tables | Where-Object { $_.Name -eq $_.Name } if (-not $tgt) { Write-Warning Missing table: $($_.Name) } elseif ($_.Hash -ne $tgt.Hash) { Write-Warning Hash mismatch: $($_.Name) } }为什么不用diff直接比脚本因为CREATE TABLE中ON [PRIMARY]与ON [FG_Data]的文件组差异、索引FILLFACTOR的微小调整都会导致哈希不同但业务上可能完全等价。而--hash模式默认忽略这些非功能属性可通过--hash-include-filegroup显式开启聚焦在列定义、约束逻辑、T-SQL 主体等核心差异上。5.2 构建数据库变更流水线从 Git Commit 到自动部署真正的 Database-as-Code 不止于导出而在于将结构变更纳入软件交付闭环。以下是某公司落地的简化流水线步骤工具/命令说明1. 开发者提交 DDLALTER TABLE [dbo].[Users] ADD [Phone] NVARCHAR(20);在database/changes/20240520_add_phone.sql中编写不直接执行2. CI 触发校验dotnet SqlScriptExporter.dll -c $SRC_CONN -t Table -s dbo --hash ./tmp/src.hashdotnet SqlScriptExporter.dll -c $TGT_CONN -t Table -s dbo --hash ./tmp/tgt.hashCompare-Object (gc ./tmp/src.hash) (gc ./tmp/tgt.hash)若哈希不同说明目标库未应用变更流水线失败并告警3. 人工审批后部署dotnet SqlScriptImporter.dll -c $TGT_CONN --mode safe -f ./database/changes/20240520_add_phone.sql审批通过后执行导入--mode safe保证幂等4. 部署后验证SELECT COUNT(*) FROM sys.columns WHERE object_id OBJECT_ID(dbo.Users) AND name Phone查询元数据确认字段存在关键设计点所有 DDL 变更必须以.sql文件形式存入 Git禁止直接在生产库执行ALTERCI 校验用--hash而非diff避免格式干扰导入命令固定为--mode safe杜绝意外覆盖。5.3 处理特殊对象全文索引、空间数据、内存优化表的导出要点并非所有 SQL Server 对象都能被通用脚本完美覆盖。针对三类高频特殊对象需额外配置对象类型导出注意事项示例参数全文索引Full-Text Index默认不导出需显式加-t FullTextCatalog -t FullTextIndex且必须确保源库已启用全文搜索sp_fulltext_database enable-t FullTextCatalog -t FullTextIndex --include-dependencies空间数据类型geography, geometry导出时若含CREATE SPATIAL INDEX需确认目标库spatial_results数据库选项已启用否则导入报错Spatial results are not enabled-t SpatialIndex --sql-version 2019指定版本以启用新语法内存优化表In-Memory OLTP必须加--in-memory参数否则CREATE TABLE ... WITH (MEMORY_OPTIMIZEDON)会被忽略且目标库需有MEMORY_OPTIMIZED_DATA文件组-t Table --in-memory --filegroup modfg血泪经验某次上线前DBA 忘记导出全文目录导致搜索功能失效。从那以后我每次导出前都强制执行SELECT * FROM sys.fulltext_catalogs检查是否存在再决定是否加-t FullTextCatalog。希望帮到你。本文还有配套的精品资源点击获取
阅读完成 · 觉得有帮助？
