sp_addumpdevice (Transact-SQL)

Se aplica a:SQL Server

Se aplica a: SQL Server (desde SQL Server 2008 [10.0.x] hasta la versión actual).

Agrega un dispositivo de copia de seguridad a una instancia de SQL Server.

Convenciones de sintaxis de Transact-SQL

Sintaxis

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

Argumentos

[ @devtype = ] 'device_type' Es el tipo de dispositivo de copia de seguridad. device_type es varchar(20), sin ningún valor predeterminado y puede ser uno de los siguientes valores.

Valor Descripción
Disco Archivo de disco duro que se utiliza como dispositivo de copia de seguridad.
Cinta Cualquier dispositivo de cinta compatible con Microsoft Windows.

Nota: La compatibilidad con dispositivos de cinta de copia de seguridad se quitará en una versión futura de SQL Server. Evite utilizar esta característica en nuevos trabajos de desarrollo y tenga previsto modificar las aplicaciones que actualmente la utilizan.

[ @logicalname = ] 'logical_name' Es el nombre lógico del dispositivo de copia de seguridad usado en las instrucciones BACKUP y RESTORE. logical_name es sysname, sin valor predeterminado y no puede ser NULL.

[ @physicalname = ] 'physical_name' Es el nombre físico del dispositivo de copia de seguridad. 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_name es nvarchar(260), sin ningún valor predeterminado y no puede ser NULL.

Al crear un dispositivo de copia de seguridad en una ubicación de red remota, asegúrese de que el nombre con el que se inició el motor de base de datos tiene las funcionalidades de escritura adecuadas en el equipo remoto.

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 del equipo. El dispositivo de cinta tiene que estar en el equipo servidor; no se puede utilizar de forma remota. Incluya entre comillas los nombres que contengan caracteres no alfanuméricos.

Nota

Este procedimiento escribe en el catálogo el nombre físico especificado. El procedimiento no intenta acceder al dispositivo ni crearlo.

[ @cntrltype = ] 'controller_type' Obsoleto. Si se especifica, este parámetro se omite. Solo se admite para mantener la compatibilidad con versiones anteriores. Los nuevos usos de sp_addumpdevice deben omitir este parámetro.

[ @devstatus = ] 'device_status' Obsoleto. Si se especifica, este parámetro se omite. Solo se admite para mantener la compatibilidad con versiones anteriores. Los nuevos usos de sp_addumpdevice deben omitir este parámetro.

Valores de código de retorno

0 (correcto) o 1 (error)

Conjuntos de resultados

None

Observaciones

sp_addumpdevice agrega un dispositivo de copia de seguridad a la vista de catálogo sys.backup_devices . Después, se puede hacer referencia al dispositivo de forma lógica en las instrucciones BACKUP y RESTORE. sp_addumpdevice no realiza ningún acceso al dispositivo físico. El acceso al dispositivo especificado solo se produce cuando se ejecuta una instrucción BACKUP o RESTORE. 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.

Los problemas de propiedad y permisos pueden interferir en el uso de los dispositivos de copia de seguridad de disco o de archivo. Asegúrese de que se conceden los permisos de archivo adecuados a la cuenta de Windows con la que se inició el motor de base de datos.

El motor de base de datos admite copias de seguridad de cinta en dispositivos de cinta compatibles con 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. Para ver los dispositivos de cinta disponibles en el equipo, use SQL Server Management Studio.

Utilice solo las cintas que recomienda el fabricante de la unidad para la unidad de cinta específica. Si utiliza unidades de cinta de audio digital (DAT), utilice cintas DAT preparadas para equipos informáticos (Almacenamiento digital de datos, DDS).

sp_addumpdevice no se puede ejecutar dentro de una transacción.

Para eliminar un dispositivo, use sp_dropdevice o SQL Server Management Studio.

Permisos

Debe pertenecer al rol fijo de servidor diskadmin .

Requiere permiso para escribir en el disco.

Ejemplos

A. Agregar un dispositivo de volcado en disco

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.

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

B. Agregar un dispositivo de copia de seguridad de disco de red

En el ejemplo siguiente se muestra cómo agregar un dispositivo de copia de seguridad de disco remoto llamado networkdevice. El nombre con el que se inició el motor de base de datos debe tener permisos para ese archivo remoto (\\<servername>\<sharename>\<path>\<filename>.bak).

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

C. Agregar un dispositivo de copia de seguridad de cinta

En el ejemplo siguiente se muestra cómo agregar el dispositivo tapedump1 con el nombre físico \\.\tape0.

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

D. Realizar una copia de seguridad en un dispositivo de copia de seguridad lógico

En el siguiente ejemplo se crea un dispositivo de copia de seguridad lógico, AdvWorksData, para un archivo de copia de seguridad en disco. A continuación, se realiza una copia de seguridad de la base de datos AdventureWorks2019 en este dispositivo de copia de seguridad lógico.

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  

Consulte también

Dispositivos de copia de seguridad (SQL Server)
BACKUP (Transact-SQL)
Definir un dispositivo lógico de copia de seguridad para un archivo de disco (SQL Server)
Definir un dispositivo lógico de copia de seguridad en una unidad de cinta (SQL Server)
RESTORE (Transact-SQL)
sp_dropdevice (Transact-SQL)
sys.backup_devices (Transact-SQL)
Procedimientos almacenados del sistema (Transact-SQL)