Skip to content

Commit 6e8607a

Browse files
authored
export copy reminder (#34818)
1 parent 2979bce commit 6e8607a

File tree

2 files changed

+4
-2
lines changed

2 files changed

+4
-2
lines changed

docs/tools/sqlpackage/sqlpackage-export.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Learn how to automate database development tasks with SqlPackage Ex
44
author: dzsquared
55
ms.author: drskwier
66
ms.reviewer: maghan
7-
ms.date: 9/29/2022
7+
ms.date: 07/28/2025
88
ms.service: sql
99
ms.subservice: tools-other
1010
ms.topic: conceptual
@@ -13,7 +13,7 @@ ms.collection:
1313
---
1414

1515
# SqlPackage Export parameters and properties
16-
The SqlPackage Export action exports a connected database to a BACPAC file (.bacpac). By default, data for all tables will be included in the .bacpac file. Optionally, you can specify only a subset of tables for which to export data. The Export action is part of the [database portability](sqlpackage.md#portability) functionality of SqlPackage.
16+
The SqlPackage Export action exports a connected database to a BACPAC file (.bacpac). By default, data for all tables will be included in the .bacpac file. Optionally, you can specify only a subset of tables for which to export data. The Export action is part of the [database portability](sqlpackage.md#portability) functionality of SqlPackage. For an export to be transactionally consistent, you must ensure either that no write activity is occurring during the export, or that you're exporting from a [transactionally consistent copy](/azure/azure-sql/database/database-copy) of your database.
1717

1818
[!INCLUDE [entra-id](../../includes/entra-id-hard-coded.md)]
1919

docs/tools/sqlpackage/troubleshooting-issues-and-performance-with-sqlpackage.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -151,6 +151,8 @@ For imports that contain large tables or tables with many indexes, the use of `/
151151

152152
## Export action tips
153153

154+
For an export to be transactionally consistent, you must ensure either that no write activity is occurring during the export, or that you're exporting from a [transactionally consistent copy](/azure/azure-sql/database/database-copy) of your database. Receiving errors about foreign key constraints during an import can indicate that the export was not transactionally consistent due to inserted or updated records during the export process.
155+
154156
A common cause of performance degradation during export is unresolved object references, which causes SqlPackage to attempt to resolve the object multiple times. For example, a view is defined that references a table and the table no longer exists in the database. If unresolved references appear in the export log, consider correcting the schema of the database to improve the export performance.
155157

156158
In scenarios where the OS disk space is limited and runs out during the export, the use of `/p:TempDirectoryForTableData` allows the data for export to be buffered on an alternative disk. The space required for this action might be large and is relative to the full size of the database. That and other properties are available to tune the [SqlPackage Export](sqlpackage-export.md) operation.

0 commit comments

Comments
 (0)