sp_helpdevice (Transact-SQL)

Relata informações sobre dispositivos de backup do Microsoft® SQL Server™.

Observação importanteImportante

Esse recurso será removido em uma versão futura do Microsoft SQL Server. Evite usar esse recurso em desenvolvimentos novos e planeje modificar os aplicativos que atualmente o utilizam. Recomendamos que, em lugar disso, usar a exibição de catálogo sys.backup_devices.

Ícone de vínculo de tópicoConvenções de sintaxe Transact-SQL

Sintaxe

sp_helpdevice [ [ @devname = ] 'name' ]

Argumentos

  • [ @devname = ] 'name'
    É o nome do dispositivo de backup ao qual as informações são reportadas. O valor de name é sempre sysname.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Conjuntos de resultados

Nome da coluna

Tipo de dados

Descrição

device_name

sysname

Nome do dispositivo lógico.

physical_name

nvarchar(260)

Nome do arquivo físico.

descrição

nvarchar(255)

A descrição do dispositivo.

status

int

Um número que corresponde à descrição de estado na coluna description.

cntrltype

smallint

Tipo de controlador do dispositivo:

2 = Dispositivo de disco

5 = Dispositivo de fita

size

int

Tamanho do dispositivo em páginas de 2 KB.

Comentários

Se name for especificado, sp_helpdevice exibirá informações sobre o dispositivo de despejo especificado. Se name não for especificado, sp_helpdevice exibirá informações sobre todos os dispositivos de despejo na exibição de catálogo sys.backup_devices.

Dispositivos de despejo são adicionados ao sistema usando sp_addumpdevice.

Permissões

Requer associação na função pública.

Exemplos

O exemplo a seguir relata informações sobre todos os dispositivos de despejo em uma instância do SQL Server.

EXEC sp_helpdevice;