Skip to content

Commit dc774f0

Browse files
committed
Learn AI editor and Docs Cleaner
1 parent 8acd510 commit dc774f0

1 file changed

Lines changed: 29 additions & 29 deletions

File tree

azure-sql/database/database-import-export-private-link.md

Lines changed: 29 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,8 @@ title: Import or Export a Database Using Private Link
33
description: Import or export an Azure SQL Database using Private Link without requiring Azure services to access the server.
44
author: WilliamDAssafMSFT
55
ms.author: wiassaf
6-
ms.reviewer: mathoma, hudequei, randolphwest
7-
ms.date: 09/17/2025
6+
ms.reviewer: hudequei, mathoma, randolphwest, maghan
7+
ms.date: 11/06/2025
88
ms.service: azure-sql-database
99
ms.subservice: migration
1010
ms.topic: how-to
@@ -15,23 +15,23 @@ ms.custom:
1515
- sfi-image-nochange
1616
---
1717

18-
# Import or export an Azure SQL Database using private link
18+
# Import or export an Azure SQL Database by using private link
1919

2020
[!INCLUDE [appliesto-sqldb](../includes/appliesto-sqldb.md)]
2121

22-
This article explains how to import or export an Azure SQL Database using [Private Link](private-endpoint-overview.md) by using the Azure portal or Azure PowerShell with *Allow Access to Azure Services* set to **Off** on the Azure SQL [logical server](logical-servers.md).
22+
This article explains how to import or export an Azure SQL Database by using [Private Link](private-endpoint-overview.md) with the Azure portal or Azure PowerShell. Set *Allow Access to Azure Services* to **Off** on the Azure SQL [logical server](logical-servers.md).
2323

24-
Using Private Link allows you to perform import/export operations securely without needing to set [Allow Access to Azure Services](network-access-controls-overview.md) to **On**, which would otherwise be required for standard import/export operations.
24+
By using Private Link, you can perform import and export operations securely without needing to set [Allow Access to Azure Services](network-access-controls-overview.md) to **On**, which is otherwise required for standard import and export operations.
2525

2626
> [!NOTE]
27-
> Import/export using private link for Azure SQL Database is currently in preview.
27+
> Import and export by using private link for Azure SQL Database is currently in preview.
2828
2929
## Prerequisites
3030

31-
Before using import/export with Private Link, ensure you have the following:
31+
Before using import and export with Private Link, ensure you have the following resources and configurations:
3232

3333
- An Azure SQL logical server with private endpoint connectivity configured to a virtual network
34-
- An Azure Storage account with a blob container that contains your BACPAC file (for import) or will store the exported BACPAC file
34+
- An Azure Storage account with a blob container that contains your BACPAC file (for import) or stores the exported BACPAC file
3535
- The Azure SQL logical server and Storage account must have private endpoints configured within the same or peered virtual networks
3636
- Appropriate permissions to approve private endpoint connections on both the Azure SQL logical server and the Storage account
3737

@@ -42,28 +42,28 @@ The database import/export private link is a service managed private endpoint cr
4242
These service-managed private endpoints are created within the same virtual network and subnet where your existing Azure SQL logical server private endpoint is located. The endpoints receive private IP addresses from that subnet's address space and must be manually approved before the import/export operation can proceed.
4343

4444
> [!IMPORTANT]
45-
> If your Azure SQL logical server or Storage account already has private endpoints configured, the import/export service will create **additional** service-managed private endpoints specifically for the import/export operation. These are separate from your existing private endpoints and require separate approval.
45+
> If your Azure SQL logical server or Storage account already has private endpoints configured, the import/export service creates **additional** service-managed private endpoints specifically for the import/export operation. These private endpoints are separate from your existing private endpoints and require separate approval.
4646
47-
The private endpoint must be manually approved for both the Azure SQL logical server and the Azure Blob storage account, in separate steps, with details included in this tutorial.
47+
You must manually approve the private endpoint for both the Azure SQL logical server and the Azure Blob storage account in separate steps. This tutorial includes the details.
4848

4949
:::image type="content" source="media/database-import-export-private-link/import-export-private-link.png" alt-text="Diagram of Import Export Private link architecture." lightbox="media/database-import-export-private-link/import-export-private-link.png":::
5050

5151
## Configure Import-Export Private Link using the Azure portal
5252

53-
Import/Export Private Link can be configured via Azure portal, PowerShell, or using REST API.
53+
You can configure Import/Export Private Link through the Azure portal, PowerShell, or REST API.
5454

5555
> [!NOTE]
56-
> The service automatically creates private endpoints in the same virtual network and subnet as your Azure SQL logical server's existing private endpoint. You don't need to manually specify the VNet or subnet during the import/export process. If your SQL server doesn't have a private endpoint configured, you must set one up before using import/export with Private Link.
56+
> The service automatically creates private endpoints in the same virtual network and subnet as your Azure SQL logical server's existing private endpoint. You don't need to manually specify the virtual network or subnet during the import/export process. If your SQL server doesn't have a private endpoint configured, you must set one up before using import/export with Private Link.
5757
5858
### 1. Configure Import/Export private link using the Azure portal
5959

6060
<a id="create-import-private-link"></a>
6161

6262
#### Enable Import private link
6363

64-
You need to enable and approve the import private link. Creating the private link is performed automatically in Azure.
64+
You need to enable and approve the import private link. Azure automatically creates the private link.
6565

66-
1. Go to the **Overview** page of the Azure SQL logical server into which you would like to import the database. Select **Import database** from toolbar.
66+
1. Go to the **Overview** page of the Azure SQL logical server where you want to import the database. Select **Import database** from the toolbar.
6767

6868
1. In the **Import database** page, select the **Use private link** option checkbox.
6969

@@ -73,26 +73,26 @@ You need to enable and approve the import private link. Creating the private lin
7373

7474
#### Enable export private link
7575

76-
You need to enable and approve the export private link. Creating the private link is performed automatically in Azure.
76+
You need to enable and approve the export private link. Azure automatically creates the private link.
7777

78-
1. Go to the **Overview** page of the Azure SQL database that you would like to export. Select **Export** from the toolbar.
78+
1. Go to the **Overview** page of the Azure SQL database that you want to export. Select **Export** from the toolbar.
7979
1. In the **Export database** page, select the **Use private link** option checkbox.
8080
1. Enter the storage account, authentication credentials, database details, and select **OK**.
8181

8282
### 2. Approve private link for Azure SQL logical server
8383

84-
The new private endpoint must be approved by the user in the Private Link Center or in the Azure SQL Database, or you can approve both private links individually in their respective Azure portal locations.
84+
The user must approve the new private endpoint in the Private Link Center or in the Azure SQL Database. You can approve both private links individually in their respective Azure portal locations.
8585

8686
> [!TIP]
87-
> If you already have private endpoints configured for your Azure SQL logical server and Storage account, you'll see the new service-managed private endpoints appear as **pending connections**. These are specifically for the import/export operation and are separate from your existing private endpoints. Look for private endpoints with names indicating they were created by the import/export service.
87+
> If you already have private endpoints configured for your Azure SQL logical server and Storage account, you see the new service-managed private endpoints appear as **pending connections**. These private endpoints are specifically for the import/export operation and are separate from your existing private endpoints. Look for private endpoints with names indicating they were created by the import/export service.
8888
8989
#### Option 1: Approve private endpoints in Private Link Center in Azure portal
9090

91-
1. Navigate to the Private Link Center in the Azure portal. In the Azure search box, search for "Private Link". Select **Private Link**.
91+
1. Navigate to the Private Link Center in the Azure portal. In the Azure search box, search for *Private Link*. Select **Private Link**.
9292

9393
1. In the Private Link Center, select **Pending connections**.
9494

95-
1. Select both private endpoints you created using the Import/Export service. Select **Approve**.
95+
1. Select both private endpoints you created by using the Import/Export service. Select **Approve**.
9696

9797
:::image type="content" source="media/database-import-export-private-link/approve-private-link-center.png" alt-text="Screenshot from the Private Link Center of the Azure portal showing how to approve both private links." lightbox="media/database-import-export-private-link/approve-private-link-center.png":::
9898

@@ -104,7 +104,7 @@ The new private endpoint must be approved by the user in the Private Link Center
104104

105105
1. Select the **Private access** tab.
106106

107-
1. In the list under **Private endpoint connections**, select the private endpoints you created using the Import/Export service.
107+
1. In the list under **Private endpoint connections**, select the private endpoints you created by using the Import/Export service.
108108

109109
1. Select **Approve**.
110110

@@ -124,21 +124,21 @@ The new private endpoint must be approved by the user in the Private Link Center
124124

125125
### 3. Check import/export status
126126

127-
1. After the private endpoints are approved, both in the Azure SQL server and the Azure Storage account, the database import or export job will be kicked off. Until then, the jobs are on hold.
127+
1. After you approve the private endpoints in both the Azure SQL server and the Azure Storage account, the database import or export job begins. Until then, the jobs are on hold.
128128

129129
1. You can check the status of database import or export jobs in **Import/Export History** page under **Data Management** section in Azure SQL server page.
130130

131131
:::image type="content" source="media/database-import-export-private-link/import-export-status.png" alt-text="Screenshot from the Azure portal that shows how to check Import Export Jobs Status." lightbox="media/database-import-export-private-link/import-export-status.png":::
132132

133133
## Configure import/export private link using PowerShell
134134

135-
When using PowerShell, the service-managed private endpoints are automatically created in the same virtual network and subnet as your Azure SQL logical server's existing private endpoint. Ensure your SQL server has private endpoint connectivity configured before running these commands.
135+
When you use PowerShell, the service-managed private endpoints are automatically created in the same virtual network and subnet as your Azure SQL logical server's existing private endpoint. Ensure your SQL server has private endpoint connectivity configured before running these commands.
136136

137137
### Import a database using private link in PowerShell
138138

139139
Use the [New-AzSqlDatabaseImport](/PowerShell/module/az.sql/new-azsqldatabaseimport) cmdlet to submit an import database request to Azure. Depending on database size, the import might take some time to complete. The DTU-based provisioning model supports select database max size values for each tier. When importing a database, [use the supported edition and service objective values for Azure SQL Database](/sql/t-sql/statements/create-database-transact-sql?view=azuresqldb-current&preserve-view=true#create-a-database).
140140

141-
Provide your own `<values>` in the following PowerShell code sample, which imports a .bacpac file named `sample.bacpac` and creates an Azure SQL Database with 2 General Purpose vCores.
141+
Provide your own `<values>` in the following PowerShell code sample, which imports a .bacpac file named `sample.bacpac` and creates an Azure SQL Database with two General Purpose vCores.
142142

143143
```powershell
144144
$importRequestParams = @{
@@ -193,15 +193,15 @@ Existing APIs to perform Import and Export jobs support Private Link. Refer to [
193193

194194
Currently, the private link for import/export has the following limitations:
195195

196-
- To use Private Link with Import/Export, the user database and the Azure Storage blob container must be hosted on the same type of Azure Cloud. For example, either both in Azure Commercial or both on Azure Gov. Hosting across cloud types isn't supported.
196+
- To use Private Link with Import/Export, the user database and the Azure Storage blob container must be on the same type of Azure Cloud. For example, both must be in Azure Commercial or both in Azure Gov. Hosting across cloud types isn't supported.
197197

198-
- Import or Export of a database from [Azure SQL Managed Instance](../managed-instance/sql-managed-instance-paas-overview.md) using PowerShell isn't currently supported.
198+
- Import or Export of a database from [Azure SQL Managed Instance](../managed-instance/sql-managed-instance-paas-overview.md) by using PowerShell isn't currently supported.
199199

200-
- Import/Export Private Link shouldn't be used when the user Database or the Azure Storage account are protected by Resource locks.
200+
- Don't use Import/Export Private Link when the user Database or the Azure Storage account are protected by Resource locks.
201201

202-
- Manual approval of the new private endpoint connection is required to complete the export operation. After starting the export, go to "pending connections" in the Private Link Center and approve the connections, which can take several minutes to appear.
202+
- You need to manually approve the new private endpoint connection to complete the export operation. After starting the export, go to **pending connections** in the Private Link Center and approve the connections, which can take several minutes to appear.
203203

204-
- Import using Private Link doesn't support specifying a backup storage redundancy while creating a new database and creates with the default geo-redundant backup storage redundancy. As a workaround, first create an empty database with desired backup storage redundancy using Azure portal or PowerShell and then import the BACPAC file into this empty database.
204+
- Import using Private Link doesn't support specifying a backup storage redundancy while creating a new database and creates with the default geo-redundant backup storage redundancy. As a workaround, first create an empty database with desired backup storage redundancy by using Azure portal or PowerShell, then import the BACPAC file into this empty database.
205205

206206
- Import using REST API with private link can only be completed for an existing database since the API uses database extensions. As a workaround, create an empty database with the desired name, then call the Import REST API with private link.
207207

0 commit comments

Comments
 (0)