Sdílet prostřednictvím

sp_addumpdevice (Transact-SQL)

platí pro:SQL Server

Přidává záložní zařízení do instance SQL Serveru.

Transact-SQL konvence syntaxe

Syntaxe

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

Arguments

[ @devtype = ] 'devtype'

Typ záložního zařízení. @devtype je varchar(20), bez výchozího nastavení, a může být jednou z následujících hodnot.

Hodnota Description
disk Soubor z pevného disku jako zálohovací zařízení.
tape Jakákoli pásková zařízení podporovaná Microsoft Windows.

Poznámka: Podpora zařízení pro zálohování pásky bude v budoucí verzi SQL Serveru odstraněna. Nepoužívejte tuto funkci v nové vývojové práci a naplánujte úpravu aplikací, které tuto funkci aktuálně používají.

[ @logicalname = ] N'logicalname'

Logický název záložního zařízení použitého v příkazech BACKUP a RESTORE. @logicalname je sysname, bez výchozího nastavení, a nemůže být NULL.

[ @physicalname = ] N'fyzické jméno'

Fyzický název záložního zařízení. @physicalname je nvarchar(260), bez výchozího nastavení, a nemůže být NULL. Fyzická jména musí dodržovat pravidla pro názvy souborů operačních systémů nebo univerzální pojmenovávací konvence síťových zařízení a musí obsahovat úplnou cestu.

Při vytváření záložního zařízení na vzdálené síťové lokalitě se ujistěte, že název, pod kterým byl databázový engine spuštěn, má odpovídající možnosti zápisu na vzdáleném počítači.

Pokud přidáte páskové zařízení, tento parametr musí být fyzický název přiřazený místnímu páskovému zařízení Windows; například \\.\TAPE0 pro první páskové zařízení v počítači. Páskové zařízení musí být připojeno k serverovému počítači; Nelze ji používat na dálku. Jména obsahující nealfanumerické znaky uložte do uvozovek.

Poznámka:

Tento postup zadává specifikovaný fyzický název do katalogu. Postup se nesnaží zařízení vytvořit ani ho vytvořit.

[ @cntrltype = ] cntrltype

Obsolete. Pokud je specifikován, tento parametr se ignoruje. Podporováno pro zpětnou kompatibilitu. Nové použití by sp_addumpdevice mělo tento parametr vynechat.

[ @devstatus = ] 'devstatus'

Obsolete. Pokud je specifikován, tento parametr se ignoruje. Podporováno pro zpětnou kompatibilitu. Nové použití by sp_addumpdevice mělo tento parametr vynechat.

Hodnoty návratového kódu

0 (úspěch) nebo 1 (selhání).

Sada výsledků

Žádné.

Poznámky

sp_addumpdevice přidává záložní zařízení do sys.backup_devices zobrazení katalogu. Zařízení lze pak logicky odkazovat v a BACKUPRESTORE příkazech. sp_addumpdevice Neprovádí žádný přístup k fyzickému zařízení. Přístup k určenému zařízení probíhá pouze tehdy, když je vykonán BACKUP příkaz or (or RESTORE příkaz). Vytvoření logického záložního zařízení může zjednodušit BACKUP a RESTORE příkazy, kde zadání názvu zařízení je alternativou použitím klauzule nebo TAPE =DISK = pro určení cesty zařízení.

Problémy s vlastnictvím a oprávněními mohou narušit používání zařízení pro zálohování disků nebo souborů. Ujistěte se, že jsou na Windows účtu, pod kterým byl databázový engine spuštěn, udělena příslušná oprávnění k souborům.

Databázový engine podporuje zálohování pásky na pásková zařízení podporovaná Windows. Pro více informací o páskových zařízeních podporovaných Windows viz seznam hardwarové kompatibility pro Windows. Pro zobrazení páskových zařízení dostupných v počítači použijte SQL Server Management Studio.

Používejte pouze doporučené pásky pro konkrétní páskovou mechaniku doporučenou výrobcem mechaniky. Pokud používáte digitální audio pásky (DAT), používejte počítačové DAT pásky (Digital Data Storage (DDS)).

sp_addumpdevice nelze ji provést v rámci transakce.

Pro smazání zařízení použijte sp_dropdevice nebo Smažte záložní zařízení (SQL Server).

Povolení

Vyžaduje členství v roli diskadmina na pevném serveru.

Vyžaduje povolení k zápisu na disk.

Examples

A. Přidejte zařízení pro vypisování disku

Následující příklad přidává zařízení pro zálohování disku s názvem mydiskdump, s fyzickým názvem C:\dump\dump1.bak.

USE master;
GO

EXECUTE sp_addumpdevice 'disk', 'mydiskdump', 'C:\dump\dump1.bak';

B. Přidejte síťové zálohovací zařízení na disku

Následující příklad ukazuje přidání vzdáleného zálohovacího zařízení na disku nazvaného networkdevice. Název, pod kterým byl databázový engine spuštěn, musí mít oprávnění k tomuto vzdálenému souboru (\\<servername>\<sharename>\<path>\<filename>.bak).

USE master;
GO

EXECUTE sp_addumpdevice
    'disk',
    'networkdevice',
    '\\<servername>\<sharename>\<path>\<filename>.bak';

C. Přidejte zálohovací zařízení na pásku

Následující příklad přidává tapedump1 zařízení s fyzickým názvem \\.\tape0.

USE master;
GO

EXECUTE sp_addumpdevice 'tape', 'tapedump1', '\\.\tape0';

D. Zálohujte na logické zálohovací zařízení

Následující příklad vytváří logické záložní zařízení, AdvWorksData, pro záložní diskový soubor. Příklad pak zálohuje databázi AdventureWorks2025 na toto logické zálohovací zařízení.

USE master;
GO

EXECUTE sp_addumpdevice
    'disk',
    'AdvWorksData',
    'C:\Program Files\Microsoft SQL Server\MSSQL16.MSSQLSERVER\MSSQL\BACKUP\AdvWorksData.bak';
GO

BACKUP DATABASE AdventureWorks2022
TO AdvWorksData WITH FORMAT;
GO

Související obsah

  • Last updated on