237

Does anyone know how I can copy a SQL Azure database to my development machine? I'd like to stop paying to have a development database in the cloud, but it's the best way to get production data. I copy my production database to a new development database but I'd like to have that same database local.

Any suggestions?

1
  • 8
    This has gotten dramatically easier. See Atom's answer below (Feb 2018) explaining how to use Tasks=>Deploy Database... in SSMS. Commented Oct 23, 2018 at 22:30

25 Answers 25

153

Copy Azure database data to local database: Now you can use the SQL Server Management Studio to do this as below:

  • Connect to the SQL Azure database.
  • Right click the database in Object Explorer.
  • Choose the option "Tasks" / "Deploy Database to SQL Azure".
  • In the step named "Deployment Settings", connect local SQL Server and create New database.

enter image description here

Next -> Next -> Finish

4
  • 21
    Awesome👏🏻 this is not so clear in SSMS since the "deploy database to SQL AZURE" is somewhat misleading...
    – EeKay
    Commented May 17, 2018 at 7:45
  • 28
    By far the easiest solution mixed with by far the most misleading menu name. Thank you for posting this. Commented Jan 25, 2019 at 15:10
  • 2
    This is simplest, but the drawback is that you cannot pick which tables you want to backup and which you don't want. In my company, we have an Attachment table that contains Gigabytes of attachments (pictures, etc). Normally we don't want this as it will be forever to copy. We can't exclude this table using this method. Commented May 4, 2020 at 9:56
  • lol "Create New File" "You can also use this Menu Item to Delete A File"
    – Dirk Boer
    Commented Dec 21, 2023 at 17:15
148

There are multiple ways to do this:

  1. Using SSIS (SQL Server Integration Services). It only imports data in your table. Column properties, constraints, keys, indices, stored procedures, triggers, security settings, users, logons, etc. are not transferred. However it is very simple process and can be done simply by going through wizard in SQL Server Management Studio.
  2. Using combination of SSIS and DB creation scripts. This will get you data and all missing metadata that is not transferred by SSIS. This is also very simple. First transfer data using SSIS (see instructions below), then create DB Create script from SQL Azure database, and re-play it on your local database.
  3. Finally, you can use Import/Export service in SQL Azure. This transfers data (with a schema objects) to Azure Blob Storage as a BACPAC. You will need an Azure Storage account and do this in Azure web portal. It is as simple as pressing an "Export" button in the Azure web portal when you select the database you want to export. The downside is that it is only manual procedure, I don't know a way to automate this through tools or scripts -- at least the first part that requires a click on the web page.

Manual procedure for method #1 (using SSIS) is the following:

  • In Sql Server Management Studio (SSMS) create new empty database on your local SQL instance.
  • Choose Import Data from context menu (right click the database -> Tasks -> Import data...)
  • Type in connection parameters for the source (SQL Azure). Select ".Net Framework Data Provider for SqlServer" as a provider.
  • Choose existing empty local database as destination.
  • Follow the wizard -- you will be able to select tables data you want to copy. You can choose to skip any of the tables you don't need. E.g. if you keep application logs in database, you probably don't need it in your backup.

You can automate it by creating SSIS package and re-executing it any time you like to re-import the data. Note that you can only import using SSIS to a clean DB, you cannot do incremental updates to your local database once you already done it once.

Method #2 (SSID data plus schema objects) is very simple. First go though a steps described above, then create DB Creation script (righ click on database in SSMS, choose Generate Scripts -> Database Create). Then re-play this script on your local database.

Method #3 is described in the Blog here: http://dacguy.wordpress.com/2012/01/24/sql-azure-importexport-service-has-hit-production/. There is a video clip with the process of transferring DB contents to Azure Blob storage as BACPAC. After that you can copy the file locally and import it to your SQL instance. Process of importing BACPAC to Data-Tier application is described here: http://msdn.microsoft.com/en-us/library/hh710052.aspx.

21
  • 2
    This works, just one correction. In the Server Import/Export wizard the Data source is '.Net Framework Data Provider for SqlServer'
    – BZink
    Commented Mar 31, 2011 at 1:10
  • Great! Thanks for correction. I remember one of the provider worked and some others did not work for me, but did not recall exactly which one.
    – seva titov
    Commented Mar 31, 2011 at 1:42
  • Fails for me: 'Failure inserting into the read-only column "id"'
    – dumbledad
    Commented Jun 26, 2012 at 15:25
  • 3
    The trick for me was to start replicating PKs/FKs/constraints on empty DB, then temporarily disable constraints while importing data. More precisely: 1-Create empty target DB manually. 2-Right-click source DB > Tasks > Generate Scripts. 3-Run script file on empty target DB (now DB has correct PKs/FKs/constraints, but no data). 4-Disable all constraints (stackoverflow.com/a/161410). 5-Import data (Right-click target DB > Tasks > Import Data). 6-Re-enable constraints. Hope this helps! Commented May 26, 2014 at 22:22
  • 1
    @JoSmo, methods #1 and #2 do not require storage account. However I would recommend to have a storage account in the same datacenter as your SQL Azure database is. The reason is you can use it for DB backups and restore. If you don't have administrative permissions for your Azure subscription, Find someone in your organization who has enough rights to create new storage accounts and give you access keys to it. Since you already have access to database, there is no reason deny access to storage account.
    – seva titov
    Commented Jun 16, 2016 at 4:53
54

In SQL Server 2016 Management Studio, the process for getting an azure database to your local machine has been streamlined.

Right click on the database you want to import, click Tasks > Export data-tier application, and export your database to a local .dacpac file.

In your local target SQL server instance, you can right click Databases > Import data-tier application, and once it's local, you can do things like backup and restore the database.

1
  • 8
    This is it. NB. "Export data-tier" includes data, "Extract data-tier" gives you definitions only
    – Colin
    Commented Jun 15, 2017 at 12:43
37
Answer recommended by Microsoft Azure Collective

I just wanted to add a simplified version of dumbledad's answer, since it is the correct one.

  1. Export the Azure SQL Database to a BACPAC file on blob storage.
  2. From inside SQL Management studio, right-click your database, click "import data-tier application".
  3. You'll be prompted to enter the information to get to the BACPAC file on your Azure blob storage.
  4. Hit next a couple times and... Done!
3
  • 4
    I get an error saying target cannot be sql azure v12? Commented Mar 24, 2016 at 7:32
  • 2
    Make sure you have a version of SSMS that will import that BACPAC: msdn.microsoft.com/en-us/library/mt238290.aspx Commented Nov 7, 2016 at 10:54
  • Even with this version of SSMS I still get an error because of target Azure sql db 12.
    – Preza8
    Commented Apr 25, 2018 at 12:06
22

I think it is a lot easier now.

  1. Launch SQL Management Studio
  2. Right Click on "Databases" and select "Import Data-tier application..."
  3. The wizard will take you through the process of connecting to your Azure account, creating a BACPAC file and creating your database.

Additionally, I use Sql Backup and FTP (https://sqlbackupandftp.com/) to do daily backups to a secure FTP server. I simply pull a recent BACPAC file from there and it import it in the same dialog, which is faster and easier to create a local database.

0
10

You can also check out SQL Azure Data Sync in the Windows Azure Management Portal. It allows you to retrieve and restore an entire database, including schema and data between SQL Azure and SQL Server.

2
  • 2
    SQL Data Sync should not be used as part of your backup strategy as there are several limitations. It does not version, it only backs up data and no other objects. For more information, see the SQL Data Sync FAQ topic. (msdn.microsoft.com/en-us/library/windowsazure/jj650016.aspx) Commented Jul 26, 2013 at 14:52
  • 1
    Data Sync is pretty awful - even today (several years after this post) there are a ton of bugs and it can really screw up your db - it also still has a lot of limitations.
    – William
    Commented Jun 26, 2018 at 20:26
7

Using msdeploy.exe

Caveat: msdeploy.exe fails to create the destination database on its own, so you need to create it manually first.

  1. Copy the connection string on the database properties page. Adjust it so that it contains a correct password. database properties page
  2. Get the connection string for the destination DB.
  3. Run msdeploy.exe like this:

    "c:\Program Files\IIS\Microsoft Web Deploy V3\msdeploy.exe" -verb:sync -dest:dbDacFx="destination_DB_connection_string",dropDestinationDatabase=true -source:dbDacFx="azure_DB_connection_string",includeData=true -verbose
    

Using SqlPackage.exe

  1. Export the azure DB to a bacpac package.

    "c:\Program Files (x86)\Microsoft SQL Server\110\DAC\bin\SqlPackage.exe" /a:Export /ssn:"azure_db_server" /sdn:"azure_db_name" /su:"user_name" /sp:"password" /tf:"file.bacpac"
    
  2. Import the package to a local DB.

    "c:\Program Files (x86)\Microsoft SQL Server\110\DAC\bin\SqlPackage.exe" /a:Import /SourceFile:"file.bacpac" /TargetServerName:".\SQLEXPRESS" /TargetDatabaseName:CopyOfAzureDb
    
0
5

It's pretty easy. This worked for me...in terms of getting an Azure SQL database down onto your local machine...:

  1. Open your SQL Management Studio and connect to your Azure SQL Server.
  2. Select the database you would like to get down onto your local machine, and right-click...select "Generate Scripts". Follow the prompts...

BUT, be careful in that if you ALSO want the DATA, as well as the scripts, be sure to check the Advanced Options before beginning the generating...scroll down to "Types of data to script", and make sure you have "Schema and data"...or whatever is appropriate for you.

It will give you a nice SQL script file which can then be run on your local machine and it will create the database as well as populate it with all the data.

Bare in mind that in my case, I have no FK or other constraints...also, it wasn't a lot of data.

I don't recommend this as a backup mechanism in general...

1
  • 3
    I have to say this worked remarkably well with no fuss; foreign keys recreated perfectly. The resulting SQL script was too large to open in SSMS, or indeed in many text editors, but I was able to use the command line sqlcmd /S <server> /d <database> -E -i <azure_dump.sql>
    – perlyking
    Commented Jul 5, 2017 at 7:52
5

In SQL Server Management Studio

Right click on the database you want to import, click Tasks > Export data-tier application, and export your database to a local .dacpac file.

In your local target SQL server instance, you can right click Databases > Import data-tier application, and once it's local, you can do things like backup and restore the database.

0
4

Using SSMS v18.9+, you can use the Deploy Database to Microsoft Azure SQL Database.

It's not really intuitive, but the wizard allow you to select a local db even if the name of the task is Deploy Database to Microsoft Azure SQL Database.

  1. Connect to your Azure Database using SSMS
  2. Right-click on the database, select Tasks > Deploy Database to Microsoft Azure SQL Database. enter image description here
  3. Select your local SQL server as the target connection. enter image description here
  4. Follow the additional steps.
4

Looks like the functionality is missing from Management Studio in 2022. Here is how I do it using Azure Data Studio:

  1. Install Azure Data Studio
  2. Open Azure Data Studio
  3. Install the extension called Admin Pack for SQL Server
  4. Restart Azure Data Studio
  5. Setup connections for both source database (Azure) and destination (local machine)
  6. Execute statement in your local DB Engine on master database:
    sp_configure 'contained database authentication', 1; 
    GO  
    RECONFIGURE;
    GO
    
  7. Right click on source database and select Data-tier Application Wizard.
    Select Export to .bacpac file [Export bacpac] (4th, last option in my current version)
  8. Finish the wizard
  9. Right click on destination database and select Data-tier Application Wizard
  10. Select Import from .bacpac [Import bacpac] (3rd option in my version)
  11. Select the .bacpac file previously created and finish the wizard

After importing the logins and users are created, but their default schema isn’t set. If default schema is required that needs to be handled manually. In that case:

Open an admin connection to the local copy and run:

USE [imported-db];

ALTER USER imported-user WITH DEFAULT_SCHEMA = whatever;
1
  • I had to put the commands sp_configure 'contained database authentication', 1; GO; RECONFIGURE; GO; on separate lines
    – DLT
    Commented Sep 27, 2022 at 23:26
3

I always use Import/Export Feature which seems to be the easiest one among all.

Step 1:

Get the backup from the azure instance as follows, Select the database → Right click → Tasks → Export Data Tier Application.

Step 2: Give a specific name for the backup file and save it in your desired location

Step 3: That's it you have taken a backup of the database from sql instance to your local. Lets restore it to the local. Copy the backed up database to your C drive. Now open the PowerShell with administrator rights and navigate to C drive

Step 4: Lets download the powershell script to remove the master keyRemoveMasterKey.ps1 have the script on the same drive in this case its C.

Step 5 : Run the script as follows, .\RemoveMasterKey.ps1 -bacpacPath "C:\identity.bacpac"

That's it, now you can restore it on MSSQL 2017 in your local environment.

Step 6: Connect to your local server, and click Databases → Import-Data-Tier-Application

Step 7 : Give a name for your database to restore.

Now you will see everything in green!

Read my blog with diagrams.

3
  • your powershell link is no longer valid... Just curious what it is supposed to do?
    – pcnate
    Commented Dec 17, 2020 at 19:57
  • It removes master database from your backup file, if taken in backup mistakenly. Commented Apr 24 at 4:27
  • I did it on particular database and not master, I didn't needed 4th and 5th step. It worked fine. Commented Apr 24 at 4:28
2

I couldn't get the SSIS import / export to work as I got the error 'Failure inserting into the read-only column "id"'. Nor could I get http://sqlazuremw.codeplex.com/ to work, and the links above to SQL Azure Data Sync didn't work for me.

But I found an excellent blog post about BACPAC files: http://dacguy.wordpress.com/2012/01/24/sql-azure-importexport-service-has-hit-production/

In the video in the post the blog post's author runs through six steps:

  1. Make or go to a storage account in the Azure Management Portal. You'll need the Blob URL and the Primary access key of the storage account.

  2. The blog post advises making a new container for the bacpac file and suggests using the Azure Storage Explorer for that. (N.B. you'll need the Blob URL and the Primary access key of the storage account to add it to the Azure Storage Explorer.)

  3. In the Azure Management Portal select the database you want to export and click 'Export' in the Import and Export section of the ribbon.

  4. The resulting dialogue requires your username and password for the database, the blob URL, and the access key. Don't forget to include the container in the blob URL and to include a filename (e.g. https://testazurestorage.blob.core.windows.net/dbbackups/mytable.bacpac).

  5. After you click Finish the database will be exported to the BACPAC file. This can take a while. You may see a zero byte file show up immediately if you check in the Azure Storage Explorer. This is the Import / Export Service checking that it has write access to the blob-store.

  6. Once that is done you can use the Azure Storage Explorer to download the BACPAC file and then in the SQL Server Management Studio right-click your local server's database folder and choose Import Data Tier Application that will start the wizard which reads in the BACPAC file to produce the copy of your Azure database. The wizard can also connect directly to the blob-store to obtain the BACPAC file if you would rather not copy it locally first.

The last step may only be available in the SQL Server 2012 edition of the SQL Server Management Studio (that's the version I am running). I do not have earlier ones on this machine to check. In the blog post the author uses the command line tool DacImportExportCli.exe for the import which I believe is available at http://sqldacexamples.codeplex.com/releases

1
  • While I didn't follow this exactly, it lead me in the right direction. You can skip the download of the bacpac file and point to the Azure Blob storage directly from inside SQL Server Management Studio.
    – Josh Mouch
    Commented May 15, 2013 at 10:53
2

Regarding the " I couldn't get the SSIS import / export to work as I got the error 'Failure inserting into the read-only column "id"'. This can be gotten around by specifying in the mapping screen that you do want to allow Identity elements to be inserted.

After that, everything worked fine using SQL Import/Export wizard to copy from Azure to local database.

I only had SQL Import/Export Wizard that comes with SQL Server 2008 R2 (worked fine), and Visual Studio 2012 Express to create local database.

2

The accepted answer is out of date. I found a better answer: Use Import Data-tier Application

More detailed information please see this article: Restoring Azure SQL Database to a Local Server

2

You can try with the tool "SQL Database Migration Wizard". This tool provide option to import and export data from azure sql.

Please check more details here.

https://sqlazuremw.codeplex.com/

1

You can use the new Azure Mobile Services to do a nightly backup export from SQL Azure to a .bacpac file hosted in Azure Storage. This solution is 100% cloud, doesn't require a 3rd party tool and doesn't require a local hosted SQL Server instance to download/copy/backup anything.

There's about 8 different steps, but they're all easy: http://geekswithblogs.net/BenBarreth/archive/2013/04/15/how-to-create-a-nightly-backup-of-your-sql-azure.aspx

2
  • This looks really promising! Any idea if this will work with Azure Federations? Commented May 6, 2013 at 13:32
  • @Tim sorry I don't know. Doing this thru Mobile Services is a workaround to begin with, so I wouldn't be surprised if it doesn't. Commented May 10, 2013 at 15:03
0

Download Optillect SQL Azure Backup - it has 15-day trial, so it will be enough to move your database :)

1
0

The trick for me was to start replicating PKs/FKs/constraints on empty DB, then temporarily disable constraints while importing data (see https://stackoverflow.com/a/161410).

More precisely:

  1. Create empty target DB manually;
  2. Right-click source DB > Tasks > Generate Scripts;
  3. Run script file on empty target DB (now DB has correct PKs/FKs/constraints, but no data);
  4. Disable all constraints;
  5. Import data (Right-click target DB > Tasks > Import Data);
  6. Re-enable constraints.

Hope this helps!

0

Now you can use the SQL Server Management Studio to do this.

  • Connect to the SQL Azure database.
  • Right click the database in Object Explorer.
  • Choose the option "Tasks" / "Deploy Database to SQL Azure".
  • In the step named "Deployment Settings", select your local database connection.
  • "Next" / "Next" / "Finish"...
1
  • I couldn't do this because that "Next" button is greyed out until I select another Azure database as the target connection
    – Colin
    Commented Jun 15, 2017 at 11:05
0

Use the Import/Export service in SQL Azure to create a .bacpac file.

Then take a look at this method in another Stack Overflow article.

Azure SQL Database Bacpac Local Restore

0

If anyone has a problem to import a Bacpac of a DB that uses Azure SQL Sync, Sandrino Di Mattia developed a great simple application to solve this.

  1. Export a Bacpac of your DB
  2. Dowload Di Mattia's binary
  3. With this console app repair the downloaded Bacpac
  4. Lauch SSMS
  5. Right Click on "Databases" and select "Import Data-tier Application"
  6. Select the repaired Bacpac.
0

If anyone wants a free and effective option (and don't mind doing it manually) to backup database to Local then use schema and data comparison functionality built into the latest version Microsoft Visual Studio 2015 Community Edition (Free) or Professional / Premium / Ultimate edition. It works like a charm!

I have BizPark account with Azure and there is no way to backup database directly without paying. I found this option in VS works.

Answer is taken from https://stackoverflow.com/a/685073/6796187

0

Hi I'm using the SQLAzureMW tool for SQLAzure DB migration and management. Very useful one. It was downloaded from codeplex, but currently it's not available the codeplex will be going to shutdown, the same application tool is now available in GttHub. This below link is explain how to use this tool and also available the Application for download.

https://github.com/twright-msft/azure-content/blob/master/articles/sql-database/sql-database-migration-wizard.md

0

1- Get your database bacpac file:

  • Go to your Azure Sql Server instance
  • Go to your database
  • Get your database bacpac by clicking on the export button and finishing the wizard (you need a storage resource to store your bacpac file)
  • Go to the storage that you have specified in the previous step and download the bacpac file.

2- Restoring the bacpac file on your local machine:

  • Install a SQL Server on your local machine.
  • Download Azure Data Studio and connect to the server installed in previous step.
  • Install SQL Server dacpac extension in Azure Data Studio.
  • Right click on your SQL server and select Data-tier Application Wizard
  • Select Create a database from a .bacpac file
  • Fill the required fields.
  • Done

Not the answer you're looking for? Browse other questions tagged or ask your own question.