what’s the issue with AttachDbFilename

Using User Instance means that SQL Server is creating a special copy of that database file for use by your program. If you have two different programs using that same connection string, they get two entirely different copies of the database. This leads to a lot of confusion, as people will test updating data with their program, then connect to a different copy of their database in Management Studio, and complain that their update isn’t working. This sends them through a flawed series of wild goose chase steps trying to troubleshoot the wrong problem.

This article goes into more depth about how to use this feature, but heed the very first note: the User Instance feature has been deprecated. In SQL Server 2012, the preferred alternatives are (in this order, IMHO):

  1. Create or attach your database to a real instance of SQL Server. Your connection string will then just need to specify the instance name, the database name, and credentials. There will be no mixup as Management Studio, Visual Studio and your program(s) will all be connecting to a single copy of the database.

  2. Use a container for local development. Here’s a great starter video by Anna Hoffman and Anthony Nocentino, and I have some other resources here, here, and here. If you’re on an M1 Mac, you won’t be able to use a full-blown SQL Server instance, but you can use Azure SQL Edge if you can get by with most SQL Server functionality (the omissions are enumerated here).

  3. Use SqlLocalDb for local development. I believe I pointed you to this article yesterday: “Getting Started with SQL Server 2012 Express LocalDB.”

  4. Use SQL Server Compact. I like this option the least because the functionality and syntax is not the same – so it’s not necessarily going to provide you with all the functionality you’re ultimately going to want to deploy. Compact Edition is also deprecated, so there’s that.

Of course if you are using a version < SQL Server 2012, SqlLocalDb is not an option – so you should be creating a real database and using that consistently. I only mention the Compact option for completeness – I think that can be almost as bad an idea as using AttachDbFileName.

EDIT: I’ve blogged about this here:

Leave a Comment