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