Dela via

sp_addumpdevice (Transact-SQL)

Gäller för:SQL Server

Lägger till en backup-enhet i en instans av SQL Server.

Transact-SQL syntaxkonventioner

Syntax

sp_addumpdevice
    [ @devtype = ] 'devtype'
    , [ @logicalname = ] N'logicalname'
    , [ @physicalname = ] N'physicalname'
    [ , [ @cntrltype = ] cntrltype ]
    [ , [ @devstatus = ] 'devstatus' ]
[ ; ]

Arguments

[ @devtype = ] 'devtype'

Typen av backup-enhet. @devtype är varchar(20), utan standard, och kan vara ett av följande värden.

Värde Description
disk Hårddiskfilen som backup.
tape Alla bandenheter som stöds av Microsoft Windows.

Notera: Stöd för bandbackup-enheter kommer att tas bort i en framtida version av SQL Server. Undvik att använda den här funktionen i nytt utvecklingsarbete och planera att ändra program som för närvarande använder den här funktionen.

[ @logicalname = ] N'logiskt namn'

Det logiska namnet på backup-enheten som används i BACKUP- och RESTORE-satserna. @logicalname är sysname, utan standard, och kan inte vara NULL.

[ @physicalname = ] Inte fysiskt namn'

Det fysiska namnet på backupenheten. @physicalname är nvarchar(260), utan standard, och kan inte vara NULL. Fysiska namn måste följa reglerna för operativsystemsfilnamn eller universella namngivningskonventioner för nätverksenheter och måste innehålla en fullständig sökväg.

När du skapar en backup-enhet på en fjärrnätverksplats, se till att namnet under vilket databasmotorn startades har lämpliga skrivmöjligheter på den fjärrdatorn.

Om du lägger till en bandenhet måste denna parameter vara det fysiska namn som Windows tilldelat den lokala bandenheten; till exempel \\.\TAPE0 för den första bandenheten på datorn. Bandenheten måste vara ansluten till serverdatorn; Det kan inte användas på distans. Omslut namn som innehåller icke-alfanumeriska tecken inom citationstecken.

Anmärkning

Denna procedur matar in det angivna fysiska namnet i katalogen. Proceduren försöker inte komma åt eller skapa enheten.

[ @cntrltype = ] cntrltyp

Obsolete. Om det anges ignoreras denna parameter. Stöds för bakåtkompatibilitet. Nya användningar av sp_addumpdevice bör utelämna denna parameter.

[ @devstatus = ] 'devstatus'

Obsolete. Om det anges ignoreras denna parameter. Stöds för bakåtkompatibilitet. Nya användningar av sp_addumpdevice bör utelämna denna parameter.

Returnera kodvärden

0 (lyckades) eller 1 (fel).

Resultatuppsättning

Ingen.

Anmärkningar

sp_addumpdevice lägger till en backup-enhet i katalogvyn sys.backup_devices . Enheten kan sedan logiskt refereras till i BACKUP och RESTORE satser. sp_addumpdevice Ger ingen åtkomst till den fysiska enheten. Åtkomst till den angivna enheten sker endast när en BACKUP or-sats RESTORE utförs. Att skapa en logisk backup-enhet kan förenkla BACKUP och RESTORE satser, där specificering av enhetsnamnet är ett alternativ att använda en TAPE = eller klausul DISK = för att ange enhetsvägen.

Ägarskaps- och behörighetsproblem kan störa användningen av disk- eller filbackupenheter. Se till att lämpliga filbehörigheter ges till Windows-kontot där databasmotorn startades.

Databasmotorn stöder bandbackup till bandenheter som stöds av Windows. För mer information om Windows-stödda bandenheter, se hårdvarukompatibilitetslistan för Windows. För att se de bandenheter som finns tillgängliga på datorn, använd SQL Server Management Studio.

Använd endast de rekommenderade banden för den specifika bandenhet som tillverkaren rekommenderat. Om du använder digitala ljudband (DAT)-enheter, använd datorklassade DAT-band (Digital Data Storage (DDS)).

sp_addumpdevice Kan inte genomföras i en transaktion.

För att ta bort en enhet, använd sp_dropdevice eller ta bort en backupenhet (SQL Server).

Permissions

Kräver medlemskap i diskadmin-fixserverrollen .

Kräver tillstånd att skriva till disken.

Examples

A. Lägg till en diskdump-enhet

Följande exempel lägger till en diskbackup-enhet med namnet mydiskdump, med det fysiska namnet C:\dump\dump1.bak.

USE master;
GO

EXECUTE sp_addumpdevice 'disk', 'mydiskdump', 'C:\dump\dump1.bak';

B. Lägg till en nätverksdiskbackup-enhet

Följande exempel visar att man lägger till en fjärrdiskbackup kallad networkdevice. Namnet under vilket databasmotorn startades måste ha behörigheter till den fjärrfilen (\\<servername>\<sharename>\<path>\<filename>.bak).

USE master;
GO

EXECUTE sp_addumpdevice
    'disk',
    'networkdevice',
    '\\<servername>\<sharename>\<path>\<filename>.bak';

C. Lägg till en bandbackup-enhet

Följande exempel lägger till tapedump1 enheten med det fysiska namnet \\.\tape0.

USE master;
GO

EXECUTE sp_addumpdevice 'tape', 'tapedump1', '\\.\tape0';

D. Säkerhetskopiera till en logisk backup-enhet

Följande exempel skapar en logisk backup-enhet, AdvWorksData, för en backup-diskfil. Exemplet säkerhetskopierar sedan databasen AdventureWorks2025 till denna logiska backup-enhet.

USE master;
GO

EXECUTE sp_addumpdevice
    'disk',
    'AdvWorksData',
    'C:\Program Files\Microsoft SQL Server\MSSQL16.MSSQLSERVER\MSSQL\BACKUP\AdvWorksData.bak';
GO

BACKUP DATABASE AdventureWorks2022
TO AdvWorksData WITH FORMAT;
GO

Relaterat innehåll

  • Last updated on