sp_renamedb (Transact-SQL)
Область применения: 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