sp_addumpdevice (Transact-SQL)

Se aplica a:SQL Server

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

Convenciones de sintaxis de Transact-SQL

Sintaxis

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

Argumentos

[ @devtype = ] 'devtype'

Tipo de dispositivo de copia de seguridad. @devtype es varchar(20), sin valor predeterminado y puede ser uno de los siguientes valores.

Value Descripción
disk Archivo de disco duro que se utiliza como dispositivo de copia de seguridad.
tape Cualquier dispositivo de cinta compatible con Microsoft Windows.

Nota: La compatibilidad con dispositivos de copia de seguridad en cinta 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 = ] N'logicalname'

Nombre lógico del dispositivo de copia de seguridad usado en las instrucciones BACKUP y RESTORE. @logicalname es sysname, sin ningún valor predeterminado y no puede ser NULL.

[ @physicalname = ] N'physicalname'

Nombre físico del dispositivo de copia de seguridad. @physicalname es nvarchar(260), sin valores predeterminados y no puede ser NULL. Los nombres físicos deben seguir las reglas para los nombres de archivo del sistema operativo o convenciones de nomenclatura universal para dispositivos de red y deben incluir una ruta de acceso completa.

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 debe estar conectado al equipo servidor; no se puede usar 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 = ] cntrltype

Obsoleto. Si se especifica, este parámetro se omite. Compatible con versiones anteriores. Los nuevos usos de sp_addumpdevice deben omitir este parámetro.

[ @devstatus = ] 'devstatus'

Obsoleto. Si se especifica, este parámetro se omite. Compatible con versiones anteriores. Los nuevos usos de sp_addumpdevice deben omitir este parámetro.

Valores de código de retorno

0 (correcto) o 1 (erróneo).

Conjunto de resultados

Ninguno.

Comentarios

sp_addumpdevice agrega un dispositivo de copia de seguridad a la vista de sys.backup_devices catálogo. A continuación, se puede hacer referencia al dispositivo de forma lógica en BACKUP las instrucciones y RESTORE . sp_addumpdevice no realiza ningún acceso al dispositivo físico. El acceso al dispositivo especificado solo se produce cuando se realiza una BACKUP instrucción o RESTORE . La creación de un dispositivo lógico de copia de seguridad puede simplificar BACKUP las instrucciones y RESTORE , donde especificar el nombre del dispositivo es una alternativa mediante una TAPE = cláusula o DISK = para especificar 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.

Use solo las cintas recomendadas para la unidad de cinta específica sugerida por el fabricante de unidades. Si usa unidades de cinta de audio digital (DAT), use cintas DAT de nivel de equipo (Almacenamiento de datos digitales [DDS]).

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

Para eliminar un dispositivo, use sp_dropdevice o Eliminar un dispositivo de copia de seguridad (SQL Server).

Permisos

Debe pertenecer al rol fijo de servidor diskadmin .

Requiere permiso para escribir en el disco.

Ejemplos

A Adición de un dispositivo de volcado de 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. Adición de 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. Adición de 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. Copia de seguridad en un dispositivo lógico de copia de seguridad

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 AdventureWorks2022 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 AdventureWorks2022
 TO AdvWorksData WITH FORMAT;
GO