sp_addumpdevice (Transact-SQL)

Gilt für: SQL Server

Fügt einer Instanz von SQL Server ein Sicherungsgerät hinzu.

Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

[ @devtype = ] 'devtype'

Der Typ des Sicherungsgeräts. @devtype ist varchar(20) ohne Standard und kann einer der folgenden Werte sein.

Wert Beschreibung
disk Festplattendatei als Sicherungsmedium.
tape Alle Bandgeräte, die von Microsoft Windows unterstützt werden.

Hinweis: Die Unterstützung für Bandsicherungsgeräte wird in einer zukünftigen Version von SQL Server entfernt. Nutzen Sie diese Funktionen bei Neuentwicklungen nicht mehr, und planen Sie die Änderung von Anwendungen, die diese Funktion zurzeit verwenden.

[ @logicalname = ] N'logicalname'

Der logische Name des Sicherungsgeräts, das in den BACKUP- und RESTORE-Anweisungen verwendet wird. @logicalname ist "sysname" ohne Standard und kann nicht seinNULL.

[ @physicalname = ] N'physicalname'

Der physische Name des Sicherungsgeräts. @physicalname ist nvarchar(260), ohne Standard und kann nicht seinNULL. Physische Namen müssen den Regeln für Betriebssystemdateinamen oder universelle Benennungskonventionen für Netzwerkgeräte entsprechen und einen vollständigen Pfad enthalten.

Achten Sie beim Erstellen eines Sicherungsgeräts auf einem Remotenetzwerkspeicherort darauf, dass der Name, unter dem die Datenbank-Engine gestartet wurde, über geeignete Schreibfunktionen auf dem Remotecomputer verfügt.

Wenn Sie ein Bandgerät hinzufügen, muss dieser Parameter der physische Name sein, der dem lokalen Bandgerät von Windows zugewiesen ist. Zum Beispiel \\.\TAPE0 für das erste Bandgerät auf dem Computer. Das Bandgerät muss an den Servercomputer angeschlossen werden; sie kann nicht remote verwendet werden. Schließen Sie Namen, die andere als alphanumerische Zeichen enthalten, in Anführungszeichen ein.

Hinweis

Diese Prozedur gibt den angegebenen physischen Namen in den Katalog ein. Die Prozedur versucht nicht, auf das Gerät zuzugreifen oder es zu erstellen.

[ @cntrltype = ] cntrltype

Veraltet. Dieser Parameter wird ignoriert, wenn er angegeben wird. Wird aus Gründen der Abwärtskompatibilität unterstützt. Bei neuen Verwendungen sollte sp_addumpdevice dieser Parameter weggelassen werden.

[ @devstatus = ] 'devstatus'

Veraltet. Dieser Parameter wird ignoriert, wenn er angegeben wird. Wird aus Gründen der Abwärtskompatibilität unterstützt. Bei neuen Verwendungen sollte sp_addumpdevice dieser Parameter weggelassen werden.

Rückgabecodewerte

0 (erfolgreich) oder 1 Fehler.

Resultset

Keine.

Hinweise

sp_addumpdevice fügt der sys.backup_devices Katalogansicht ein Sicherungsgerät hinzu. Das Gerät kann dann logisch in BACKUP und RESTORE Anweisungen referenzieren. sp_addumpdevice führt keinen Zugriff auf das physische Gerät durch. Der Zugriff auf das angegebene Gerät tritt nur auf, wenn eine oder RESTORE eine BACKUP Anweisung ausgeführt wird. Das Erstellen eines logischen Sicherungsgeräts kann vereinfachen und Anweisungen angebenBACKUP, wobei die Angabe des Gerätenamens eine Alternative ist, indem ein oder DISK = eine TAPE = Klausel verwendet wird, um den Gerätepfad RESTORE anzugeben.

Besitz- und Berechtigungsprobleme können das Verwenden von Datenträger- oder Dateisicherungsmedien beeinträchtigen. Stellen Sie sicher, dass dem Windows-Konto, unter dem die Datenbank-Engine gestartet wurde, entsprechende Dateiberechtigungen erteilt werden.

Die Datenbank-Engine unterstützt Bandsicherungen auf Bandgeräten, die von Windows unterstützt werden. Weitere Informationen zu Bandmedien, die von Windows unterstützt werden, finden Sie in der Hardwarekompatibilitätsliste für Windows. Verwenden Sie SQL Server Management Studio, um die auf dem Computer verfügbaren Bandgeräte anzuzeigen.

Verwenden Sie nur die empfohlenen Tapes für das vom Laufwerkhersteller vorgeschlagene spezifische Bandlaufwerk. Wenn Sie Digital Audio Tape (DAT)-Laufwerke verwenden, verwenden Sie DAT-Bänder auf Computerniveau (Digital Data Storage (DDS)).

sp_addumpdevice kann nicht innerhalb einer Transaktion ausgeführt werden.

Verwenden Sie zum Löschen eines Geräts sp_dropdevice oder Löschen eines Sicherungsgeräts (SQL Server).

Berechtigungen

Erfordert die Mitgliedschaft in der festen Serverrolle diskadmin .

Erfordert die Berechtigung zum Schreiben auf den Datenträger.

Beispiele

A. Hinzufügen eines Datenträgerabbildgeräts

Im folgenden Beispiel wird das Datenträgersicherungsmedium mydiskdump mit dem physischen Namen C:\dump\dump1.bak hinzugefügt.

USE master;
GO
EXEC sp_addumpdevice 'disk', 'mydiskdump', 'C:\dump\dump1.bak';

B. Hinzufügen eines Netzwerkdatenträgersicherungsgeräts

Im folgenden Beispiel wird ein Remote-Datenträgersicherungsmedium mit dem Namen networkdevice dargestellt. Der Name, unter dem die Datenbank-Engine gestartet wurde, muss über Berechtigungen für diese Remotedatei (\\<servername>\<sharename>\<path>\<filename>.bak) verfügen.

USE master;
GO
EXEC sp_addumpdevice 'disk', 'networkdevice',
    '\\<servername>\<sharename>\<path>\<filename>.bak';

C. Hinzufügen eines Bandsicherungsgeräts

Im folgenden Beispiel wird das Gerät tapedump1 mit dem physischen Namen \\.\tape0 hinzugefügt.

USE master;
GO
EXEC sp_addumpdevice 'tape', 'tapedump1', '\\.\tape0';

D: Sichern auf einem logischen Sicherungsgerät

Im folgenden Beispiel wird ein logisches Sicherungsmedium, AdvWorksData, für eine Sicherungs-Datenträgerdatei erstellt. Im Beispiel wird dann die AdventureWorks2022-Datenbank auf diesem logischen Sicherungsmedium gesichert.

USE master;
GO
EXEC sp_addumpdevice
    'disk',
    'AdvWorksData',
    'C:\Program Files\Microsoft SQL Server\MSSQL13.MSSQLSERVER\MSSQL\BACKUP\AdvWorksData.bak';
GO
BACKUP DATABASE AdventureWorks2022
 TO AdvWorksData WITH FORMAT;
GO