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
Zugehöriger Inhalt
- Sicherungsgeräte (SQL Server)
- BACKUP (Transact-SQL)
- Definieren eines logischen Sicherungsgeräts für eine Datenträgerdatei (SQL Server)
- Definieren eines logischen Sicherungsmediums für ein Bandlaufwerk (SQL Server)
- RESTORE-Anweisungen (Transact-SQL)
- sp_dropdevice (Transact-SQL)
- sys.backup_devices (Transact-SQL)
- Gespeicherte Systemprozeduren (Transact-SQL)