SQL Server使用sp_rename重命名约束注意事项

在SQL Server中，我们可以使用sp_name这个系统存储过程重命名数据库中对象的名称。 此对象可以是表、 索引、 列、 别名，约束等数据类型（具体可以参考官方文档）。上周在使用这个函数重构数据库中约束的时候，遇到了下面错误，如下所示：

 

 

USE AdventureWorks2014;

GO

sp_rename 'ErrorLog.DF_ErrorLog_ErrorTime', 'DF_ErrorLog_ErrorTime_old';

GO

 

 

Msg 15225, Level 11, State 1, Procedure sp_rename, Line 437

No item by the name of 'ErrorLog.DF_ErrorLog_ErrorTime' could be found in the current database 'AdventureWorks2014', given that @itemtype was input as '(null)'.

 

 

 

 

 

注意：重命名约束时，不能在约束前面加上表对象。正确的方式为：前面不要加上表名对象，如下所示

 

 

USE AdventureWorks2014;

GO

sp_rename 'DF_ErrorLog_ErrorTime', 'DF_ErrorLog_ErrorTime_old';

GO

 

 

对于默认约束、外键约束、检查约束的重命名，都是这种规则。但是对于主键约束，下面两种方式都OK，这个是非常纳闷的一件事情。

 

 

USE AdventureWorks2014;

GO

sp_rename 'PK_ErrorLog_ErrorLogID', 'PK_ErrorLog_ErrorLogID_OLD'

 

 

USE AdventureWorks2014;

GO

sp_rename  'ErrorLog.PK_ErrorLog_ErrorLogID','PK_ErrorLog_ErrorLogID_OLD'

 

 

 

另外，对于HumanResources.Employee这个表，如果要重命名约束CK_Employee_BirthDate，如果使用下面这种方式也会遇到这种错误：

 

sp_rename 'CK_Employee_BirthDate', 'CK_BirthDate'; 

GO 

 

 

正确的方式为：

 

-- Rename a check constraint. 

sp_rename 'HumanResources.CK_Employee_BirthDate', 'CK_BirthDate'; 

GO 

 

 

也就是说必须加上对应约束的schema，否则就会提示找不到这个对象（因为约束位于HumanResources下面）。至于为什么约束可以不加表对象名称，那是因为在数据库中，约束的命名是全局唯一的。所以不需要加上表名。其实官方资料已经详细说了：

 

 

 

[ @objname = ] 'object_name'

用户对象或数据类型的当前限定或非限定名称。 

如果要重命名的对象是表中的列object_name必须在窗体table.column或schema.table.column 中使用。 如果要重命名的对象的索引object_name必须在窗体table.index或schema.table.index。 如果要重命名的对象是一个约束object_name必须在窗体schema.constraint。

 

 

    -- item type determined?

    if (@objtype is null)

    begin

        COMMIT TRANSACTION

        raiserror(15225,-1,-1,@objname, @CurrentDb, @objtypeIN)

        return 1

    end

 

 

 

参考资料：

 

 

https://docs.microsoft.com/zh-cn/sql/relational-databases/system-stored-procedures/sp-rename-transact-sql?view=sql-server-2017