sp_addumpdevice (Transact-SQL)

Artikel
05/11/2023

Gilt für: SQL Server (SQL Server 2008 (10.0.x) bis zur aktuellen Version)

Fügt einem instance von SQL Server ein Sicherungsgerät hinzu.

Syntax

  
sp_addumpdevice [ @devtype = ] 'device_type'   
    , [ @logicalname = ] 'logical_name'   
    , [ @physicalname = ] 'physical_name'  
      [ , { [ @cntrltype = ] controller_type |  
          [ @devstatus = ] 'device_status' }  
      ]

Argumente

[ @devtype = ] 'device_type' Der Typ des Sicherungsgeräts. device_type ist varchar(20) ohne Standardwert und kann einer der folgenden Werte sein.

Wert	BESCHREIBUNG
Datenträger	Festplattendatei als Sicherungsmedium.
Band	Alle von Microsoft Windows unterstützten Bandgeräte. Hinweis: Die Unterstützung für Bandsicherungsgeräte wird in zukünftigen Versionen von SQL Serverentfernt. Nutzen Sie diese Funktionen bei Neuentwicklungen nicht mehr, und planen Sie die Änderung von Anwendungen, die diese Funktion zurzeit verwenden.

[ @logicalname = ] 'logical_name' Der logische Name des Sicherungsgeräts, das in den ANWEISUNGEN BACKUP und RESTORE verwendet wird. logical_name ist sysname ohne Standardwert und darf nicht NULL sein.

[ @physicalname = ] 'physical_name' Der physische Name des Sicherungsgeräts. Physische Namen müssen den Regeln für Dateinamen des Betriebssystems oder den UNC-Konventionen für Netzwerkgeräte entsprechen und einen vollständigen Pfad angeben. physical_name ist nvarchar(260) ohne Standardwert und darf nicht NULL sein.

Stellen Sie beim Erstellen eines Sicherungsgeräts an einem Remotenetzwerkstandort sicher, dass der Name, unter dem die Datenbank-Engine gestartet wurde, über entsprechende 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. Beispielsweise \\.\TAPE0 für das erste Bandgerät auf dem Computer. Das Bandmedium muss an den Server angefügt werden; eine Remoteverwendung ist nicht möglich. 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 = ] 'controller_type' Veraltet. Dieser Parameter wird ignoriert, wenn er angegeben wird. Er wird lediglich aus Gründen der Abwärtskompatibilität unterstützt. Bei neuen Verwendungen von sp_addumpdevice sollte dieser Parameter weggelassen werden.

[ @devstatus = ] 'device_status' Veraltet. Dieser Parameter wird ignoriert, wenn er angegeben wird. Er wird lediglich aus Gründen der Abwärtskompatibilität unterstützt. Bei neuen Verwendungen von sp_addumpdevice sollte dieser Parameter weggelassen werden.

Rückgabecodewerte

„0“ (erfolgreich) oder „1“ (fehlerhaft)

Resultsets

Keine

Bemerkungen

sp_addumpdevice fügt der sys.backup_devices Katalogansicht ein Sicherungsgerät hinzu. Auf das Gerät kann dann in BACKUP- und RESTORE-Anweisungen logisch verwiesen werden. sp_addumpdevice führt keinen Zugriff auf das physische Gerät aus. Ein Zugriff auf das angegebene Medium erfolgt nur, wenn eine BACKUP- oder RESTORE-Anweisung ausgeführt wird. Das Erstellen eines logischen Sicherungsmediums kann BACKUP- und RESTORE-Anweisungen vereinfachen, wo das Angeben des Gerätenamens eine Alternative zu einer "TAPE ="- oder "DISK ="-Klausel zum Angeben des Pfades darstellt.

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 zum Anzeigen der auf dem Computer verfügbaren Bandgeräte SQL Server Management Studio.

Verwenden Sie nur die empfohlenen Bänder für die jeweiligen Bandlaufwerke entsprechend den Angaben der Laufwerkhersteller. Bei DAT-Laufwerken (Digital Audio Tape) sollten Sie nur DAT-Bänder verwenden, die den Bandvorschriften für die Computerverwendung entsprechen (DDS, Digital Data Storage).

sp_addumpdevice können nicht innerhalb einer Transaktion ausgeführt werden.

Um ein Gerät zu löschen, verwenden Sie sp_dropdevice oder SQL Server Management Studio.

Berechtigungen

Erfordert die Mitgliedschaft in der festen Serverrolle diskadmin .

Erfordert die Berechtigung zum Schreiben auf den Datenträger.

Beispiele

A. Hinzufügen eines Datenträgersicherungsmediums

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 Netzwerk-Datenträgersicherungsmediums

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 Bandsicherungsmediums

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 ein logisches Sicherungsmedium

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

Weitere Informationen

Sicherungsmedien (SQL Server)
BACKUP (Transact-SQL)
Definieren eines logischen Sicherungsmediums für eine Datenträgerdatei (SQL Server)
Definieren eines logischen Sicherungsmediums für ein Bandlaufwerk (SQL Server)
RESTORE (Transact-SQL)
sp_dropdevice (Transact-SQL)
sys.backup_devices (Transact-SQL)
Gespeicherte Systemprozeduren (Transact-SQL)