sp_renamedb (Transact-SQL)

  • Статья

Область применения: SQL Server Управляемый экземпляр SQL Azure

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

Внимание

Эта функция будет удалена в будущей версии SQL Server. Избегайте использования этого компонента в новых разработках и запланируйте изменение существующих приложений, в которых он применяется. Вместо этого используйте ALTER DATABASE MODIFY NAME. Дополнительные сведения см. в статье Параметры инструкции ALTER DATABASE для файлов и файловых групп (Transact-SQL).

Соглашения о синтаксисе Transact-SQL

Синтаксис

sp_renamedb
    [ @dbname = ] N'dbname'
    , [ @newname = ] N'newname'
[ ; ]

Аргументы

[ @dbname = ] N'dbname'

Текущее имя базы данных. @dbname — sysname, без значения по умолчанию.

[ @newname = ] N'newname'

Новое имя базы данных. @newname — sysname без значения по умолчанию. @newname должны соответствовать правилам идентификаторов.

Значения кода возврата

0 (успешно) или ненулевое число (сбой).

Замечания

Невозможно переименовать базу данных SQL Azure, настроенную в активной связи георепликации .

Разрешения

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

Связанный контент