sp_helpdevice (Transact-SQL)

适用于SQL Server

报告有关 SQL Server 备份设备的信息。

重要

在 SQL Server的未来版本中将删除此功能。 请避免在新的开发工作中使用该功能,并着手修改当前还在使用该功能的应用程序。 建议改用 sys.backup_devices 目录视图

Transact-SQL 语法约定

语法

sp_helpdevice [ [ @devname = ] N'devname' ]
[ ; ]

参数

[ @devname = ] N'devname'

报告信息的备份设备的名称。 @devname为 sysname,默认值为 NULL.

返回代码值

0(成功)或 1(失败)。

结果集

列名称 数据类型 描述
device_name sysname 逻辑设备名。
physical_name nvarchar(260) 物理文件名。
description nvarchar(255) 设备的说明。
status int 对应于列中的状态说明 description 的数字。
cntrltype smallint 设备的控制器类型:

2 = 磁盘设备
5 = 磁带设备
size int 设备大小(以 2 KB 页为单位)。

注解

如果 指定了@devnamesp_helpdevice 则显示有关指定转储设备的信息。 如果未 指定@devnamesp_helpdevice 则显示目录视图中所有转储设备 sys.backup_devices 的相关信息。

使用 sp_addumpdevice 将转储设备添加到系统中。

权限

要求 公共 角色具有成员身份。

示例

以下示例报告有关 SQL Server 实例上所有转储设备的信息。

EXEC sp_helpdevice;