Skip to content

Commit 9c38dd0

Browse files
authored
Merge pull request #34347 from MicrosoftDocs/main
6/6/2025 PM Publish
2 parents 7e4d1ef + aa4fb17 commit 9c38dd0

8 files changed

+335
-300
lines changed

azure-sql/virtual-machines/windows/backup-restore-to-url-using-managed-identities.md

Lines changed: 29 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
11
---
2-
title: Backup and restore to URL using managed identities
2+
title: Backup and Restore to URL Using Managed Identities
33
description: Learn how to back up and restore SQL Server databases to Azure Blob storage using managed identities for SQL Server on Azure VMs.
44
author: PratimDasgupta
55
ms.author: prdasgu
6-
ms.reviewer: vanto, mathoma
7-
ms.date: 02/16/2025
6+
ms.reviewer: vanto, mathoma, randolphwest
7+
ms.date: 06/06/2025
88
ms.service: azure-vm-sql-server
99
ms.subservice: security
1010
ms.topic: how-to
@@ -78,25 +78,45 @@ RESTORE DATABASE [AdventureWorks]
7878

7979
If a primary managed identity isn't assigned to the SQL Server on Azure VM, the backup and restore operations will fail with an error message indicating that the managed identity isn't selected.
8080

81-
```sql
81+
```output
8282
Msg 37563, Level 16, State 2, Line 14
8383
The primary managed identity is not selected for this server. Enable the primary managed identity for Microsoft Entra authentication for this server. For more information see (https://aka.ms/sql-server-managed-identity-doc).`
8484
```
8585

8686
### No `Storage Blob Data Contributor` role assigned
8787

88-
If the primary managed identity for the SQL Server on Azure VM isn't given the `Storage Blob Data Contributor` role to the storage account, the **BACKUP** operation will fail with an error message indicating that access is denied.
88+
If the primary managed identity for the SQL Server on Azure VM isn't given the `Storage Blob Data Contributor` role to the storage account, the `BACKUP` operation will fail with an error message indicating that access is denied.
8989

90-
```sql
90+
```output
91+
Msg 3201, Level 16, State 1, Line 31
92+
Cannot open backup device 'https://<storage-account-name>.blob.core.windows.net/<container-name>/AdventureWorks.bak'. Operating system error 5(Access is denied.).
93+
Msg 3013, Level 16, State 1, Line 31
94+
BACKUP DATABASE is terminating abnormally.
95+
```
96+
97+
If the managed identity for the SQL Server on Azure VM isn't given the `Storage Blob Data Contributor` role to the storage account, the `RESTORE` operation will fail with an error message indicating that access is denied.
98+
99+
```output
100+
Msg 3201, Level 16, State 1, Line 31
101+
Cannot open backup device 'https://<storage-account-name>.blob.core.windows.net/<container-name>/AdventureWorks.bak'. Operating system error 5(Access is denied.).
102+
Msg 3013, Level 16, State 1, Line 31
103+
RESTORE DATABASE is terminating abnormally.
104+
```
105+
106+
### Network or firewall issues
107+
108+
If you haven't configured valid network access to the Azure Blob storage, and Windows Firewall permissions on the host, to allow the outbound connection, and valid storage account service endpoints aren't configured, the `BACKUP` operation fails with an error message indicating that access is denied.
109+
110+
```output
91111
Msg 3201, Level 16, State 1, Line 31
92112
Cannot open backup device 'https://<storage-account-name>.blob.core.windows.net/<container-name>/AdventureWorks.bak'. Operating system error 5(Access is denied.).
93113
Msg 3013, Level 16, State 1, Line 31
94114
BACKUP DATABASE is terminating abnormally.
95115
```
96116

97-
If the managed identity for the SQL Server on Azure VM isn't given the `Storage Blob Data Contributor` role to the storage account, the **RESTORE** operation will fail with an error message indicating that access is denied.
117+
If you haven't configured valid network access to the Azure Blob storage, and Windows Firewall permissions on the host, to allow the outbound connection, and valid storage account service endpoints aren't configured, the `RESTORE` operation fails with an error message indicating that access is denied.
98118

99-
```sql
119+
```output
100120
Msg 3201, Level 16, State 1, Line 31
101121
Cannot open backup device 'https://<storage-account-name>.blob.core.windows.net/<container-name>/AdventureWorks.bak'. Operating system error 5(Access is denied.).
102122
Msg 3013, Level 16, State 1, Line 31
@@ -107,7 +127,7 @@ RESTORE DATABASE is terminating abnormally.
107127

108128
When the original database with the same name exists in the storage, the backup of a new database to the same storage path will fail with the following error:
109129

110-
```sql
130+
```output
111131
Msg 1834, Level 16, State 1, Line 35
112132
RESTORE DATABASE AdventureWorks
113133
from URL = 'https://<storage-account-name>.blob.core.windows.net/<container-name>/AdventureWorks.bak'

docs/linux/quickstart-install-connect-docker.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
11
---
2-
title: "Docker: Install Containers for SQL Server on Linux"
2+
title: "Docker: Run Containers for SQL Server on Linux"
33
description: This quickstart shows how to use Docker to run the SQL Server Linux container images. You connect to a database and run a query.
44
author: amitkh-msft
55
ms.author: amitkh
66
ms.reviewer: vanto, randolphwest
7-
ms.date: 05/02/2025
7+
ms.date: 06/06/2025
88
ms.service: sql
99
ms.subservice: linux
1010
ms.topic: quickstart
@@ -241,7 +241,7 @@ docker run -e "ACCEPT_EULA=Y" -e "MSSQL_SA_PASSWORD=<password>" `
241241
> [!CAUTION]
242242
> [!INCLUDE [password-complexity](includes/password-complexity.md)] If you don't follow these password requirements, the container can't set up [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)], and stops working. You can examine the error log by using the [`docker logs`](https://docs.docker.com/reference/cli/docker/container/logs) command.
243243
244-
By default, this quickstart creates a container with the Developer edition of [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)]. The process for running production editions in containers is slightly different. For more information, see [Run production container images](./sql-server-linux-docker-container-deployment.md#production).
244+
By default, this quickstart creates a container with the Developer edition of [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)]. The process for running production editions in containers is slightly different. For more information, see [Run production container images](sql-server-linux-docker-container-deployment.md#production).
245245

246246
The following table provides a description of the parameters in the previous `docker run` example:
247247

@@ -485,7 +485,7 @@ docker run -e "ACCEPT_EULA=Y" -e "MSSQL_SA_PASSWORD=<password>" `
485485
> [!CAUTION]
486486
> [!INCLUDE [password-complexity](includes/password-complexity.md)] If you don't follow these password requirements, the container can't set up [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)], and stops working. You can examine the error log by using the [`docker logs`](https://docs.docker.com/reference/cli/docker/container/logs) command.
487487
488-
By default, this quickstart creates a container with the Developer edition of [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)]. The process for running production editions in containers is slightly different. For more information, see [Run production container images](./sql-server-linux-docker-container-deployment.md#production).
488+
By default, this quickstart creates a container with the Developer edition of [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)]. The process for running production editions in containers is slightly different. For more information, see [Run production container images](sql-server-linux-docker-container-deployment.md#production).
489489

490490
The following table provides a description of the parameters in the previous `docker run` example:
491491

@@ -562,7 +562,7 @@ sqlcmd create mssql get-tags
562562

563563
::: zone-end
564564

565-
By default, this quickstart creates a container with the Developer edition of [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)]. The process for running production editions in containers is slightly different. For more information, see [Run production container images](./sql-server-linux-docker-container-deployment.md#production).
565+
By default, this quickstart creates a container with the Developer edition of [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)]. The process for running production editions in containers is slightly different. For more information, see [Run production container images](sql-server-linux-docker-container-deployment.md#production).
566566

567567
The following table provides a description of the parameters in the previous `docker run` example:
568568

@@ -728,7 +728,7 @@ docker run -e "ACCEPT_EULA=Y" -e "MSSQL_SA_PASSWORD=<password>" `
728728
> [!CAUTION]
729729
> [!INCLUDE [password-complexity](includes/password-complexity.md)] If you don't follow these password requirements, the container can't set up [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)], and stops working. You can examine the error log by using the [`docker logs`](https://docs.docker.com/reference/cli/docker/container/logs) command.
730730
731-
By default, this quickstart creates a container with the Developer edition of [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)]. The process for running production editions in containers is slightly different. For more information, see [Run production container images](./sql-server-linux-docker-container-deployment.md#production).
731+
By default, this quickstart creates a container with the Developer edition of [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)]. The process for running production editions in containers is slightly different. For more information, see [Run production container images](sql-server-linux-docker-container-deployment.md#production).
732732

733733
The following table provides a description of the parameters in the previous `docker run` example:
734734

@@ -858,7 +858,7 @@ sqlcmd create mssql get-tags
858858

859859
::: zone-end
860860

861-
By default, this quickstart creates a container with the Developer edition of [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)]. The process for running production editions in containers is slightly different. For more information, see [Run production container images](./sql-server-linux-docker-container-deployment.md#production).
861+
By default, this quickstart creates a container with the Developer edition of [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)]. The process for running production editions in containers is slightly different. For more information, see [Run production container images](sql-server-linux-docker-container-deployment.md#production).
862862

863863
The following table provides a description of the parameters in the previous `docker run` example:
864864

@@ -1048,7 +1048,7 @@ docker run -e "ACCEPT_EULA=Y" -e "MSSQL_SA_PASSWORD=<password>" `
10481048
> [!CAUTION]
10491049
> [!INCLUDE [password-complexity](includes/password-complexity.md)] If you don't follow these password requirements, the container can't set up [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)], and stops working. You can examine the error log by using the [`docker logs`](https://docs.docker.com/reference/cli/docker/container/logs) command.
10501050
1051-
By default, this quickstart creates a container with the Developer edition of [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)]. The process for running production editions in containers is slightly different. For more information, see [Run production container images](./sql-server-linux-docker-container-deployment.md#production).
1051+
By default, this quickstart creates a container with the Developer edition of [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)]. The process for running production editions in containers is slightly different. For more information, see [Run production container images](sql-server-linux-docker-container-deployment.md#production).
10521052

10531053
The following table provides a description of the parameters in the previous `docker run` example:
10541054

@@ -1178,7 +1178,7 @@ sqlcmd create mssql get-tags
11781178

11791179
::: zone-end
11801180

1181-
By default, this quickstart creates a container with the Developer edition of [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)]. The process for running production editions in containers is slightly different. For more information, see [Run production container images](./sql-server-linux-docker-container-deployment.md#production).
1181+
By default, this quickstart creates a container with the Developer edition of [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)]. The process for running production editions in containers is slightly different. For more information, see [Run production container images](sql-server-linux-docker-container-deployment.md#production).
11821182

11831183
The following table provides a description of the parameters in the previous `docker run` example:
11841184

0 commit comments

Comments
 (0)