sp_addumpdevice
将备份设备添加到 Microsoft® SQL Server™。
语法
sp_addumpdevice [ @devtype = ] 'device_type' ,
[ @logicalname = ] 'logical_name' ,
[ @physicalname = ] 'physical_name'
[ ,
{ [ @cntrltype = ] controller_type
| [ @devstatus = ] 'device_status'
}
]
参数
[@devtype =] 'device_type',
备份设备的类型,device_type 的数据类型为 varchar(20),没有默认设置,可以是下列值之一。
值 | 描述 |
---|---|
disk | 硬盘文件作为备份设备。 |
pipe | 命名管道。 |
tape | 由 Microsoft Windows NT® 支持的任何磁带设备。如果 device 是 tape,则其默认值为 noskip。 |
[@logicalname =] 'logical_name'
备份设备的逻辑名称,该逻辑名称用于 BACKUP 和 RESTORE 语句中,logical_name 的数据类型为 sysname,没有默认值,并且不能为 NULL。
[@physicalname =] 'physical_name'
备份设备的物理名称。物理名称必须遵照操作系统文件名称的规则或者网络设备的通用命名规则,并且必须包括完整的路径。physical_name 的数据类型为 nvarchar(260),没有默认值,并且不能为 NULL。
当创建远程网络位置上的备份设备时,请确保在其下启动 SQL Server 的名称对远程的计算机有适当的写入能力。
如果要添加磁带设备,那么该参数必须是 Windows NT® 指派给本地磁带设备的物理名称,例如 \\.\TAPE0(对于计算机中的第一个磁带设备)。磁带设备必须连接到服务器计算机上,不能远程使用。如果名称包含非字母数字的字符,请用引号将其引起来。
[@cntrltype =] controller_type
当创建备份设备时,该参数并不是必需的。为脚本提供该参数比较合适,然而 SQL Server 会将其忽略。controller_type 的数据类型为 smallint,默认值为 NULL,可以是下列值之一。
值 | 描述 |
---|---|
2 | 当 device_type 为 disk 时使用。 |
5 | 当 device_type 为 tape 时使用。 |
6 | 当 device_type 为 pipe 时使用。 |
[@devstatus =] 'device_status'
指明是读取 (noskip) ANSI 磁带标签,还是忽略 (skip) 它。device_status 的数据类型为 varchar(40),默认值为 noskip。
说明 可以指定 controller_type 或 device_status,但二者不要同时指定。
返回代码值
0(成功)或 1(失败)