sp_attach_db (Transact-SQL)

语法

sp_attach_db [ @dbname= ] 'dbname'
        , [ @filename1= ] 'filename_n' [ ,...16 ] 

参数

• [ @dbname= ] **'**dbnam '
  要附加到该服务器的数据库的名称。该名称必须是唯一的。dbname 的数据类型为 sysname，默认值为 NULL。

• [ @filename1= ] 'filename_n'
  数据库文件的物理名称，包括路径。filename_n 的数据类型为 nvarchar(260)，默认值为 NULL。最多可以指定 16 个文件名。参数名称从 @filename1 开始，一直增加到 @filename16。文件名列表至少必须包括主文件。主文件中包含指向数据库中其他文件的系统表。该列表还必须包括在数据库分离之后移动的所有文件。

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

返回代码值

0（成功）或 1（失败）

结果集

无

注释

只应对以前使用显式 sp_detach_db 操作从数据库服务器分离的数据库或复制的数据库执行 sp_attach_db 存储过程。如果必须指定 16 个以上的文件，请使用 CREATE DATABASE database_name FOR ATTACH 或 CREATE DATABASE database_name FOR_ATTACH_REBUILD_LOG。有关详细信息，请参阅 CREATE DATABASE (Transact-SQL)。

假设所有未指定文件都位于其上次的已知位置。若要使用不同位置的文件，则必须指定新位置。

无法在早期版本的 SQL Server 中附加由较新版本的 SQL Server 创建的数据库。

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

当您附加已复制的数据库而不是分离的数据库时，请注意以下事项：

• 如果将数据库附加到与原始数据库相同的服务器实例和版本，则不需要执行其他步骤。

• 如果您将数据库附加到同一个服务器实例，但是版本已升级，则必须执行 sp_vupgrade_replication 才能在附加操作完成后升级复制。

• 如果您将数据库附加到不同的服务器实例，而不考虑版本，则必须执行 sp_removedbreplication 才能在附加操作完成后删除复制。

源数据库的版本必须至少为 80 (SQL Server 2000)，才能附加到 SQL Server 2008 R2 或 SQL Server 2008。附加兼容级别低于 80 的 SQL Server 2000 或 SQL Server 2005 数据库时，会将其兼容级别设置为 80。

权限

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

示例

下例将 AdventureWorks2008R2 中的文件附加到当前服务器。

EXEC sp_attach_db @dbname = N'AdventureWorks2008R2', 
    @filename1 = N'C:\Program Files\Microsoft SQL Server\MSSQL10_50.MSSQLSERVER\MSSQL\Data\AdventureWorks2008R2_Data.mdf', 
    @filename2 = N'C:\Program Files\Microsoft SQL Server\MSSQL10_50.MSSQLSERVER\MSSQL\Data\AdventureWorks2008R2_log.ldf';

请参阅

参考

概念