sp_renamedb (Transact-SQL)

Статья
11/25/2023

Применимо к:SQL Server Управляемый экземпляр SQL Azure

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

Внимание

Эта функция будет удалена в будущей версии 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 (успешное завершение) или ненулевое значение (неуспешное завершение)

Замечания

Невозможно переименовать базу данных 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, modified_date  
FROM sys.databases  
WHERE name = N'Financial';  
GO

Share via