sp_addumpdevice (Transact-SQL)

Agrega un dispositivo de copia de seguridad a una instancia del SQL Server 2005 Database Engine (Motor de base de datos de SQL Server 2005) de Microsoft.

Icono de vínculo a temasConvenciones 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 de tipo varchar(20), no tiene ningún valor predeterminado y puede tener uno de los valores siguientes.

    Valor

    Descripción

    disk

    Archivo de disco duro que se utiliza como dispositivo de copia de seguridad.

    tape

    Todos los dispositivos de cinta admitidos por Microsoft Windows.

    NotaNota
    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 que se utiliza en las instrucciones BACKUP y RESTORE. logical_name es de tipo sysname, no tiene ningún 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 de tipo nvarchar(260), no tiene ningún valor predeterminado y no puede ser 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 datos tenga permiso de escritura en el equipo remoto.

    Si agrega un dispositivo de cinta, este parámetro tiene que 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 tener acceso 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. En los nuevos usos de sp_addumpdevice se debe 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. En los nuevos usos de sp_addumpdevice se debe omitir este parámetro.

Valores de código de retorno

0 (correcto) o 1 (error)

Conjuntos de resultados

Ninguno

Comentarios

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 lleva a cabo el 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 la cuenta de Windows con la que se inicia el Motor de base de datos disponga de los permisos de archivo apropiados.

El Motor de base de datos admite copias de seguridad de cinta para 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, utilice SQL Server Management Studio.

Utilice solo las cintas que recomienda el fabricante de la unidad. 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 utilizar en una transacción.

Para eliminar un dispositivo, utilice 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 el Motor de base de datos se ha iniciado debe tener permisos de acceso al 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 AdventureWorks2008R2 en este dispositivo de copia de seguridad lógico.

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