sp_renamedb (Transact-SQL)
适用于: SQL Server Azure SQL 托管实例
更改数据库的名称。
重要
在 SQL Server的未来版本中将删除此功能。 请避免在新的开发工作中使用该功能,并着手修改当前还在使用该功能的应用程序。 请改用 ALTER DATABASE MODIFY NAME
。 有关详细信息,请参阅 ALTER DATABASE。
语法
sp_renamedb
[ @dbname = ] N'dbname'
, [ @newname = ] N'newname'
[ ; ]
参数
[ @dbname = ] N'dbname'
数据库的当前名称。 @dbname为 sysname,无默认值。
[ @newname = ] N'newname'
数据库的新名称。 @newname为 sysname,无默认值。 @newname必须遵循标识符规则。
返回代码值
0
(成功)或非零数(失败)。
注解
无法重命名在活动异地复制关系中配置的 Azure SQL 数据库。
权限
需要 sysadmin 或 dbcreator 固定服务器角色的成员身份。
示例
以下示例将创建 Accounting
数据库,然后将该数据库的名称更改为 Financial
。 然后,查询 sys.databases
目录视图以确认数据库的新名称。
USE master;
GO
CREATE DATABASE Accounting;
GO
EXEC sp_renamedb N'Accounting', N'Financial';
GO
SELECT name,
database_id,
create_date
FROM sys.databases
WHERE name = N'Financial';
GO