sp_renamedb (Transact-SQL)

S’applique à :SQL ServerAzure SQL Managed Instance

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

Important

Cette fonctionnalité sera supprimée dans une version future de 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é. Utilisez à la place ALTER DATABASE MODIFY NAME. Pour plus d’informations, consultez ALTER DATABASE (Transact-SQL).

Conventions de la syntaxe Transact-SQL

Syntaxe

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

Arguments

[ @dbname = ] 'old_name' Nom actuel de la base de données. old_name est sysname, sans valeur par défaut.

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

Codet de retour

0 (réussite) ou un nombre différent de zéro (échec)

Notes

Il n’est pas possible de renommer une base de données Azure SQL configurée dans une relation de géoréplication active.

Autorisations

Nécessite l’appartenance aux rôles serveur fixes sysadmin ou dbcreator .

Exemples

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  

Étapes suivantes