Compartilhar via

  • Artigo

sp_addumpdevice (Transact-SQL)

Adiciona um dispositivo de backup a uma instância do MicrosoftMecanismo de Banco de Dados do SQL Server 2005.

Ícone de vínculo de tópicoConvenções de 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'
    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çãoObservaçã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çãoObservaçã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

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 de 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 AdventureWorks nesse dispositivo de backup lógico.

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