You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/tools/sql-database-projects/concepts/data-tier-applications/unpack-dacpac-file.md
+5-5Lines changed: 5 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,7 +4,7 @@ description: "Unpack a DACPAC file to review or examine the contents."
4
4
author: dzsquared
5
5
ms.author: drskwier
6
6
ms.reviewer: randolphwest, maghan
7
-
ms.date: 12/16/2025
7
+
ms.date: 02/06/2026
8
8
ms.service: sql
9
9
ms.subservice: sql-database-projects
10
10
ms.topic: how-to
@@ -61,9 +61,9 @@ Deploying the `.dacpac` to a test instance results in the contents of the `.dacp
61
61
> [!NOTE]
62
62
> One option for creating a test instance locally is with [SQL Server in Docker](../../../../linux/quickstart-install-connect-docker.md#pullandrun2022).
63
63
64
-
### Deploy the DACPAC using Azure Data Studio
64
+
### Deploy the DACPAC using Visual Studio Code
65
65
66
-
1. Install the **SQL Server dacpac extension** in [Azure Data Studio](/azure-data-studio/extensions/sql-server-dacpac-extension).
66
+
1. Install the [MSSQL extension for Visual Studio Code](../../../visual-studio-code-extensions/mssql/mssql-extension-visual-studio-code.md), and follow the instructions to enable the [Data-tier Application (Preview)](../../../visual-studio-code-extensions/mssql/mssql-data-tier-application.md) experience.
67
67
68
68
1. Connect to the desired instance. Right-click on the server node and select **Data-tier application wizard** from the menu.
69
69
@@ -79,7 +79,7 @@ Deploying the `.dacpac` to a test instance results in the contents of the `.dacp
79
79
80
80
### Other tools with DACPAC deployment capabilities
81
81
82
-
Beyond Azure Data Studio and SqlPackage, many other tools can be used to deploy a `.dacpac` to a database. Some examples include:
82
+
Beyond Visual Studio Code and SqlPackage, many other tools can be used to deploy a `.dacpac` to a database. Some examples include:
Copy file name to clipboardExpand all lines: docs/tools/sql-database-projects/concepts/database-references.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,7 +4,7 @@ description: Extend a SQL project with references to additional database compone
4
4
author: dzsquared
5
5
ms.author: drskwier
6
6
ms.reviewer: maghan, randolphwest
7
-
ms.date: 10/10/2025
7
+
ms.date: 02/06/2026
8
8
ms.service: sql
9
9
ms.subservice: sql-database-projects
10
10
ms.topic: concept-article
@@ -144,7 +144,7 @@ FROM [$(WWIServer)].[$(WorldWideImporters)].[Purchasing].[Suppliers]
144
144
145
145
To add a database reference to a SQL project in the SQL Database Projects extension, right-click the **Database References** node under the project in the **Database Projects** view and select **Add Database Reference**.
146
146
147
-
:::image type="content" source="media/database-references/ads-add-reference.png" alt-text="Screenshot of Azure Data Studio add reference dialog.":::
147
+
:::image type="content" source="media/database-references/ads-add-reference.png" alt-text="Screenshot of Visual Studio Code add reference dialog.":::
Copy file name to clipboardExpand all lines: docs/tools/sql-database-projects/concepts/schema-comparison.md
+4-4Lines changed: 4 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,7 +4,7 @@ description: Visualize the difference in database models with schema compare.
4
4
author: dzsquared
5
5
ms.author: drskwier
6
6
ms.reviewer: maghan, randolphwest, tsiddique
7
-
ms.date: 10/10/2025
7
+
ms.date: 02/06/2026
8
8
ms.service: sql
9
9
ms.subservice: sql-database-projects
10
10
ms.topic: overview
@@ -46,7 +46,7 @@ The differences between source and target appear in a grid for easy review. Comp
46
46
- SQL database project
47
47
-`.dacpac` file
48
48
49
-
In schema compare, you can drill into and review each difference in the results grid or in script form where details of the changes are available at a per-line level. You can also selectively exclude specific differences before updating the target. The schema compare tooling is available in Visual Studio, Azure Data Studio, and the command line.
49
+
In schema compare, you can drill into and review each difference in the results grid or in script form where details of the changes are available at a per-line level. You can also selectively exclude specific differences before updating the target. The schema compare tooling is available in Visual Studio, Visual Studio Code, and the command line.
50
50
51
51
### Schema comparison options
52
52
@@ -68,7 +68,7 @@ The comparison definition for schema compare can be saved as an `.scmp` file, kn
68
68
- comparison options
69
69
- excluded object types
70
70
71
-
An `.scmp` file can be opened in Visual Studio or Azure Data Studio to easily run the same comparison again later or to share the comparison with others.
71
+
An `.scmp` file can be opened in Visual Studio to easily run the same comparison again later or to share the comparison with others.
72
72
73
73
## Launch and use schema compare
74
74
@@ -189,7 +189,7 @@ More in-depth information about schema comparison in Visual Studio Code is avail
189
189
190
190
When the comparison is complete, the structural differences between the project and the database appear in the **Results** pane in the upper part of the window. By default, the comparison results group all the differences are grouped by action (such as Delete, Change, or Add). The **Results** pane displays a row for each database object that differs between the database definitions. Each row identifies the object in the source or target schema (or both) and the action that would be taken on the target schema to make the target object the same as the source object. If an object has been refactored and either renamed or moved to a new schema, the source and target names are different, and the source name appears in bold font to highlight the difference.
191
191
192
-
:::image type="content" source="media/schema-comparison/vs-code-schema-compare.png" alt-text="Screenshot of Schema comparison interface in Azure Data Studio comparing a database against a project." lightbox="media/schema-comparison/vs-code-schema-compare.png":::
192
+
:::image type="content" source="media/schema-comparison/vs-code-schema-compare.png" alt-text="Screenshot of Schema comparison interface in Visual Studio Code comparing a database against a project." lightbox="media/schema-comparison/vs-code-schema-compare.png":::
193
193
194
194
5. By default all differences are included in the scope of the Update Target action. You can exclude differences that you don't want to synchronize. To do so, uncheck the **Action** column in the center of each row. When schema compare is used to update the target database, this row isn't considered for any pending changes.
Copy file name to clipboardExpand all lines: docs/tools/sql-database-projects/howto/compare-database-project.md
+5-5Lines changed: 5 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,16 +4,16 @@ description: "Compare a project and a database and with different approaches."
4
4
author: dzsquared
5
5
ms.author: drskwier
6
6
ms.reviewer: maghan, randolphwest
7
-
ms.date: 08/30/2024
7
+
ms.date: 02/06/2026
8
8
ms.service: sql
9
9
ms.subservice: sql-database-projects
10
10
ms.topic: how-to
11
11
ms.collection:
12
12
- data-tools
13
-
zone_pivot_groups: sq1-sql-projects-tools
14
13
ms.custom:
15
14
- ignite-2024
16
15
- sfi-ropc-nochange
16
+
zone_pivot_groups: sq1-sql-projects-tools
17
17
---
18
18
19
19
# Compare a database and a project
@@ -42,14 +42,14 @@ This article reviews methods for comparing a database and a SQL project using di
42
42
43
43
::: zone pivot="sq1-visual-studio-sdk"
44
44
45
-
Graphical schema comparison isn't yet available in the SDK-style SQL projects preview in Visual Studio. Use Azure Data Studio or Visual Studio to compare schemas.
45
+
Graphical schema comparison isn't yet available in the SDK-style SQL projects preview in Visual Studio. Use Visual Studio Code or Visual Studio to compare schemas.
@@ -127,7 +127,7 @@ An advantage of the deploy report XML operation is that it can be used to automa
127
127
128
128
## Import changes from a database
129
129
130
-
As mentioned in the [schema compare section](#schema-compare-visualize-differences), schema compare can be used to apply changes from a database into a SQL project file set. Applying changes to a SQL project is a common scenario when you have a database that is actively developed in directly and a SQL project is used to manage the database objects in source control. Manually completing this operation through Visual Studio or Azure Data Studio can be time-consuming, especially when the database has many objects or sporadic changes. In this section, we review how to automate the extract of object definitions from a database into a SQL project file set.
130
+
As mentioned in the [schema compare section](#schema-compare-visualize-differences), schema compare can be used to apply changes from a database into a SQL project file set. Applying changes to a SQL project is a common scenario when you have a database that is actively developed in directly and a SQL project is used to manage the database objects in source control. Manually completing this operation through Visual Studio or Visual Studio Code can be time-consuming, especially when the database has many objects or sporadic changes. In this section, we review how to automate the extract of object definitions from a database into a SQL project file set.
-[SQL Database Projects extension](/azure-data-studio/extensions/sql-database-project-extension) or [SQL Database Projects extension for VS Code](https://marketplace.visualstudio.com/items?itemName=ms-mssql.sql-database-projects-vscode)
68
+
-[Visual Studio Code](https://code.visualstudio.com/Download)
@@ -103,7 +102,7 @@ Build the project in Visual Studio by right-clicking on the database node in **S
103
102
104
103
::: zone pivot="sq1-visual-studio-code"
105
104
106
-
Open the project folder in VS Code or Azure Data Studio. In the **Database Projects** view of VS Code or Azure Data Studio, right-click the project node and select **Build**.
105
+
Open the project folder in Visual Studio Code. In the **Database Projects** view of Visual Studio Code, right-click the project node and select **Build**.
107
106
108
107
::: zone-end
109
108
@@ -255,7 +254,6 @@ The SQL project is no longer compatible with Visual Studio 2022. To build or edi
255
254
256
255
- the command line
257
256
- the SQL Database Projects extension in Visual Studio Code
258
-
- the SQL Database Projects extension in Azure Data Studio
259
257
- the SQL Server Data Tools, SDK-style (preview) in Visual Studio 2022
260
258
261
259
::: zone-end
@@ -268,7 +266,7 @@ The project file is now in the SDK-style format, but to open it in Visual Studio
268
266
269
267
::: zone pivot="sq1-visual-studio-code"
270
268
271
-
Open the project folder in VS Code or Azure Data Studio. In the **Database Projects** view of VS Code or Azure Data Studio, right-click the project node and select **Build**.
269
+
Open the project folder in Visual Studio Code. In the **Database Projects** view of Visual Studio Code, right-click the project node and select **Build**.
272
270
273
271
::: zone-end
274
272
@@ -303,7 +301,7 @@ The syntax for DacpacVerify is to specify the filepath to two `.dacpac` files as
You can use the schema compare tool in Visual Studio or Azure Data Studio to compare objects in the `.dacpac` files.
304
+
You can use the schema compare tool in Visual Studio to compare objects in the `.dacpac` files.
307
305
308
306
::: zone pivot="sq1-visual-studio"
309
307
@@ -313,23 +311,23 @@ Launch Visual Studio without a project loaded. Go to **Tools** > **SQL Server**
313
311
314
312
::: zone pivot="sq1-visual-studio-sdk"
315
313
316
-
Graphical schema comparison isn't yet available in the SDK-style SQL projects preview in Visual Studio. Use Azure Data Studio to compare schemas.
314
+
Graphical schema comparison isn't yet available in the SDK-style SQL projects preview in Visual Studio. Use Visual Studio Code to compare schemas.
317
315
318
316
::: zone-end
319
317
320
318
::: zone pivot="sq1-visual-studio-code"
321
319
322
-
Schema comparison isn't available in Visual Studio Code. Use Azure Data Studio or Visual Studio to compare schemas.
320
+
Use Visual Studio or Visual Studio Code to compare schemas.
323
321
324
-
In Azure Data Studio, install the **SQL Server Schema Compare** extension if it isn't already installed. Launch a new schema comparison from the command palette by opening the command palette with `Ctrl/Cmd+Shift+P` and typing `Schema Compare`.
322
+
In Visual Studio Code, install the **SQL Server Schema Compare** extension if it isn't already installed. Launch a new schema comparison from the command palette by opening the command palette with `Ctrl/Cmd+Shift+P` and typing `Schema Compare`.
325
323
326
324
Select the original `.dacpac` file as the source and the modified `.dacpac` file as the target.
327
325
328
326
::: zone-end
329
327
330
328
::: zone pivot="sq1-command-line"
331
329
332
-
Graphical schema comparison is available in Visual Studio and Azure Data Studio.
330
+
Graphical schema comparison is available in Visual Studio and Visual Studio Code.
@@ -34,15 +34,15 @@ The SQL database projects framework around your database code that adds two foun
34
34
35
35
:::image type="content" source="media/sql-database-projects/sqlproj-summary.png" alt-text="Screenshot of Summary of SQL Database Projects containing pre-deployment and post-deployment scripts as well as database objects." lightbox="media/sql-database-projects/sqlproj-summary.png":::
36
36
37
-
The functionality for SQL database projects is provided by the [Microsoft.SqlServer.DacFx](https://www.nuget.org/packages/Microsoft.SqlServer.DacFx/) .NET library and is surfaced in several [tools for SQL development](sql-projects-tools.md). DacFx has multiple extensibility points, such as modification of deployment steps and the ability to create custom rules for code analysis. The project SDK for SQL projects is [Microsoft.Build.Sql](https://www.nuget.org/packages/Microsoft.Build.Sql/), is [advised for new development](#original-projects-vs-sdk-style-projects) and is the format used by the SQL Database Projects extension for Azure Data Studio and VS Code. Support for SDK-style SQL projects in Visual Studio is in preview.
37
+
The functionality for SQL database projects is provided by the [Microsoft.SqlServer.DacFx](https://www.nuget.org/packages/Microsoft.SqlServer.DacFx/) .NET library and is surfaced in several [tools for SQL development](sql-projects-tools.md). DacFx has multiple extensibility points, such as modification of deployment steps and the ability to create custom rules for code analysis. The project SDK for SQL projects is [Microsoft.Build.Sql](https://www.nuget.org/packages/Microsoft.Build.Sql/), is [advised for new development](#original-projects-vs-sdk-style-projects) and is the format used by the SQL Database Projects extension for Visual Studio Code. Support for SDK-style SQL projects in Visual Studio is in preview.
38
38
39
39
### Validation
40
40
41
41
When a SQL project is built, the relationships between objects are validated. For example, a view definition can't contain a table or columns that don't exist in the SQL project.
42
42
43
43
Additionally, a SQL project contains a property in its `.sqlproj` file called the "[target platform](concepts/target-platform.md)". This information is used during the build process to validate that the functions and T-SQL syntax exists in that version of SQL. For example, the JSON functions added in SQL Server 2022 can't be used in a SQL project set to the Sql140 (SQL Server 2017) target platform.
44
44
45
-
To build a SQL project, we run dotnet build from the command line. In graphical tools that support SQL projects (Azure Data Studio, VS Code, and Visual Studio), there's a menu item to build the SQL project.
45
+
To build a SQL project, we run dotnet build from the command line. In graphical tools that support SQL projects (Visual StudioCode and Visual Studio), there's a menu item to build the SQL project.
46
46
47
47
The console output of the build process might contain errors (build failure) or warnings. Build warnings can include inconsistent casing in object names and other [customizable best practices](concepts/sql-code-analysis/sql-code-analysis.md), but don't fail the build.
48
48
@@ -78,7 +78,7 @@ SQL database projects are used to track the source of truth for database state,
78
78
79
79
:::image type="content" source="media/sql-database-projects/project-files.png" alt-text="Screenshot of VS Code with AdventureWorks SQL project open, displaying a table in the editor." lightbox="media/sql-database-projects/project-files.png":::
80
80
81
-
SQL database projects support the SQL Server and Azure SQL family of databases, including Azure SQL Database and Azure Synapse Analytics. Whether you're developing an application or a data warehouse, SQL database projects can be used to manage the schema of your database. SQL projects can be developed from [tools](sql-projects-tools.md) in Visual Studio, VS Code, and Azure Data Studio.
81
+
SQL database projects support the SQL Server and Azure SQL family of databases, including Azure SQL Database and Azure Synapse Analytics. Whether you're developing an application or a data warehouse, SQL database projects can be used to manage the schema of your database. SQL projects can be developed from [tools](sql-projects-tools.md) in Visual Studio, and Visual Studio Code.
82
82
83
83
## Original projects vs SDK-style projects
84
84
@@ -100,7 +100,7 @@ The exception to the functionality coverage is support for SQLCLR objects, which
0 commit comments