Partager via

  • Article

sp_renamedb (Transact-SQL)

Modifie le nom d'une base de données.

Important

Cette fonctionnalité sera supprimée dans une prochaine version de Microsoft SQL Server. Évitez d'utiliser cette fonctionnalité dans de nouveaux travaux de développement et prévoyez de modifier les applications qui utilisent actuellement cette fonctionnalité. À la place, utilisez ALTER DATABASE MODIFY NAME. Pour plus d'informations, consultez ALTER DATABASE (Transact-SQL).

Icône Lien de rubriqueConventions de la syntaxe de Transact-SQL

Syntaxe

sp_renamedb [ @dbname = ] 'old_name' , [ @newname = ] 'new_name'

Arguments

  • [ @dbname=] 'old_name'
    Nom actuelle de la base de données. L'argument old_name est de type sysname et n'a pas de valeur par défaut.

  • [ @newname=] 'new_name'
    Nouveau nom de la base de données. new_name doit suivre les règles des identificateurs. new_name est de type sysname, sans valeur par défaut.

Valeurs des codes de retour

0 (succès) ou nombre non nul (échec)

Autorisations

Requiert l'appartenance au rôle de serveur fixe sysadmin ou dbcreator.

Exemple

L'exemple suivant crée la base de données Accounting puis la renomme Financial. L'affichage catalogue sys.databases est ensuite interrogé afin que le nouveau nom de la base de données soit vérifié.

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