sys.sp_renamedb (Transact-SQL)

Van toepassing op:SQL ServerAzure SQL Managed Instance

Verandert de naam van een database.

Important

Deze functie wordt verwijderd in een toekomstige versie van SQL Server. Vermijd het gebruik van deze functie in nieuwe ontwikkelwerkzaamheden en plan om toepassingen te wijzigen die momenteel gebruikmaken van deze functie. Gebruik in plaats daarvan ALTER DATABASE MODIFY NAME. Zie ALTER DATABASE voor meer informatie.

Transact-SQL syntaxis-conventies

Syntax

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

Arguments

[ @dbname = ] N'dbname'

De huidige naam van de database. @dbname is een systeemnaam, zonder standaard.

[ @newname = ] Nieuwe naam'

De nieuwe naam van de database. @newname is sysname, zonder standaard. @newname moet de regels voor identificaties volgen.

Codewaarden retourneren

0 (geslaagd) of een niet-nulnummer (fout).

Remarks

Het is niet mogelijk om de naam van een Azure SQL-database te wijzigen die is geconfigureerd in een actieve geo-replicatie relatie.

Permissions

Vereist lidmaatschap van de sysadmin- of dbcreator-vaste serverrollen.

Examples

Het volgende voorbeeld maakt de Accounting database aan en verandert vervolgens de naam van de database naar Financial. De sys.databases catalogusweergave wordt vervolgens nagevraagd om de nieuwe naam van de database te verifiëren.

USE master;
GO

CREATE DATABASE Accounting;
GO

EXECUTE sp_renamedb N'Accounting', N'Financial';
GO

SELECT name,
       database_id,
       create_date
FROM sys.databases
WHERE name = N'Financial';
GO

Verwante inhoud

  • Last updated on