sp_addumpdevice (Transact-SQL)

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. Hinweis Die Unterstützung für Bandsicherungsgeräte wird in zukünftigen Versionen von SQL Server entfernt. Verwenden Sie diese Funktion nicht beim Entwickeln neuer Anwendungen, und planen Sie eine Änderung von Anwendungen, in denen sie zurzeit verwendet wird.

• [ @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 physische Name des Sicherungsmediums. Physische 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 Database Engine (Datenbankmodul) gestartet wurde, über entsprechende Schreibberechtigungen auf dem Remotecomputer verfügt.

  Wenn Sie ein Bandmedium hinzufügen, muss dieser Parameter der physische 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 physischen 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 physische 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 Datenträger- oder Dateisicherungsmedien beeinträchtigen. Stellen Sie sicher, dass für das Windows-Konto, unter dem Database Engine (Datenbankmodul) gestartet wurde, entsprechende Dateiberechtigungen angegeben sind.

Database Engine (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.

Zum Löschen eines Geräts 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

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

B. Hinzufügen eines Netzwerk-Datenträgersicherungsmediums

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

C. Hinzufügen eines Bandsicherungsmediums

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

D. Sichern auf ein logisches Sicherungsmedium

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

Siehe auch

Aufgaben

Verweis

Konzepte