sp_dropdevice (Transact-SQL)

Aplica-se a: SQL Server

Descarta um dispositivo de banco de dados ou dispositivo de backup de uma instância do Mecanismo de Banco de Dados do SQL Server, excluindo a entrada do master.dbo.sysdevices.

Convenções de sintaxe de Transact-SQL

Sintaxe

sp_dropdevice
    [ @logicalname = ] N'logicalname'
    [ , [ @delfile = ] 'delfile' ]
[ ; ]

Argumentos

@logicalname [ = ] N'nome lógico'

O nome lógico do dispositivo de banco de dados ou dispositivo de backup, conforme listado em master.dbo.sysdevices.name. @logicalname é sysname, sem padrão.

@delfile [ = ] 'delfile'

Especifica se o arquivo de dispositivo de backup físico deve ser excluído. @delfile é varchar(7), com um padrão de NULL. Se especificado como DELFILE, o arquivo de disco do dispositivo de backup físico será excluído.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Conjunto de resultados

Nenhum.

Comentários

sp_dropdevice não pode ser usado dentro de uma transação.

Permissões

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

Exemplos

O exemplo a seguir descarta o dispositivo de despejo tapedump1 de fita do Mecanismo de Banco de Dados.

EXEC sp_dropdevice 'tapedump1';