sp_addumpdevice (Transact-SQL)

Artigo
06/18/2013

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

Ícone de vínculo de tópico 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 do dispositivo de backup. device_type é varchar(20), sem padrão e pode ter um destes valores.

disk

Arquivo de disco rígido como dispositivo de backup.

tape

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 na instruções BACKUP e RESTORE. logical_name é sysname, sem padrão e não pode ser NULL.
[ @physicalname = ] 'physical_name'
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 precisará ser o nome físico atribuído ao dispositivo de fita local pelo Windows; por exemplo, \\.\TAPE0 para o primeiro dispositivo de fita do 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'
Obsoleto. Se especificado, esse parâmetro será ignorado. Há suporte apenas pela compatibilidade com versões anteriores. Os novos usos de sp_addumpdevice devem omitir esse parâmetro.
[ @devstatus = ] 'device_status'
Obsoleto. Se especificado, esse parâmetro será ignorado. Há suporte apenas pela compatibilidade com versões anteriores. Os novos usos de sp_addumpdevice devem omitir esse parâmetro.

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

Valores de código de retorno

0 (êxito) ou 1 (falha)

Conjuntos de resultados

Nenhum

Comentários

sp_addumpdevice adiciona um dispositivo de backup à exibição do catálogo sys.backup_devices. O dispositivo pode ser referenciado logicamente em instruções BACKUP e RESTORE. sp_addumpdevice não executa 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 ou SQL 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\MSSQL11.MSSQLSERVER\MSSQL\BACKUP\AdvWorksData.bak';
GO
BACKUP DATABASE AdventureWorks2012 
 TO AdvWorksData
   WITH FORMAT;
GO