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 (успешное завершение) или ненулевое значение (неуспешное завершение)

Разрешения

Требует членства в предопределенных ролях сервера 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