项目
04/01/2012

sp_attach_single_file_db (Transact-SQL)

将只有一个数据文件的数据库附加到当前服务器。sp_attach_single_file_db 不能用于多个数据文件。

重要提示
后续版本的 Microsoft SQL Server 将删除该功能。请避免在新的开发工作中使用该功能，并着手修改当前还在使用该功能的应用程序。，我们建议您改用 CREATE DATABASE database_name FOR ATTACH。有关详细信息，请参阅CREATE DATABASE (Transact-SQL)。不要针对复制数据库使用此过程。

安全说明
建议您不要附加或还原来自未知或不可信来源的数据库。此类数据库可能包含恶意代码，这些代码可能会执行非预期的 Transact-SQL 代码，或者通过修改架构或物理数据库结构导致错误。在使用未知或不可信源中的数据库之前，请在非生产服务器中的数据库上运行 DBCC CHECKDB，同时检查数据库中的代码（例如，存储过程或其他用户定义代码）。

建议您不要附加或还原来自未知或不可信来源的数据库。此类数据库可能包含恶意代码，这些代码可能会执行非预期的 Transact-SQL 代码，或者通过修改架构或物理数据库结构导致错误。在使用未知或不可信源中的数据库之前，请在非生产服务器中的数据库上运行 DBCC CHECKDB，同时检查数据库中的代码（例如，存储过程或其他用户定义代码）。

主题链接图标 Transact-SQL 语法约定

语法

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 (Transact-SQL)。

当将包含全文目录文件的 SQL Server 2005 数据库附加到 SQL Server 2008 R2 服务器实例上时，会将目录文件从其以前的位置与其他数据库文件一起附加，这与在 SQL Server 2005 中的情况相同。有关详细信息，请参阅全文搜索升级。

注意
此参数映射到 CREATE DATABASE 语句的 FILENAME 参数。有关详细信息，请参阅 CREATE DATABASE (Transact-SQL)。

返回代码值

0（成功）或 1（失败）

结果集

无

注释

仅对先前通过显式 sp_detach_db 操作从服务器分离的数据库或复制的数据库使用 sp_attach_single_file_db。

sp_attach_single_file_db 仅对具有单个日志文件的数据库起作用。sp_attach_single_file_db 在将数据库附加到服务器时，它会生成一个新的日志文件。如果该数据库是只读数据库，则会在日志文件的先前位置生成日志文件。

注意
不能分离或附加数据库快照。

不要针对复制数据库使用此过程。

权限

有关在附加数据库时如何处理权限的信息，请参阅 CREATE DATABASE (Transact-SQL)。

示例

以下示例分离 AdventureWorks2008R2，然后将 AdventureWorks2008R2 中的一个文件附加到当前服务器。

USE master;
GO
EXEC sp_detach_db @dbname = 'AdventureWorks2008R2';
EXEC sp_attach_single_file_db @dbname = 'AdventureWorks2008R2', 
    @physname = N'C:\Program Files\Microsoft SQL Server\MSSQL10_50.MSSQLSERVER\MSSQL\Data\AdventureWorks2008R2_Data.mdf';