Partilhar via

sp_addumpdevice (Transact-SQL)

Aplica-se a:SQL Server

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

Transact-SQL convenções de sintaxe

Sintaxe

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

Arguments

[ @devtype = ] 'devtype'

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

Valor Description
disk Ficheiro do disco rígido como dispositivo de backup.
tape Quaisquer dispositivos de fita suportados pelo Microsoft Windows.

Nota: O suporte para dispositivos de backup em fita será removido numa versão futura do SQL Server. Evite usar esse recurso em novos trabalhos de desenvolvimento e planeje modificar aplicativos que atualmente usam esse recurso.

[ @logicalname = ] N'nome ló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 ficheiros do sistema operativo, ou convenções universais de nomes para dispositivos de rede, e devem incluir um caminho completo.

Ao criar um dispositivo de backup numa localização remota de rede, certifique-se de que o nome sob o qual o Motor de Base de Dados foi iniciado tem capacidades de escrita adequadas no computador remoto.

Se adicionar um dispositivo de fita, este parâmetro deve 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 ligado ao computador servidor; Não pode ser usado remotamente. Inclua nomes que contenham caracteres não alfanuméricos entre aspas.

Observação

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

[ @cntrltype = ] cntrltype

Obsolete. Se especificado, este parâmetro é ignorado. Suportado para compatibilidade retroativa. Novos usos de sp_addumpdevice devem omitir este parâmetro.

[ @devstatus = ] 'devstatus'

Obsolete. Se especificado, este parâmetro é ignorado. Suportado para compatibilidade retroativa. Novos usos de sp_addumpdevice devem omitir este parâmetro.

Valores de código de retorno

0 (sucesso) ou 1 (fracasso).

Conjunto de resultados

Nenhum.

Observações

sp_addumpdevice Adiciona um dispositivo de backup à vista de sys.backup_devices catálogo. O dispositivo pode então ser referenciado logicamente em BACKUP instruções and RESTORE . sp_addumpdevice não faz qualquer acesso ao dispositivo físico. O acesso ao dispositivo especificado só ocorre quando uma BACKUP instrução ou RESTORE é executada. Criar um dispositivo de backup lógico pode simplificar BACKUP as instruções do Y RESTORE , onde especificar o nome do dispositivo é uma alternativa usando a TAPE = cláusula or DISK = para especificar o caminho do dispositivo.

Problemas de propriedade e permissões podem interferir com o uso de dispositivos de backup de disco ou ficheiros. Certifique-se de que as permissões de ficheiro adequadas são atribuídas à conta Windows sob a qual o Motor de Base de Dados foi iniciado.

O Motor de Base de Dados suporta cópias de segurança em fita para dispositivos de fita suportados pelo Windows. Para mais informações sobre dispositivos de fita suportados por Windows, consulte a lista de compatibilidade de hardware para Windows. Para visualizar os dispositivos de fita disponíveis no computador, utilize o SQL Server Management Studio.

Use apenas as fitas recomendadas para a unidade de fita específica sugerida pelo fabricante da unidade. Se estiveres a usar unidades de fita de áudio digital (DAT), usa fitas DAT de nível informático (Digital Data Storage (DDS)).

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

Para eliminar um dispositivo, use sp_dropdevice ou Eliminar um Dispositivo de Backup (SQL Server).

Permissions

Requer a pertença ao papel fixo de servidor de administrador de discos .

Requer permissão para gravar no disco.

Examples

A. Adicionar um dispositivo de despejo de disco

O exemplo seguinte adiciona um dispositivo de backup de disco chamado mydiskdump, com o nome C:\dump\dump1.bakfísico .

USE master;
GO

EXECUTE sp_addumpdevice 'disk', 'mydiskdump', 'C:\dump\dump1.bak';

B. Adicionar um dispositivo de backup de disco em rede

O exemplo seguinte mostra a adição de um dispositivo de backup remoto de disco chamado networkdevice. O nome sob o qual o Motor de Base de Dados foi iniciado deve ter permissões para esse ficheiro remoto (\\<servername>\<sharename>\<path>\<filename>.bak).

USE master;
GO

EXECUTE sp_addumpdevice
    'disk',
    'networkdevice',
    '\\<servername>\<sharename>\<path>\<filename>.bak';

C. Adicionar um dispositivo de backup em

O exemplo seguinte adiciona o tapedump1 dispositivo com o nome \\.\tape0físico .

USE master;
GO

EXECUTE sp_addumpdevice 'tape', 'tapedump1', '\\.\tape0';

D. Fazer backup para um dispositivo de backup lógico

O exemplo seguinte cria um dispositivo de backup lógico, AdvWorksData, para um ficheiro de disco de backup. O exemplo faz então backup da AdventureWorks2025 base de dados para este dispositivo lógico de backup.

USE master;
GO

EXECUTE sp_addumpdevice
    'disk',
    'AdvWorksData',
    'C:\Program Files\Microsoft SQL Server\MSSQL16.MSSQLSERVER\MSSQL\BACKUP\AdvWorksData.bak';
GO

BACKUP DATABASE AdventureWorks2022
TO AdvWorksData WITH FORMAT;
GO

Conteúdo relacionado

  • Last updated on