SQL SERVER – Docker Volume and Persistent Storage

I have received some rave reviews of my article on SQL SERVER – How to Get Started with Docker Containers with Latest SQL Server?. It was amazing to hear that people really get started after reading my article on docker. One of the most popular questions I keep on receiving was what happens when we have to patch or upgrade SQL Server. Well, that is a fantastic question. In today’s blog, I will explain to you how we can get Docker Volume and Persistent Storage.

SQL SERVER - Docker Volume and Persistent Storage dockersqlserver

Docker and Setup

Before you start reading the blog post, I strongly suggest that you read my previous blog post in detail as I am not going to repeat any steps from the previous blog post about Getting Started with Docker Containers.

In my previous blog post, I provided script where we have storage which is mapped to my Windows Drive and when I remove my container all the data, etc will go away and whenever I install new container, I will have to repeat all the steps.

Patching and Upgrading Challenge

For example, when I wrote the blog post at the time SQL Server 2019 CTP 2.3 was available. Now SQL Server 2019 CTP 2.4 was available. The challenge was if I upgrade to SQL Server 2019 CTP 2.4 I will have to reinstall all the sample databases.

Think about it, whenever we are upgrading SQL Server installed on Windows, we have a very long and tedious process where we take the database from the previous server and restore them in the newer server. Additionally, we have to move all the security, etc stuff again and the process is not that simple.

However, with the help of persistent storage of Docker which is commonly known as Volume, the problem is actually resolved. Let us a demonstration of the same.

Docker Volume

First of all, follow all the steps until we install SQL Server from the blog post here.

Now whenever we are going to install SQL Server, instead of mapping local Windows Drive in SQL Server, let us map a volume name, which we will be referring to the future installations of SQL Server for Docker.

To test out first we will download two of the latest images to docker for SQL Server.

docker pull mcr.microsoft.com/mssql/server:2019-CTP2.3-ubuntu
docker pull mcr.microsoft.com/mssql/server:2019-CTP2.4-ubuntu

If you have already downloaded the image, you will get messages as displayed in the image below.

SQL SERVER - Docker Volume and Persistent Storage dockervolume1

Next, install SQL Server 2019 CTP2.3 with the help of the following command. Please make sure that you have mapped the local drive with the name, in our case we will name that as sqlvolume.

docker run -e "ACCEPT_EULA=Y" -e "SA_PASSWORD=Pass@Word1" `
-p 21143:1433 --name sql19-23t `
-v sqlvolume:/var/opt/mssql `
-d mcr.microsoft.com/mssql/server:2019-CTP2.3-ubuntu 

SQL SERVER - Docker Volume and Persistent Storage dockervolume2

Now the command above will create a Volume Storage with the local drive. You can check the same with the following command.

docker volume ls -a

SQL SERVER - Docker Volume and Persistent Storage dockervolume4

From the above result, we got the name of our container as 8617cc9fab1b. We will use that container name in our copy command as a prefix to the folder where we want to move our backup files.

Next, we will copy our sample databases from our local drive to container. However, before we do that we need the name of our container. Let us get that by running following command.

docker cp D:\Docker\AdventureWorks2017.bak 8617cc9fab1b:/var/opt/mssql/data/
docker cp D:\Docker\WideWorldImporters-Full.bak 8617cc9fab1b:/var/opt/mssql/data/

When you run above command the backup files are moved to Docker containers at the path which is mentioned over the link.

Now we will run following two SQL Commands to install our sample databases. Please note that following two commands we will run in the SQL Server Management Studio and hence first we will connect to our SQL Server on the port 21143.

SQL SERVER - Docker Volume and Persistent Storage dockervolume5

Here are two PowerShell script to install our sample databases.

RESTORE DATABASE [AdventureWorks2014]
FROM DISK = N'/var/opt/mssql/data/AdventureWorks2017.bak'
MOVE N'AdventureWorks2017' TO N'/var/opt/mssql/data/AdventureWorks.mdf',
MOVE N'AdventureWorks2017_log' TO N'/var/opt/mssql/data/AdventureWorks_log.ldf',
RESTORE DATABASE [WideWorldImporters]
FROM DISK = N'/var/opt/mssql/data/WideWorldImporters-Full.bak'
MOVE N'WWI_Primary' TO N'/var/opt/mssql/data/WideWorldImporters.mdf',
MOVE N'WWI_UserData' TO N'/var/opt/mssql/data/WideWorldImporters_UserData.ndf',
MOVE N'WWI_Log' TO N'/var/opt/mssql/data/WideWorldImporters.ldf',
MOVE N'WWI_InMemory_Data_1' TO N'/var/opt/mssql/data/WideWorldImporters_InMemory_Data_1',

The above commands will successfully install SQL Server sample databases. Now go to SSMS and expand the database node in Object Explorer and here you will see two databases.

SQL SERVER - Docker Volume and Persistent Storage dockervolume6

Now our task is to upgrade our database to SQL Server 2019 CTP 2.4. Let us see how fast and efficiently we can do the same. Remember in the traditional SQL Server method, this would require lots of logistics but in our case, it will be very quick.

First, we will stop the SQL Server which is running currently.

docker stop sql19-23t

Next, we will install start up SQL Server 2019 CTP 2.4 docker image by running the following command which will be using the same storage like SQL Server 2019 cTP 2.3.

docker run -e "ACCEPT_EULA=Y" -e "SA_PASSWORD=Pass@Word1" `
-p 21143:1433 --name sql19-24t `
-v sqlvolume:/var/opt/mssql `
-d mcr.microsoft.com/mssql/server:2019-CTP2.4-ubuntu 

SQL SERVER - Docker Volume and Persistent Storage dockervolume7

Once the process is complete. Go to back to SQL Server Management Studio and disconnect from the previous connection. Wait for about 30 to 60 seconds and attempt to connect again. During the time, SQL Server will internally automatically upgrade SQL Server to the latest version of SQL Server which we just started.

Once connected, expand the database note and you will see that the same database which you had earlier installed in SQL Server 2019 CTP 2.3 now exists in SQL Server 2019 CTP 2.4. I have also tested by creating user objects in the same database and they all exist after upgrading to the latest version of SQL Server.

SQL SERVER - Docker Volume and Persistent Storage dockervolume8

I guess that’s it. We learn how we can build a Persistent Storage with Docker Volumes for SQL Server.

Reference: Pinal Dave (https://blog.sqlauthority.com)

Docker, Powershell, SQL Data Storage, SQL Scripts, SQL Server
Previous Post
SQL SERVER – Audit Script to Get CPU and Memory Information with MAXDOP Guidelines
Next Post
Download SQL Server Management Studio 18.0 (General Availability)

Related Posts

3 Comments. Leave new

  • Eric Reitsma
    May 1, 2019 2:27 pm

    RESTORE DATABASE [AdventureWorks2014]
    should be
    RESTORE DATABASE [AdventureWorks2017]

    if you want to have no ambiguity if you restore other AdventureWorks databases in the same container

  • ExcelsiorXaviercomachenchea
    August 2, 2019 5:54 pm

    How does the new 2.4 image , which is where SQL is installed, know to start the databases on the volume? Even if you put the system databases on the external volume, how does the SQL configuration on the system know where they are?

  • I had high hopes for using Docker containers to make the process of doing CU updates easier. But in my testing I have discovered that Linux containers are not Active Directory aware which is a deal breaker. And Windows containers cannot map a host volume to the default data/log/backup path that comes with the images you download from MS’s repository. Which means I cannot persist the system databases and all their critical information. Unless I have missed something…


Leave a Reply