sp_addumpdevice (Transact-SQL)

Aplica-se a:SQL Server

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

Convenções de sintaxe de Transact-SQL

Sintaxe

sp_addumpdevice
    [ @devtype = ] 'devtype'
    , [ @logicalname = ] N'logicalname'
    , [ @physicalname = ] N'physicalname'
    [ , [ @cntrltype = ] cntrltype ]
    [ , [ @devstatus = ] 'devstatus' ]
[ ; ]

Argumentos

@devtype [ = ] 'devtype'

O tipo de dispositivo de backup. @devtype é varchar(20), sem padrão, e pode ser um dos seguintes valores.

Valor Descrição
disk Arquivo de disco rígido como dispositivo de backup.
tape Todos os dispositivos de fita suportados pelo Microsoft Windows.

Observação: o suporte para 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 [ = ] N'nomelógico'

O nome lógico do dispositivo de backup usado nas instruções BACKUP e RESTORE. @logicalname é sysname, sem padrão, e não pode ser NULL.

@physicalname [ = ] N'nome físico'

O nome físico do dispositivo de backup. @physicalname é nvarchar(260), sem padrão, e não pode ser NULL. Os nomes físicos devem seguir as regras para nomes de arquivos do sistema operacional ou convenções universais de nomenclatura para dispositivos de rede e devem incluir um caminho completo.

Ao criar um dispositivo de backup em um local de rede remoto, verifique se o nome sob o qual o Mecanismo de Banco de Dados foi iniciado tem recursos de gravação apropriados 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 estar conectado ao computador servidor; ele 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 ou criar o dispositivo.

@cntrltype [ = ] cntrltype

Obsoleto. Se especificado, esse parâmetro será ignorado. Compatível com versões anteriores. Novos usos de sp_addumpdevice devem omitir esse parâmetro.

@devstatus [ = ] 'devstatus'

Obsoleto. Se especificado, esse parâmetro será ignorado. Compatível com versões anteriores. Novos usos de sp_addumpdevice devem omitir esse parâmetro.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Conjunto de resultados

Nenhum.

Comentários

sp_addumpdevice Adiciona um dispositivo de backup à exibição de sys.backup_devices catálogo. O dispositivo pode então ser referenciado logicamente em BACKUP e RESTORE instruções. sp_addumpdevice não realiza nenhum acesso ao dispositivo físico. O acesso ao dispositivo especificado ocorre somente quando uma BACKUP instrução ou RESTORE é executada. A criação de um dispositivo de backup lógico pode simplificar BACKUP instruções e RESTORE , onde especificar o nome do dispositivo é uma alternativa usando uma TAPE = cláusula 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 apropriadas são dadas à conta do Windows sob a qual o Mecanismo de Banco de Dados foi iniciado.

O Mecanismo de Banco de Dados oferece suporte a backups em fita para dispositivos de fita suportados pelo 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 o SQL Server Management Studio.

Use apenas as fitas recomendadas para a unidade de fita específica sugerida pelo fabricante da unidade. Se você estiver usando unidades de fita de áudio digital (DAT), use fitas DAT de nível de computador (DDS (Digital Data Storage, armazenamento de dados digitais).

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

Para excluir um dispositivo, use sp_dropdevice ou Excluir um dispositivo de backup (SQL Server).

Permissões

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

Requer permissão para gravar no disco.

Exemplos

R. Adicionar 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. Adicionar um dispositivo de backup em 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 esse arquivo remoto (\\<servername>\<sharename>\<path>\<filename>.bak).

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

C. Adicionar 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. Fazer 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 AdventureWorks2022 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 AdventureWorks2022
 TO AdvWorksData WITH FORMAT;
GO