sp_attach_single_file_db (Transact-SQL)
将只有一个数据文件的数据库附加到当前服务器。 sp_attach_single_file_db 不能用于多个数据文件。
重要提示 |
---|
后续版本的 Microsoft SQL Server 将删除该功能。请避免在新的开发工作中使用该功能,并着手修改当前还在使用该功能的应用程序。,我们建议您改用 CREATE DATABASE database_name FOR ATTACH。有关详细信息,请参阅CREATE DATABASE (SQL Server Transact-SQL)。不要针对复制数据库使用此过程。 |
安全说明 |
---|
建议您不要附加或还原来自未知或不可信来源的数据库。此类数据库可能包含恶意代码,这些代码可能会执行非预期的 Transact-SQL 代码,或者通过修改架构或物理数据库结构导致错误。使用来自未知源或不可信源的数据库前,请在非生产服务器上针对数据库运行 DBCC CHECKDB,然后检查数据库中的代码,例如存储过程或其他用户定义代码。 |
适用范围:SQL Server(SQL Server 2008 到当前版本)。 |
语法
sp_attach_single_file_db [ @dbname= ] 'dbname'
, [ @physname= ] 'physical_name'
参数
[ @dbname= ] 'dbname'
要附加到该服务器的数据库的名称。 该名称必须是唯一的。 dbname 的数据类型为 sysname,默认值为 NULL。[ @physname= ] 'physical_name'
数据库文件的物理名称,包括路径。 physical_name 的数据类型为 nvarchar(260),默认值为 NULL。备注
此参数映射到 CREATE DATABASE 语句的 FILENAME 参数。有关详细信息,请参阅 CREATE DATABASE (SQL Server Transact-SQL)。
当将包含全文目录文件的 SQL Server 2005 数据库附加到 SQL Server 2014 服务器实例上时,会将目录文件从其以前的位置与其他数据库文件一起附加,这与在 SQL Server 2005 中的情况相同。 有关详细信息,请参阅升级全文搜索。
返回代码值
0(成功)或 1(失败)
结果集
无
注释
仅对先前通过显式 sp_detach_db 操作从服务器分离的数据库或复制的数据库使用 sp_attach_single_file_db。
sp_attach_single_file_db 仅对具有单个日志文件的数据库起作用。 sp_attach_single_file_db 在将数据库附加到服务器时,它会生成一个新的日志文件。 如果该数据库是只读数据库,则会在日志文件的先前位置生成日志文件。
备注
不能分离或附加数据库快照。
不要针对复制数据库使用此过程。
权限
有关在附加数据库时如何处理权限的信息,请参阅 CREATE DATABASE (SQL Server Transact-SQL)。
示例
以下示例分离 AdventureWorks2012 ,然后将 AdventureWorks2012 中的一个文件附加到当前服务器。
USE master;
GO
EXEC sp_detach_db @dbname = 'AdventureWorks2012';
EXEC sp_attach_single_file_db @dbname = 'AdventureWorks2012',
@physname =
N'C:\Program Files\Microsoft SQL Server\MSSQL12.MSSQLSERVER\MSSQL\Data\AdventureWorks2012_Data.mdf';