如何使用SqlPackage修改列长度而不重建SQL表

问题场景 #

我有一个SSDT SQL项目，表定义如下：

CREATE TABLE [dbo].[MyTable] (
  [Name] VARCHAR(50) NOT NULL,
  ...,
  CONSTRAINT [PK_MyTable] PRIMARY KEY CLUSTERED ([Name] ASC)
)

需要把[Name]列的长度扩展至100字符，手动执行以下ALTER语句就能轻松完成：

ALTER TABLE [MyTABLE]
ALTER COLUMN [Name] VARCHAR(100) NOT NULL

但部署管道中的SqlPackage/DacFX却坚持要删除并重建表来实现这个变更，有没有办法让它识别到可以用简单的ALTER TABLE语句完成，而非重建表？

解决方法 #

• 开启SSDT项目的不安全增量部署权限
  打开SSDT项目属性，切换到“部署”选项卡，勾选允许不安全的增量部署。因为修改主键列长度默认被DacFX判定为“高风险”操作，必须开启这个选项，它才会尝试用ALTER语句而非重建表来完成变更。

• 通过发布配置或命令行强制增量变更
  如果用SqlPackage.exe命令行部署，有两种方式：

  1. 在发布配置文件（.pubxml）中添加配置：

     <PropertyGroup>
       <AllowUnsafeIncrementalDeployment>True</AllowUnsafeIncrementalDeployment>
     </PropertyGroup>
     

  2. 直接在命令行参数里追加：

     /p:AllowUnsafeIncrementalDeployment=True
     

• 确认目标SQL Server版本兼容性
  确保目标SQL Server是2012及以上版本——这些版本支持在线修改主键列长度，旧版本可能会让DacFX因为兼容性限制选择重建表。

• 排查列的依赖对象
  检查[Name]列是否被外键、触发器、计算列等对象引用。如果这些依赖导致DacFX认为无法安全执行ALTER操作，可以先临时移除依赖，完成列长度修改后再重新添加；或者确认这些依赖不会影响ALTER语句的正常执行。

内容的提问来源于stack exchange，提问作者MarkMpn