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

SE APLICA A: síSQL Server noAzure SQL Database noAzure SQL Data Warehouse noAlmacenamiento de datos paralelos APPLIES TO: yesSQL Server noAzure SQL Database noAzure SQL Data Warehouse noParallel Data Warehouse

Se aplica a: SQL ServerSQL Server (desde SQL Server 2008SQL Server 2008 hasta la versión actual).Applies to: SQL ServerSQL Server ( SQL Server 2008SQL Server 2008 through current version).

Agrega un dispositivo de copia de seguridad a una instancia de SQL ServerSQL Server.Adds a backup device to an instance of SQL ServerSQL Server.

Icono de vínculo de tema Convenciones de sintaxis de Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SintaxisSyntax

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

ArgumentosArguments

[ @devtype = ] 'device_type' Es el tipo de dispositivo de copia de seguridad.[ @devtype = ] 'device_type' Is the type of backup device. device_type es varchar (20) , no tiene ningún valor predeterminado y puede ser uno de los siguientes valores.device_type is varchar(20), with no default, and can be one of the following values.

ValorValue DescripciónDescription
diskdisk Archivo de disco duro que se utiliza como dispositivo de copia de seguridad.Hard disk file as a backup device.
tapetape Todos los dispositivos de cinta admitidos por MicrosoftMicrosoft Windows.Any tape devices supported by MicrosoftMicrosoft Windows.

Nota: La compatibilidad con dispositivos de cinta de copia de seguridad se quitará en una versión futura de SQL ServerSQL Server.Note: Support for tape backup devices will be removed in a future version of SQL ServerSQL Server. Evite utilizar esta característica en nuevos trabajos de desarrollo y tenga previsto modificar las aplicaciones que actualmente la utilizan.Avoid using this feature in new development work, and plan to modify applications that currently use this feature.

[ @logicalname = ] 'logical_name' Es el nombre lógico del dispositivo de copia de seguridad utilizado en las instrucciones BACKUP y RESTORE.[ @logicalname = ] 'logical_name' Is the logical name of the backup device used in the BACKUP and RESTORE statements. nombreLógico es sysname, no tiene ningún valor predeterminado, y no puede ser NULL.logical_name is sysname, with no default, and cannot be NULL.

[ @physicalname = ] 'physical_name' Es el nombre físico del dispositivo de copia de seguridad.[ @physicalname = ] 'physical_name' Is the physical name of the backup device. Los nombres físicos tienen que cumplir las reglas de nombres de archivo del sistema operativo o las convenciones de nomenclatura universal para los dispositivos de red, y deben incluir la ruta de acceso completa.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 es nvarchar (260) , no tiene ningún valor predeterminado de valor y no puede ser NULL.physical_name is nvarchar(260), with no default value, and cannot be NULL.

Cuando cree un dispositivo de copia de seguridad en una ubicación de red remota, asegúrese de que el nombre con el que se haya iniciado el Motor de base de datosDatabase Engine tenga permiso de escritura en el equipo remoto.When creating a backup device on a remote network location, be sure that the name under which the Motor de base de datosDatabase Engine was started has appropriate write capabilities on the remote computer.

Si agrega un dispositivo de cinta, este parámetro debe ser el nombre físico asignado al dispositivo de cinta local por Windows; Por ejemplo, \ \. \TAPE0 para el primer dispositivo de cinta en el equipo.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. El dispositivo de cinta tiene que estar en el equipo servidor; no se puede utilizar de forma remota.The tape device must be attached to the server computer; it cannot be used remotely. Incluya entre comillas los nombres que contengan caracteres no alfanuméricos.Enclose names that contain nonalphanumeric characters in quotation marks.

Nota

Este procedimiento escribe en el catálogo el nombre físico especificado.This procedure enters the specified physical name into the catalog. El procedimiento no intenta tener acceso al dispositivo ni crearlo.The procedure does not attempt to access or create the device.

[ @cntrltype = ] 'controller_type' Ha quedado obsoleto.[ @cntrltype = ] 'controller_type' Obsolete. Si se especifica, este parámetro se omite.If specified, this parameter is ignored. Solo se admite para mantener la compatibilidad con versiones anteriores.It is supported purely for backward compatibility. Nuevos usos de sp_addumpdevice debe omitir este parámetro.New uses of sp_addumpdevice should omit this parameter.

[ @devstatus = ] 'device_status' Ha quedado obsoleto.[ @devstatus = ] 'device_status' Obsolete. Si se especifica, este parámetro se omite.If specified, this parameter is ignored. Solo se admite para mantener la compatibilidad con versiones anteriores.It is supported purely for backward compatibility. Nuevos usos de sp_addumpdevice debe omitir este parámetro.New uses of sp_addumpdevice should omit this parameter.

Valores de código de retornoReturn Code Values

0 (correcto) o 1 (error)0 (success) or 1 (failure)

Conjuntos de resultadosResult Sets

NoneNone

ComentariosRemarks

sp_addumpdevice agrega un dispositivo de copia de seguridad para el sys.backup_devices vista de catálogo.sp_addumpdevice adds a backup device to the sys.backup_devices catalog view. Después, se puede hacer referencia al dispositivo de forma lógica en las instrucciones BACKUP y RESTORE.The device can then be referred to logically in BACKUP and RESTORE statements. sp_addumpdevice no lleva a cabo cualquier acceso a un dispositivo físico.sp_addumpdevice does not perform any access to the physical device. El acceso al dispositivo especificado solo se produce cuando se ejecuta una instrucción BACKUP o RESTORE.Access to the specified device only occurs when a BACKUP or RESTORE statement is performed. La creación de un dispositivo lógico de copia de seguridad puede simplificar las instrucciones BACKUP y RESTORE, en las que se puede especificar el nombre del dispositivo como alternativa mediante una cláusula "TAPE =" o "DISK =" para indicar la ruta de acceso del dispositivo.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.

Los problemas de propiedad y permisos pueden interferir en el uso de los dispositivos de copia de seguridad de disco o de archivo.Ownership and permissions problems can interfere with the use of disk or file backup devices. Asegúrese de que la cuenta de Windows con la que se inicia el Motor de base de datosDatabase Engine disponga de los permisos de archivo apropiados.Make sure that appropriate file permissions are given to the Windows account under which the Motor de base de datosDatabase Engine was started.

El Motor de base de datosDatabase Engine admite copias de seguridad de cinta para dispositivos de cinta compatibles con Windows.The Motor de base de datosDatabase Engine supports tape backups to tape devices that are supported by Windows. Para obtener más información acerca de los dispositivos de cinta admitidos por Windows, vea la lista de compatibilidad de hardware de Windows.For more information about Windows-supported tape devices, see the hardware compatibility list for Windows. Para ver los dispositivos de cinta disponibles en el equipo, utilice SQL Server Management StudioSQL Server Management Studio.To view the tape devices available on the computer, use SQL Server Management StudioSQL Server Management Studio.

Utilice solo las cintas que recomienda el fabricante de la unidad para la unidad de cinta específica.Use only the recommended tapes for the specific tape drive that are suggested by the drive manufacturer. Si utiliza unidades de cinta de audio digital (DAT), utilice cintas DAT preparadas para equipos informáticos (Almacenamiento digital de datos, DDS).If you are using digital audio tape (DAT) drives, use computer-grade DAT tapes (Digital Data Storage (DDS)).

sp_addumpdevice no se puede ejecutar dentro de una transacción.sp_addumpdevice cannot be executed inside a transaction.

Para eliminar un dispositivo, use sp_dropdevice oSQL Server Management Studio.To delete a device, use sp_dropdevice orSQL Server Management Studio.

PermisosPermissions

Debe pertenecer al rol fijo de servidor diskadmin .Requires membership in the diskadmin fixed server role.

Requiere permiso para escribir en el disco.Requires permission to write to the disk.

EjemplosExamples

A.A. Agregar un dispositivo de volcado en discoAdding a disk dump device

En el ejemplo siguiente se muestra cómo agregar un dispositivo de copia de seguridad de disco llamado mydiskdump, con el nombre físico 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.B. Agregar un dispositivo de copia de seguridad de disco de redAdding a network disk backup device

En el ejemplo siguiente se muestra cómo agregar un dispositivo de copia de seguridad de disco remoto llamado networkdevice.The following example shows adding a remote disk backup device called networkdevice. El nombre con el que el Motor de base de datosDatabase Engine se ha iniciado debe tener permisos de acceso al archivo remoto (\\<servername>\<sharename>\<path>\<filename>.bak).The name under which the Motor de base de datosDatabase 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.C. Agregar un dispositivo de copia de seguridad de cintaAdding a tape backup device

En el ejemplo siguiente se muestra cómo agregar el dispositivo tapedump1 con el nombre físico \\.\tape0.The following example adds the tapedump1 device with the physical name \\.\tape0.

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

D.D. Realizar una copia de seguridad en un dispositivo de copia de seguridad lógicoBacking up to a logical backup device

En el siguiente ejemplo se crea un dispositivo de copia de seguridad lógico, AdvWorksData, para un archivo de copia de seguridad en disco.The following example creates a logical backup device, AdvWorksData, for a backup disk file. A continuación, se realiza una copia de seguridad de la base de datos AdventureWorks2012AdventureWorks2012 en este dispositivo de copia de seguridad lógico.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  

Vea tambiénSee Also

Dispositivos de copia de seguridad (SQL Server) Backup Devices (SQL Server)
BACKUP (Transact-SQL) BACKUP (Transact-SQL)
Definir un dispositivo lógico de copia de seguridad para un archivo de disco (SQL Server) Define a Logical Backup Device for a Disk File (SQL Server)
Definir un dispositivo lógico de copia de seguridad en una unidad de cinta (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)
Procedimientos almacenados del sistema (Transact-SQL)System Stored Procedures (Transact-SQL)