How do I attach a database to SQL Server?

What Is Detach or Attach and How do They Work?

We'll start with detaching. When you detach a database in SQL Server, you are taking the database offline and removing it from the SQL Server instance from which you are detaching it. The database’s data and log files remain intact and are left in a consistent state so you can then pursue SQL server attach the database. Attach connects the data and log files from a database that has been properly detached (or that were copied from a cleanly shut down instance of SQL Server) to an instance of SQL Server and brings the database online.

How Do I Detach a Database?

You can do this in T-SQL or from the SQL Server Management Studio GUI.In the GUI, you right-click on the database you wish to detach, select All Tasks and click on Detach. From there you'll get the detach dialog. You can choose to drop connections first to forcibly disconnect any active connections and rollback work they were in the middle of executing. You can also choose to update statistics before the detach.

In T-SQL: -- You don't want to be in the database you are trying to detach USE Master GO -- Optional step to drop all active connections and roll back their work ALTER DATABASE DatabaseName SET SINGLE_USER WITH ROLLBACK IMMEDIATE GO -- Perform the detach EXEC sp_detach_db 'DatabaseName' GO

For the system stored procedure sp_detach_db there are two parameters that you can pass in optionally:

@skipchecks - acceptable input is 'True' or 'False' if 'True', SQL Server will update statistics before detach. If 'False', it won't. If you don't specify anything here the statistics will be updated in SQL Server 2005 or later.

@keepfulltextindexfile - The default here is 'True' - if this is set to true, the full-text index metadata will not be dropped during the detach.

To see a lot more about detach and some more details on the risks I highlight below, the Books Online article for sp_detach_db is a good place to start.

How Do I Attach a Database?

You can also do this in T-SQL or from the SQL Server Management Studio GUI.

(NOTE: If you have the data and log files from a database that was not properly detached, your attach may not work. When detach occurs, the database is brought offline and the log and data files are put into a consistent state. This also happens when a service is cleanly shut down.)

In the GUI, you right-click on the top-level Databases folder for your instance and select Attach. In the next dialog, you would then select the primary data file (.MDF) of the database you wish to attach and ensure you have the other files selected and their appropriate locations specified, and click OK, attaching your database.

In T-SQL the best way to do this in SQL Server 2005 and forward is through the CREATE DATABASE command. This is the method that is supported beyond SQL Server 2012. If you want to see how to use sp_attach_db, you can see that in the books online articles for [sp_attach_db][3] or [sp_attach_single_file_db][4]

When you have your log file and data files available and they are consistent this is the T-SQL approach:

-- Using Create Database and the FOR ATTACH clause to attach

CREATE DATABASE DatabaseName ON (FILENAME = 'FilePathFileName.mdf'), -- Main Data File .mdf (FILENAME = 'FilePathLogFileName.ldf'), -- Log file .ldf (FILENAME = 'FilePathSecondaryDataFile.ndf) -- Optional - any secondary data files FOR ATTACH GO

You can see more about the Create Database statement in books online as well.

How Do I Detach/Attach in SQL Server Express?

It's actually the same. If you are using SQL Server Management Studio Express you can use the detach/attach dialog in the GUI described above or the T-SQL steps through SSMS Express described above as well. No difference with Express there. If you don't have SSMS Express, you can download it (Here is the SQL Server 2012 Express version). Of you can enter into an SQLCMD session and use the same T-SQL constructs described above.

First, a word on what detach and attach is not meant to be used for: Backup and Recovery Detach and Attach is not a way to backup your database for routine recovery purposes. There are no transaction log backups this way, it puts your database into a state where the database files can be deleted accidentally and is not a good way at all for this purpose.

• Sometimes for migrations (although I prefer backup/restore for those as discussed in my answer here)
  
• When you want to remove a database that is no longer actively used but has the ability to attach later as needed.
  
• In certain troubleshooting situations, this may be called upon
  
• Don't have the space to backup or to restore both data and log files to another environment (you shouldn't ever be here but I've used it to move dev databases around environments at times.. Didn't want or need the log so did an attach/rebuild of the log file)
  

Risks and Warnings

• Again, books online is a good resource here, but I'll call out some specific considerations to have in mind with detaching or attaching a database - Detach
• You are taking your database offline. It won't be accessible anymore. This should be obvious, but worth calling out. This is why it isn't a great backup option.
  
• When your database is online, SQL Server locks the files. I wouldn't recommend trying this to prove me wrong, because there could be some other situation at play, but you typically can't delete a database file (data, secondary data or log file) while SQL Server is online. This is a good thing. When you detach, you have no such protection - this can be a bad thing.
  
• If you are dealing with database corruption and you find some article someplace that has a first step of Detach - it's wrong - if you detach a corrupt database, that may be it. You may not be attaching that database again.
  
• Cutting and pasting your production database files throughout your network is a way to potentially introduce file-level corruption.. Another reason I prefer backup/restore when doing migrations.
  
• It might cause a maintenance plan to fail. The situation is that you have, as I did, set up a maintenance plan to carry out regular backups of all databases without checking best practices. This works fine so you stop thinking about it. Someone else then decides to take a database they're not using offline. The maintenance plan will fail from that point forwards until you modify the maintenance plan by checking the "ignore databases whose state is not online" option in the "Database(s)" dialog. Note that it won't just fail for the offline database - the maintenance plan will fail with an error at the point when it tries to back up the offline database so some online databases might not be backed up. (different author for this point so treat with suspicion)
  

Attach - Just like you shouldn't run scripts from the internet or accept packages from strangers at the airport, you shouldn't attach a database you got from someone else without some steps to verify it. This database could have code inside of it in triggers, stored procedures, etc. that could compromise your environment. You should review a database you want to attach in a safe, and firewalled environment, not your production system.

What About Different Versions or Editions of SQL Server?

These are no different than the rules around restoring databases between versions. You can generally restore up to the next version for 3 versions (SQL Server 2008 to SQL Server 2012, for example, will work. SQL Server 2000 to SQL Server 2012 will not). You cannot go backward at all via backup/restore or detach/attach - you'd have to script out objects and script out the inserts and do it manually or with a tool that does this. For editions, you can generally move between the main SKUs of SQL Server - for instance, you can move a database from Standard to Enterprise with no extra work. If you are using Enterprise features, you'll need to disable those features before you make the move, though. This will help you solve SQL server attach the database effectively!