sp_renamedb (Transact-SQL)

更改数据库的名称。

重要说明重要提示

后续版本的 Microsoft SQL Server 将删除该功能。 请避免在新的开发工作中使用该功能,并着手修改当前还在使用该功能的应用程序。请改用 ALTER DATABASE MODIFY NAME。有关详细信息,请参阅 ALTER DATABASE (Transact-SQL)

主题链接图标Transact-SQL 语法约定

语法

sp_renamedb [ @dbname = ] 'old_name' , [ @newname = ] 'new_name'

参数

  • [ @dbname=] 'old_name'
    数据库的当前名称。old_name 的数据类型为 sysname,无默认值。

  • [ @newname=] 'new_name'
    数据库的新名称。new_name 必须遵循有关标识符的规则。new_name 的数据类型为 sysname,无默认值。

返回代码值

0(成功)或非零数字(失败)

权限

要求具有 sysadmindbcreator 固定服务器角色的成员资格。

示例

以下示例将创建 Accounting 数据库,然后将该数据库的名称更改为 Financial。然后,查询 sys.databases 目录视图以确认数据库的新名称。

USE master;
GO
CREATE DATABASE Accounting;
GO
EXEC sp_renamedb N'Accounting', N'Financial';
GO
SELECT name, database_id, modified_date
FROM sys.databases
WHERE name = N'Financial';
GO