Skip to content

Commit 842a142

Browse files
Merge pull request #36745 from MicrosoftDocs/main
Auto Publish – main to live - 2026-03-02 23:30 UTC
2 parents 402c1ec + 011031f commit 842a142

7 files changed

Lines changed: 460 additions & 7 deletions

File tree

azure-sql/database/database-export.md

Lines changed: 17 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ description: Export a database to a BACPAC file using the Azure portal, PowerShe
55
author: WilliamDAssafMSFT
66
ms.author: wiassaf
77
ms.reviewer: mathoma, hudequei, randolphwest
8-
ms.date: 01/26/2026
8+
ms.date: 03/02/2026
99
ms.service: azure-sql
1010
ms.subservice: data-movement
1111
ms.topic: how-to
@@ -65,6 +65,22 @@ If the export operation exceeds 20 hours, it might be canceled. To increase perf
6565

6666
1. To monitor the progress of the export operation, open the page for the server containing the database being exported. Under **Data management**, select **Import/Export history**.
6767

68+
## Export with managed identity authentication (preview)
69+
70+
You can export a database in Azure SQL Database to a BACPAC file using [managed identity](/entra/identity/managed-identities-azure-resources/overview) authentication to eliminate the need to provide SQL administrator passwords or storage access keys.
71+
72+
For a detailed tutorial, see [Use managed identity with import and export (preview)](database-import-export-managed-identity.md).
73+
74+
To export a BACPAC file using managed identity authentication, the following configuration is required:
75+
76+
- A **user-assigned managed identity (UAMI)** assigned to the [logical server](logical-servers.md) for Azure SQL Database.
77+
- The server has the managed identity configured as the **Microsoft Entra administrator**.
78+
- A managed identity is assigned to the **Storage Blob Data Contributor** role on the target Azure Storage account. This managed identity can be the same as the one assigned to the server or a different one.
79+
- The logical server, managed identity, and storage account are in the **same Microsoft Entra tenant**.
80+
81+
> [!NOTE]
82+
> Export with managed identity authentication is currently in [**preview**](doc-changes-updates-release-notes-whats-new.md#preview) and only available for Azure SQL Database.
83+
6884
## SQLPackage utility
6985

7086
We recommend the use of the SQLPackage utility for scale and performance in most production environments. You can run multiple SqlPackage commands in parallel for subsets of tables to speed up import/export operations.

azure-sql/database/database-import-export-managed-identity.md

Lines changed: 375 additions & 0 deletions
Large diffs are not rendered by default.

azure-sql/database/database-import.md

Lines changed: 25 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ description: Create a new database in Azure SQL Database or Azure SQL Managed In
55
author: WilliamDAssafMSFT
66
ms.author: wiassaf
77
ms.reviewer: hudequei, mathoma, drskwier, randolphwest
8-
ms.date: 01/26/2026
8+
ms.date: 03/02/2026
99
ms.service: azure-sql
1010
ms.subservice: backup-restore
1111
ms.topic: quickstart
@@ -59,6 +59,29 @@ Watch this video to see how to import from a BACPAC file in the Azure portal or
5959

6060
1. To verify the database is live on the server, select **SQL databases** and verify the new database is **Online**.
6161

62+
## Import with managed identity authentication (preview)
63+
64+
Azure SQL Database supports importing a BACPAC file using [managed identity](/entra/identity/managed-identities-azure-resources/overview) authentication. This option enables fully credential-free import operations and is recommended for environments that disable SQL authentication or enforce Microsoft Entra-only authentication.
65+
66+
You can import a database to a *new database*, or to an *existing empty database*.
67+
68+
For a detailed tutorial, see [Use managed identity with import and export (preview)](database-import-export-managed-identity.md).
69+
70+
To import a BACPAC file using managed identity authentication, the following configuration is required:
71+
72+
- A **user-assigned managed identity (UAMI)** assigned to the [logical server](logical-servers.md) for Azure SQL Database.
73+
- The server has the managed identity configured as the **Microsoft Entra administrator**.
74+
- A managed identity is assigned to the **Storage Blob Data Reader** role on the source Azure Storage account. This managed identity can be the same as the one assigned to the server or a different one.
75+
- The logical server, managed identity, and storage account are in the **same Microsoft Entra tenant**.
76+
77+
The following scenarios are unsupported:
78+
79+
- Cross-tenant import operations.
80+
- Managed identity assigned only at the database level.
81+
82+
> [!NOTE]
83+
> Import with managed identity authentication is currently in [**preview**](doc-changes-updates-release-notes-whats-new.md#preview) and only available for Azure SQL Database.
84+
6285
## Use SqlPackage
6386

6487
To import a SQL Server database using the [SqlPackage](/sql/tools/sqlpackage) command-line utility, see [import parameters and properties](/sql/tools/sqlpackage/sqlpackage-import). You can download the latest [SqlPackage](/sql/tools/sqlpackage/sqlpackage-download) for Windows, macOS, or Linux.
@@ -172,7 +195,7 @@ To cancel the import operation, you need to be a member of one of the following
172195

173196
## Limitations
174197

175-
- Importing to a database in elastic pool isn't supported through the Azure Portal, Azure PowerShell, or Azure CLI. Instead, create a database in the elastic pool and then use [SQLPackage Import](/sql/tools/sqlpackage/sqlpackage-import), or import data using any method into a single database and then move the database to an elastic pool.
198+
- Importing to a database in elastic pool isn't supported through the Azure portal, Azure PowerShell, or Azure CLI. Instead, create a database in the elastic pool and then use [SQLPackage Import](/sql/tools/sqlpackage/sqlpackage-import), or import data using any method into a single database and then move the database to an elastic pool.
176199
- Import Export Service doesn't work when Allow access to Azure services is set to OFF. However, you can work around the problem by manually running SqlPackage from an Azure VM, or performing the export directly in your code by using the DacFx API.
177200
- Import doesn't support specifying a backup storage redundancy while creating a new database and creates with the default geo-redundant backup storage redundancy. To work around, first create an empty database with desired backup storage redundancy using Azure portal or PowerShell and then import the BACPAC into this empty database.
178201
- Storage behind a firewall is currently not supported.

azure-sql/database/doc-changes-updates-release-notes-whats-new.md

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ description: Learn about the new features and documentation improvements for Azu
55
author: WilliamDAssafMSFT
66
ms.author: wiassaf
77
ms.reviewer: mathoma, randolphwest
8-
ms.date: 01/29/2026
8+
ms.date: 03/02/2026
99
ms.service: azure-sql-database
1010
ms.subservice: service-overview
1111
ms.topic: whats-new
@@ -48,6 +48,7 @@ The following table lists the features of Azure SQL Database that are currently
4848
| **Elastic transactions** | [Elastic transactions](elastic-transactions-overview.md) allow you to execute transactions distributed among cloud databases in Azure SQL Database. |
4949
| **Fixed server roles** | To simplify permission management, Azure SQL Database provides a set of [fixed server-level roles](security-server-roles.md) to help you manage the permissions on a logical server. |
5050
| **Immutable LTR backups** | You can [configure long-term retention backups of Azure SQL Database as immutable](backup-immutability.md) with legal hold immutability (preview feature). Time-based backup immutability is generally available.|
51+
| **Import and export using managed identity** | You can [import or export an Azure SQL Database BACPAC file with managed identity authentication](database-import-export-managed-identity.md). Use managed identity authentication for enhanced security when importing or exporting databases. |
5152
| **Import and export using Private Link** | You can [import or export an Azure SQL Database using private link](database-import-export-private-link.md). Leave *Allow Access to Azure Services* off when you import or export a database using a service-managed endpoint. |
5253
| **Microsoft Entra server principals** | The ability to [create server principals (logins) for Microsoft Entra identities](authentication-azure-ad-logins.md) in Azure SQL Database is in preview. |
5354
| **Multiple geo-replicas for Hyperscale** | The ability to create up to four geo-replicas for Azure SQL Hyperscale is in preview. Learn more about [multiple geo-replicas for Hyperscale](https://aka.ms/sqlhs-multi-geo-announcement). |
@@ -96,6 +97,12 @@ The following table lists features of Azure SQL Database that have been made gen
9697

9798
Learn about significant changes to the Azure SQL Database documentation. For previous years, see the [What's new archive](doc-changes-updates-release-notes-whats-new-archive.md).
9899

100+
### March 2026
101+
102+
| Changes | Details |
103+
| --- | --- |
104+
| **Import and export using managed identity preview** | You can [import or export an Azure SQL Database BACPAC file with managed identity authentication](database-import-export-managed-identity.md). Use managed identity authentication for enhanced security when importing or exporting databases. This capability is currently in preview for Azure SQL Database. |
105+
99106
### January 2026
100107

101108
| Changes | Details |

azure-sql/managed-instance/update-policy.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ description: Use the update policy setting in Azure SQL Managed Instance to cont
55
author: MladjoA
66
ms.author: mlandzic
77
ms.reviewer: mathoma
8-
ms.date: 11/18/2025
8+
ms.date: 2/27/2026
99
ms.service: azure-sql-managed-instance
1010
ms.subservice: deployment-configuration
1111
ms.topic: how-to
@@ -32,7 +32,7 @@ Azure SQL Managed Instance offers the following three update policies:
3232
## SQL Server 2025 update policy
3333

3434
> [!NOTE]
35-
> The **SQL Server 2025** update policy is currently in preview. Changing the update policy from **SQL Server 2025** to **Always-up-to-date** is currently and temporarily disabled.
35+
> Changing the update policy from **SQL Server 2025** to **Always-up-to-date** is currently and temporarily disabled.
3636
3737
The **SQL Server 2025** update policy aligns your database format with [!INCLUDE [sssql25-md](../../docs/includes/sssql25-md.md)].
3838

azure-sql/toc.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -353,6 +353,8 @@
353353
items:
354354
- name: Migrate using DMS
355355
href: /azure/dms/tutorial-sql-server-to-azure-sql?toc=/azure/azure-sql/toc.json
356+
- name: Import or export database with managed identity authentication
357+
href: database/database-import-export-managed-identity.md
356358
- name: Scale out
357359
items:
358360
- name: Configure Hyperscale named replicas

docs/relational-databases/import-export/overview-import-export.md

Lines changed: 31 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: "Import and Export Data from SQL Server and Azure SQL Database"
33
description: You can use Transact-SQL, command-line tools, and wizards to import and export data in SQL Server and Azure SQL Database in various data formats.
44
author: rwestMSFT
55
ms.author: randolphwest
6-
ms.date: 07/15/2025
6+
ms.date: 03/02/2026
77
ms.service: sql
88
ms.subservice: data-movement
99
ms.topic: concept-article
@@ -27,6 +27,36 @@ You can import data with the `BULK INSERT` or the `OPENROWSET(BULK...)` commands
2727

2828
You can import and export data with the BCP command-line utility. For more information, see [Import and export bulk data using bcp (SQL Server)](import-and-export-bulk-data-by-using-the-bcp-utility-sql-server.md).
2929

30+
### Azure portal import and export
31+
32+
The Azure portal provides **Import** and **Export** actions for Azure SQL Database. You can use these actions to import or export a database as a BACPAC file through the **Azure SQL Import/Export service**.
33+
34+
- **Export**: From an Azure SQL Database page, select **Export** to create a BACPAC file in Azure Blob Storage.
35+
- **Import**: From a [logical server for Azure SQL Database](https://portal.azure.com/#servicemenu/SqlAzureExtension/AzureSqlHub/DatabaseServer) page, select **Import database** to create a new database from a BACPAC file stored in Azure Blob Storage.
36+
37+
Portal-based import and export operations:
38+
39+
- Use the same import or export service and APIs as PowerShell, Azure CLI, and REST.
40+
- Support BACPAC files stored in Azure Blob Storage.
41+
- Surface operation status and history through **Import/Export history** on the logical server.
42+
43+
Authentication options available in the Azure portal align with those supported by the import and export service. Support for **Managed Identity authentication** is in **Preview**.
44+
45+
For a detailed tutorial, see [Use managed identity with import and export (preview)](/azure/azure-sql/database/database-import-export-managed-identity).
46+
47+
In this model:
48+
49+
- A **user‑assigned managed identity (UAMI)** is assigned to the logical server for Azure SQL Database.
50+
- The managed identity is configured as a **Microsoft Entra administrator** on the server.
51+
- The same or a different managed identity is granted **Azure RBAC data-plane access** to the target Azure Storage account.
52+
53+
> [!NOTE]
54+
> - Import and export with managed identity authentication is currently in [**preview**](/azure/azure-sql/database/doc-changes-updates-release-notes-whats-new#preview) and only available for Azure SQL Database.
55+
> - Only **server-level user-assigned managed identities** are supported in the current preview.
56+
57+
For more information, see [Import a BACPAC file to a database in Azure SQL Database](/azure/azure-sql/database/database-import#import-with-managed-identity-authentication-preview) and [Export a database to a BACPAC file](/azure/azure-sql/database/database-export##export-with-managed-identity-authentication-preview).
58+
59+
3060
### Use the Import Flat File Wizard
3161

3262
If you don't need all the configuration options available in the Import and Export Wizard and other tools, you can import a text file into SQL Server by using the **Import Flat File Wizard** in SQL Server Management Studio (SSMS). For more information, see the following articles:

0 commit comments

Comments
 (0)