sp_addumpdevice (Transact-SQL)

Artikel
12/15/2008

Fügt einer Instanz von Microsoft SQL Server 2005-Datenbankmodul ein Sicherungsmedium hinzu.

Themenlink (Symbol) Transact-SQL-Syntaxkonventionen

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 Sicherungsmediums. device_type ist vom Datentyp varchar(20) und hat keinen Standardwert. Die folgenden Werte sind möglich:

Wert Beschreibung

disk

Festplattendatei als Sicherungsmedium.

tape

Alle von Microsoft Windows unterstützten Bandmedien.

Wert	Beschreibung
disk	Festplattendatei als Sicherungsmedium.
tape	Alle von Microsoft Windows unterstützten Bandmedien.

[ @logicalname = ] 'logical_name'
Der logische Name des Sicherungsmediums, der in BACKUP- und RESTORE-Anweisungen verwendet wird. logical_name ist vom Datentyp sysname, hat keinen Standardwert und darf nicht NULL sein.

[ @physicalname = ] 'physical_name'
Der physikalische Name des Sicherungsmediums. Physikalische Namen müssen den Regeln für Dateinamen in Betriebssystemen oder UNC-Konventionen für Netzwerkgeräte entsprechen und einen vollständigen Pfad enthalten. physical_name ist vom Datentyp nvarchar(260), hat keinen Standardwert und darf nicht NULL sein.

Beim Erstellen eines Sicherungsmediums auf einem Remotenetzwerk-Speicherort sollten Sie sicherstellen, dass das Benutzerkonto, unter dem Datenbankmodul gestartet wurde, über entsprechende Schreibberechtigungen auf dem Remotecomputer verfügt.

Wenn Sie ein Bandmedium hinzufügen, muss dieser Parameter der physikalische Name sein, der dem lokalen Bandmedium von Windows zugewiesen wurde, z. B. \\.\TAPE0 für das erste Bandmedium 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 physikalischen Namen in den Katalog ein. Die Prozedur nimmt jedoch keine Erstellung des Mediums und keinen Zugriff auf das Medium vor.

Hinweis:
Diese Prozedur gibt den angegebenen physikalischen Namen in den Katalog ein. Die Prozedur nimmt jedoch keine Erstellung des Mediums und keinen Zugriff auf das Medium vor.

[ @cntrltype = ] 'controller_type'
Veraltet. Dieser Parameter wird ignoriert, wenn er angegeben wird. Er wird lediglich aus Gründen der Abwärtskompatibilität unterstützt. In neuen Implementierungen 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. In neuen Implementierungen von sp_addumpdevice sollte dieser Parameter weggelassen werden.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Resultsets

Keine

Hinweise

sp_addumpdevice fügt der sys.backup_devices-Katalogsicht ein Sicherungsmedium hinzu. Auf dieses Medium kann dann in BACKUP- und RESTORE-Anweisungen logisch verwiesen werden. sp_addumpdevice nimmt keinen Zugriff auf das physikalische Medium vor. 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 Festplatten- oder Dateisicherungsmedien beeinträchtigen. Stellen Sie sicher, dass für das Windows-Konto, unter dem Datenbankmodul gestartet wurde, entsprechende Dateiberechtigungen angegeben sind.

Datenbankmodul unterstützt Sicherungen auf den Bandmedien, die auch 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 Bandmedien anzuzeigen.

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 kann nicht innerhalb einer Transaktion ausgeführt werden.

Berechtigungen

Erfordert die Mitgliedschaft in der festen Serverrolle diskadmin.

Beispiele

A. Hinzufügen eines Festplattensicherungsmediums

Im folgenden Beispiel wird das Festplattensicherungsmedium mydiskdump mit dem physikalischen Namen c:\dump\dump1.bak hinzugefügt.

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

B. Hinzufügen eines Netzwerk-Festplattensicherungsmediums

Im folgenden Beispiel wird ein Remote-Festplattensicherungsmedium mit dem Namen networkdevice dargestellt. Das Benutzerkonto, unter dem Datenbankmodul gestartet wurde, muss für diese Remotedatei (\\<servername>\<sharename>\<path>\<filename>.bak) über entsprechende Berechtigungen 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 physikalischen 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 AdventureWorks-Datenbank auf dieses logische Sicherungsmedium gesichert.

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

Siehe auch