sp_addumpdevice (Transact-SQL)

Sintaxe

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

Argumentos

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

  Valor	Descrição
  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 novos trabalhos de desenvolvimento e planeje modificar os aplicativos que o utilizam atualmente.

• [ @logicalname = ] 'logical_name'
  Nome lógico do dispositivo de backup usado nas 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.

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 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 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

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

B. Adicionando um dispositivo de backup de disco de rede

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

C. Adicionando um dispositivo de backup de fita

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

D. Fazendo backup em um dispositivo de backup 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

Consulte também

Tarefas

Referência

Conceitos