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

APLICA-SE A: simSQL Server nãoBanco de Dados SQL do Azure nãoAzure Synapse Analytics (SQL DW) nãoParallel Data Warehouse APPLIES TO: yesSQL Server noAzure SQL Database noAzure Synapse Analytics (SQL DW) noParallel Data Warehouse

Aplica-se a: SQL ServerSQL Server (SQL Server 2008SQL Server 2008 até a versão atual).Applies to: SQL ServerSQL Server ( SQL Server 2008SQL Server 2008 through current version).

Adiciona um dispositivo de backup a uma instância do SQL ServerSQL Server.Adds a backup device to an instance of SQL ServerSQL Server.

Ícone de link do tópico Convenções de sintaxe de Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SintaxeSyntax

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

ArgumentosArguments

[ @devtype = ] 'device_type' É o tipo de dispositivo de backup.[ @devtype = ] 'device_type' Is the type of backup device. device_type está varchar(20) , sem padrão e pode ser um dos valores a seguir.device_type is varchar(20), with no default, and can be one of the following values.

ValorValue DescriçãoDescription
diskdisk Arquivo de disco rígido como dispositivo de backup.Hard disk file as a backup device.
tapetape Qualquer dispositivo de fita com suporte no MicrosoftMicrosoft Windows.Any tape devices supported by MicrosoftMicrosoft Windows.

Observação: O suporte a dispositivos de backup em fita será removido em uma versão futura do SQL ServerSQL Server.Note: Support for tape backup devices will be removed in a future version of SQL ServerSQL Server. Evite usar esse recurso em desenvolvimentos novos e planeje modificar os aplicativos que atualmente o utilizam.Avoid using this feature in new development work, and plan to modify applications that currently use this feature.

[ @logicalname = ] 'logical_name' É o nome lógico do dispositivo de backup usado nas instruções BACKUP e restauração.[ @logicalname = ] 'logical_name' Is the logical name of the backup device used in the BACKUP and RESTORE statements. logical_name está sysname, sem padrão, e não pode ser NULL.logical_name is sysname, with no default, and cannot be NULL.

[ @physicalname = ] 'physical_name' É o nome físico do dispositivo de backup.[ @physicalname = ] 'physical_name' Is the physical name of the backup device. Os nomes físicos devem seguir as regras para nomes de arquivo do sistema operacional ou convenções universais de nomenclatura de dispositivos de rede e devem incluir um caminho completo.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 está nvarchar (260) , sem nenhum padrão de valor e não pode ser NULL.physical_name is nvarchar(260), with no default value, and cannot be NULL.

Ao criar um dispositivo de backup em um local de rede remota, certifique-se de que o nome com o qual o Mecanismo de Banco de DadosDatabase Engine foi iniciado tenha os recursos adequados de gravação no computador remoto.When creating a backup device on a remote network location, be sure that the name under which the Mecanismo de Banco de DadosDatabase Engine was started has appropriate write capabilities on the remote computer.

Se você adicionar um dispositivo de fita, esse parâmetro deve ser o nome físico atribuído ao dispositivo de fita local pelo Windows; Por exemplo, \ \. \TAPE0 para o primeiro dispositivo de fita no computador.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. O dispositivo de fita deve ser anexado ao computador servidor; não pode ser usado remotamente.The tape device must be attached to the server computer; it cannot be used remotely. Inclua os nomes que contêm caracteres não alfanuméricos entre aspas.Enclose names that contain nonalphanumeric characters in quotation marks.

Observação

Esse procedimento insere no nome físico especificado no catálogo.This procedure enters the specified physical name into the catalog. O procedimento não tenta acessar nem criar o dispositivo.The procedure does not attempt to access or create the device.

[ @cntrltype = ] 'controller_type' Obsoleto.[ @cntrltype = ] 'controller_type' Obsolete. Se especificado, esse parâmetro será ignorado.If specified, this parameter is ignored. Há suporte apenas pela compatibilidade com versões anteriores.It is supported purely for backward compatibility. Novos usos de sp_addumpdevice devem omitir esse parâmetro.New uses of sp_addumpdevice should omit this parameter.

[ @devstatus = ] 'device_status' Obsoleto.[ @devstatus = ] 'device_status' Obsolete. Se especificado, esse parâmetro será ignorado.If specified, this parameter is ignored. Há suporte apenas pela compatibilidade com versões anteriores.It is supported purely for backward compatibility. Novos usos de sp_addumpdevice devem omitir esse parâmetro.New uses of sp_addumpdevice should omit this parameter.

Valores do código de retornoReturn Code Values

0 (êxito) ou 1 (falha)0 (success) or 1 (failure)

Conjuntos de resultadosResult Sets

NenhumNone

ComentáriosRemarks

sp_addumpdevice adiciona um dispositivo de backup para o sys. backup_devices exibição do catálogo.sp_addumpdevice adds a backup device to the sys.backup_devices catalog view. O dispositivo pode ser referenciado logicamente em instruções BACKUP e RESTORE.The device can then be referred to logically in BACKUP and RESTORE statements. sp_addumpdevice não realiza qualquer acesso ao dispositivo físico.sp_addumpdevice does not perform any access to the physical device. O acesso ao dispositivo especificado ocorre apenas quando uma instrução BACKUP ou RESTORE é executada.Access to the specified device only occurs when a BACKUP or RESTORE statement is performed. A criação de um dispositivo de backup lógico pode simplificar as instruções BACKUP e RESTORE, em que a especificação do nome do dispositivo é uma alternativa que usa uma cláusula "TAPE = " ou "DISK = " para especificar o caminho do 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.

Os problemas de propriedade e de permissões podem interferir no uso dos dispositivos de backup de disco ou de arquivos.Ownership and permissions problems can interfere with the use of disk or file backup devices. Verifique se as permissões de arquivo adequadas foram fornecidas à conta do Windows em que o Mecanismo de Banco de DadosDatabase Engine foi iniciado.Make sure that appropriate file permissions are given to the Windows account under which the Mecanismo de Banco de DadosDatabase Engine was started.

O Mecanismo de Banco de DadosDatabase Engine oferece suporte a backups de fita para dispositivos de fita que têm suporte no Windows.The Mecanismo de Banco de DadosDatabase Engine supports tape backups to tape devices that are supported by Windows. Para obter mais informações sobre dispositivos de fita com suporte no Windows, consulte a lista de compatibilidade de hardware para Windows.For more information about Windows-supported tape devices, see the hardware compatibility list for Windows. Para exibir os dispositivos de fita disponíveis no computador, use 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 somente as fitas recomendadas para a unidade de fita específica, sugeridas pelo fabricante de unidades.Use only the recommended tapes for the specific tape drive that are suggested by the drive manufacturer. Ao usar unidades DAT (fita de áudio digital), use DDS (Digital Data Storage) de fitas DAT com qualidade para computador.If you are using digital audio tape (DAT) drives, use computer-grade DAT tapes (Digital Data Storage (DDS)).

sp_addumpdevice não pode ser executado dentro de uma transação.sp_addumpdevice cannot be executed inside a transaction.

Para excluir um dispositivo, use sp_dropdevice ouSQL Server Management Studio.To delete a device, use sp_dropdevice orSQL Server Management Studio.

PermissõesPermissions

Requer associação na função de servidor fixa diskadmin .Requires membership in the diskadmin fixed server role.

Requer permissão para gravar no disco.Requires permission to write to the disk.

ExemplosExamples

A.A. Adicionando um dispositivo de despejo de discoAdding a disk dump device

O exemplo a seguir adiciona um dispositivo de backup de disco denominado mydiskdump, com o nome 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. Adicionando um dispositivo de backup de disco de redeAdding a network disk backup device

O exemplo a seguir mostra a adição de um dispositivo de backup de disco remoto denominado networkdevice.The following example shows adding a remote disk backup device called networkdevice. O nome sob o qual o Mecanismo de Banco de DadosDatabase Engine foi iniciado deve ter permissões para aquele arquivo remoto (\\<servername>\<sharename>\<path>\<filename>.bak).The name under which the Mecanismo de Banco de DadosDatabase 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. Adicionando um dispositivo de backup em fitaAdding a tape backup device

O exemplo a seguir adiciona o dispositivo tapedump1 ao nome 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. Fazendo backup em um dispositivo de backup lógicoBacking up to a logical backup device

O exemplo a seguir cria um dispositivo de backup lógico, AdvWorksData, para um arquivo de disco de backup.The following example creates a logical backup device, AdvWorksData, for a backup disk file. O exemplo faz backup do banco de dados AdventureWorks2012AdventureWorks2012 nesse dispositivo de backup 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  

Consulte tambémSee Also

Dispositivos de backup (SQL Server) Backup Devices (SQL Server)
BACKUP (Transact-SQL) BACKUP (Transact-SQL)
Definir um dispositivo de backup lógico para um arquivo de disco (SQL Server) Define a Logical Backup Device for a Disk File (SQL Server)
Definir um dispositivo de backup lógico para uma unidade de fita (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)
Procedimentos armazenados do sistema (Transact-SQL)System Stored Procedures (Transact-SQL)