sp_addumpdevice (Transact-SQL)sp_addumpdevice (Transact-SQL)

ОБЛАСТЬ ПРИМЕНЕНИЯ: даSQL Server нетБаза данных SQL Azure нетAzure Synapse Analytics (хранилище данных SQL) нетParallel Data Warehouse APPLIES TO: yesSQL Server noAzure SQL Database noAzure Synapse Analytics (SQL DW) noParallel Data Warehouse

Применимо к SQL ServerSQL Server : SQL Server 2008SQL Server 2008 (с по текущей версии).Applies to: SQL ServerSQL Server ( SQL Server 2008SQL Server 2008 through current version).

Добавляет в экземпляр компонента SQL ServerSQL Server устройство резервного копирования.Adds a backup device to an instance of SQL ServerSQL Server.

Значок ссылки на раздел Синтаксические обозначения в Transact-SQLTopic link icon Transact-SQL Syntax Conventions

СинтаксисSyntax

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

АргументыArguments

[ @devtype = ] 'device_type'— Это тип устройства резервного копирования.[ @devtype = ] 'device_type' Is the type of backup device. device_type имеет тип varchar (20), не имеет значения по умолчанию и может принимать одно из следующих значений.device_type is varchar(20), with no default, and can be one of the following values.

ЗначениеValue ОписаниеDescription
свободногоdisk Файл на жестком диске в качестве устройства резервного копирования.Hard disk file as a backup device.
tapetape Любое ленточное устройство, поддерживаемое MicrosoftMicrosoft Windows.Any tape devices supported by MicrosoftMicrosoft Windows.

Примечание. Поддержка ленточных устройств резервного копирования будет удалена в одной из будущих версий SQL ServerSQL Server.Note: Support for tape backup devices will be removed in a future version of SQL ServerSQL Server. Избегайте использования этого компонента в новых разработках и запланируйте изменение существующих приложений, в которых он применяется.Avoid using this feature in new development work, and plan to modify applications that currently use this feature.

[ @logicalname = ] 'logical_name'Логическое имя устройства резервного копирования, используемое в инструкциях BACKUP и RESTORE.[ @logicalname = ] 'logical_name' Is the logical name of the backup device used in the BACKUP and RESTORE statements. Аргумент logical_name имеет тип sysname, не имеет значения по умолчанию и не может иметь значение null.logical_name is sysname, with no default, and cannot be NULL.

[ @physicalname = ] 'physical_name'Физическое имя устройства резервного копирования.[ @physicalname = ] 'physical_name' Is the physical name of the backup device. Физические имена должны соответствовать правилам для имен файлов операционной системы или формату UNC для сетевых устройств и должны содержать полный путь.Physical names must follow the rules for operating-system file names or universal naming conventions for network devices, and must include a full path. physical_name имеет тип nvarchar (260), не имеет значения по умолчанию и не может иметь значение null.physical_name is nvarchar(260), with no default value, and cannot be NULL.

При создании устройства резервного копирования в удаленном сетевом каталоге убедитесь, что имя входа, под которым запущен компонент Компонент Database EngineDatabase Engine, имеет на удаленном компьютере необходимые права на запись.When creating a backup device on a remote network location, be sure that the name under which the Компонент Database EngineDatabase Engine was started has appropriate write capabilities on the remote computer.

При добавлении ленточного устройства этот параметр должен быть физическим именем, назначенным локальному ленточному устройству системой Windows. Например, ** \ \.\TAPE0** для первого ленточного устройства на компьютере.If you add a tape device, this parameter must be the physical name assigned to the local tape device by Windows; for example, \\.\TAPE0 for the first tape device on the computer. Ленточное устройство должно быть подключено к серверному компьютеру и его нельзя использовать удаленно.The tape device must be attached to the server computer; it cannot be used remotely. Имена команд, содержащие символы, отличные от алфавитно-цифровых, следует заключать в кавычки.Enclose names that contain nonalphanumeric characters in quotation marks.

Примечание

Эта процедура вносит указанное физическое имя в каталог.This procedure enters the specified physical name into the catalog. Она не пытается создать это устройство или произвести доступ к нему.The procedure does not attempt to access or create the device.

[ @cntrltype = ] 'controller_type'Устаревшие.[ @cntrltype = ] 'controller_type' Obsolete. Если указан — не обрабатывается.If specified, this parameter is ignored. Поддерживается исключительно в целях обратной совместимости.It is supported purely for backward compatibility. Новые варианты использования sp_addumpdevice должны опускать этот параметр.New uses of sp_addumpdevice should omit this parameter.

[ @devstatus = ] 'device_status'Устаревшие.[ @devstatus = ] 'device_status' Obsolete. Если указан — не обрабатывается.If specified, this parameter is ignored. Поддерживается исключительно в целях обратной совместимости.It is supported purely for backward compatibility. Новые варианты использования sp_addumpdevice должны опускать этот параметр.New uses of sp_addumpdevice should omit this parameter.

Значения кода возвратаReturn Code Values

0 (успех) или 1 (сбой).0 (success) or 1 (failure)

Результирующие наборыResult Sets

NoneNone

RemarksRemarks

sp_addumpdevice добавляет устройство резервного копирования в представление каталога sys. backup_devices .sp_addumpdevice adds a backup device to the sys.backup_devices catalog view. После этого устройство можно указывать в инструкциях BACKUP и RESTORE по логическому имени.The device can then be referred to logically in BACKUP and RESTORE statements. sp_addumpdevice не выполняет никакого доступа к физическому устройству.sp_addumpdevice does not perform any access to the physical device. Обращение к нему производится только при выполнении инструкций BACKUP и RESTORE.Access to the specified device only occurs when a BACKUP or RESTORE statement is performed. Создание логического устройства резервного копирования упрощает инструкции BACKUP и RESTORE, позволяя вместо пути устройства в предложениях TAPE = и DISK = указывать имена устройств.Creating a logical backup device can simplify BACKUP and RESTORE statements, where specifying the device name is an alternative using a "TAPE =" or "DISK =" clause to specify the device path.

При использовании дисковых и файловых устройств резервного копирования проблемы владения и разрешений могут накладываться.Ownership and permissions problems can interfere with the use of disk or file backup devices. Проверьте, даны ли необходимые разрешения на соответствующие файлы учетной записи Windows, от имени которой запущен компонент Компонент Database EngineDatabase Engine.Make sure that appropriate file permissions are given to the Windows account under which the Компонент Database EngineDatabase Engine was started.

Компонент Компонент Database EngineDatabase Engine поддерживает резервное копирование на ленточные устройства, которые поддерживаются Windows.The Компонент Database EngineDatabase Engine supports tape backups to tape devices that are supported by Windows. Дополнительные сведения о ленточных устройствах, поддерживаемых Windows, см. в списке оборудования, совместимого с Windows.For more information about Windows-supported tape devices, see the hardware compatibility list for Windows. Для просмотра списка ленточных устройств, доступных на компьютере, воспользуйтесь средой SQL Server Management StudioSQL Server Management Studio.To view the tape devices available on the computer, use SQL Server Management StudioSQL Server Management Studio.

Пользуйтесь только теми типами лент, которые рекомендованы производителем устройства.Use only the recommended tapes for the specific tape drive that are suggested by the drive manufacturer. Для накопителей на цифровых звуковых лентах (DAT) пользуйтесь лентами компьютерного класса (хранилище цифровых данных — DDS).If you are using digital audio tape (DAT) drives, use computer-grade DAT tapes (Digital Data Storage (DDS)).

sp_addumpdevice не может выполняться внутри транзакции.sp_addumpdevice cannot be executed inside a transaction.

Чтобы удалить устройство, используйте sp_dropdevice илиSQL Server Management Studio.To delete a device, use sp_dropdevice orSQL Server Management Studio.

РазрешенияPermissions

Требует членства в предопределенной роли сервера diskadmin .Requires membership in the diskadmin fixed server role.

Необходимо разрешение на запись на жесткий диск.Requires permission to write to the disk.

ПримерыExamples

A.A. Добавление дискового устройства храненияAdding a disk dump device

В следующем примере добавляется дисковое устройство резервного копирования с именем mydiskdump, которое имеет физическое имя c:\dump\dump1.bak.The following example adds a disk backup device named mydiskdump, with the physical name c:\dump\dump1.bak.

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

Б.B. Добавление сетевого дискового устройства резервного копированияAdding a network disk backup device

Следующий пример иллюстрирует добавление удаленного дискового устройства резервного копирования с именем networkdevice.The following example shows adding a remote disk backup device called networkdevice. Имя, от которого запущен компонент Компонент Database EngineDatabase Engine, должно иметь разрешения на удаленный файл (\\<servername>\<sharename>\<path>\<filename>.bak).The name under which the Компонент Database EngineDatabase Engine was started must have permissions to that remote file (\\<servername>\<sharename>\<path>\<filename>.bak).

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

В.C. Добавление ленточного устройства резервного копированияAdding a tape backup device

В следующем примере добавляется устройство tapedump1 с физическим именем \\.\tape0.The following example adds the tapedump1 device with the physical name \\.\tape0.

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

Г.D. Резервное копирование на логическое устройство резервного копированияBacking up to a logical backup device

В следующем примере создается логическое устройство резервного копирования AdvWorksData для файла резервной копии на диске.The following example creates a logical backup device, AdvWorksData, for a backup disk file. Затем показано, как производится резервное копирование базы данных AdventureWorks2012AdventureWorks2012 на это логическое устройство резервного копирования.The example then backs up the AdventureWorks2012AdventureWorks2012 database to this logical backup device.

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

См. также:See Also

Устройства резервного копирования (SQL Server) Backup Devices (SQL Server)
BACKUP (Transact-SQL) BACKUP (Transact-SQL)
Определение логического устройства резервного копирования для дискового файла (SQL Server) Define a Logical Backup Device for a Disk File (SQL Server)
Определение логического устройства резервного копирования для ленточного накопителя (SQL Server) Define a Logical Backup Device for a Tape Drive (SQL Server)
RESTORE (Transact-SQL) RESTORE (Transact-SQL)
sp_dropdevice (Transact-SQL) sp_dropdevice (Transact-SQL)
sys. backup_devices (Transact-SQL) sys.backup_devices (Transact-SQL)
Системные хранимые процедуры ()Transact-SQLSystem Stored Procedures (Transact-SQL)