sp_addumpdevice (Transact-SQL)

Aplica-se a: SQL Server (todas as versões compatíveis)

Aplica-se a: SQL Server (SQL Server 2008 até a versão atual).

Adiciona um dispositivo de backup a uma instância do SQL Server.

Convenções da sintaxe Transact-SQL

Sintaxe

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

Argumentos

[ @devtype = ] 'device_type' É o tipo de dispositivo de backup. device_type é varchar (20), sem padrão, e pode ser um dos valores a seguir.

Valor	Descrição
disco	Arquivo de disco rígido como dispositivo de backup.
fita	Qualquer dispositivo de fita com suporte no Microsoft Windows. Observação: O suporte a dispositivos de backup em fita será removido em uma versão futura do SQL Server. Evite usar esse recurso em desenvolvimentos novos e planeje modificar os aplicativos que atualmente o utilizam.

[ @logicalname = ] 'logical_name' É o nome lógico do dispositivo de backup usado nas instruções de BACKUP e restauração. logical_name é sysname, sem padrão, e não pode ser nulo.

[ @physicalname = ] 'physical_name' É o nome físico do dispositivo de backup. 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_name é nvarchar (260), sem valor padrão e não pode ser 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 Dados foi iniciado tenha os recursos adequados de gravação no computador remoto.

Se você adicionar um dispositivo de fita, esse parâmetro deverá 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. O dispositivo de fita deve ser anexado ao computador servidor; não pode ser usado remotamente. Inclua os nomes que contêm caracteres não alfanuméricos entre aspas.

Observação

Esse procedimento insere no nome físico especificado no catálogo. O procedimento não tenta acessar nem criar o dispositivo.

[ @cntrltype = ] 'controller_type' Substituí. Se especificado, esse parâmetro será ignorado. Há suporte apenas pela compatibilidade com versões anteriores. Novos usos de sp_addumpdevice devem omitir esse parâmetro.

[ @devstatus = ] 'device_status' Substituí. Se especificado, esse parâmetro será ignorado. Há suporte apenas pela compatibilidade com versões anteriores. Novos usos de sp_addumpdevice devem omitir esse parâmetro.

Valores do código de retorno

0 (êxito) ou 1 (falha)

Conjuntos de resultados

Nenhum

Comentários

sp_addumpdevice adiciona um dispositivo de backup à exibição de catálogo Sys.backup_devices . O dispositivo pode ser referenciado logicamente em instruções BACKUP e RESTORE. sp_addumpdevice não realiza nenhum acesso ao dispositivo físico. O acesso ao dispositivo especificado ocorre apenas quando uma instrução BACKUP ou RESTORE é executada. 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.

Os problemas de propriedade e de permissões podem interferir no uso dos dispositivos de backup de disco ou de arquivos. Verifique se as permissões de arquivo adequadas foram fornecidas à conta do Windows em que o Mecanismo de Banco de Dados foi iniciado.

O Mecanismo de Banco de Dados oferece suporte a backups de fita para dispositivos de fita que têm suporte no Windows. Para obter mais informações sobre dispositivos de fita com suporte no Windows, consulte a lista de compatibilidade de hardware para Windows. Para exibir os dispositivos de fita disponíveis no computador, use SQL Server Management Studio.

Use somente as fitas recomendadas para a unidade de fita específica, sugeridas pelo fabricante de unidades. Ao usar unidades DAT (fita de áudio digital), use DDS (Digital Data Storage) de fitas DAT com qualidade para computador.

sp_addumpdevice não pode ser executado dentro de uma transação.

Para excluir um dispositivo, use sp_dropdevice ouSQL Server Management Studio.

Permissões

Requer associação na função de servidor fixa diskadmin .

Requer permissão para gravar no disco.

Exemplos

a. Adicionando um dispositivo de despejo de disco

O exemplo a seguir adiciona um dispositivo de backup de disco denominado mydiskdump, com o nome físico c:\dump\dump1.bak.

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

B. Adicionando um dispositivo de backup de disco de rede

O exemplo a seguir mostra a adição de um dispositivo de backup de disco remoto denominado networkdevice. O nome sob o qual o Mecanismo de Banco de Dados foi iniciado deve ter permissões para aquele arquivo remoto (\\<servername>\<sharename>\<path>\<filename>.bak).

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

C. Adicionando um dispositivo de backup em fita

O exemplo a seguir adiciona o dispositivo tapedump1 ao nome físico \\.\tape0.

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

D. Fazendo backup em um dispositivo de backup lógico

O exemplo a seguir cria um dispositivo de backup lógico, AdvWorksData, para um arquivo de disco de backup. O exemplo faz backup do banco de dados AdventureWorks2012 nesse dispositivo de backup 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 Também

Dispositivos de backup (SQL Server)
BACKUP (Transact-SQL)
Definir um dispositivo de backup lógico para um arquivo de disco (SQL Server)
Definir um dispositivo de backup lógico para uma unidade de fita (SQL Server)
RESTORE (Transact-SQL)
sp_dropdevice (Transact-SQL)
sys.backup_devices (Transact-SQL)
Procedimentos armazenados do sistema (Transact-SQL)