sp_renamedb (Transact-SQL)

Статья
06/18/2013

Изменяет имя базы данных.

Важно!
В будущей версии Microsoft SQL Server этот компонент будет удален. Избегайте использования этого компонента в новых разработках и запланируйте изменение существующих приложений, в которых он применяется. Вместо этого следует использовать инструкцию ALTER DATABASE MODIFY NAME. Дополнительные сведения см. в разделе ALTER DATABASE (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 (успешное завершение) или ненулевое значение (неуспешное завершение)

Разрешения

Требует членства в предопределенных ролях сервера 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, modified_date
FROM sys.databases
WHERE name = N'Financial';
GO