Skip to content

Commit e8def82

Browse files
committed
ADS: SQL Tools
1 parent 8a71de3 commit e8def82

8 files changed

Lines changed: 53 additions & 55 deletions

File tree

docs/tools/sql-database-projects/concepts/data-tier-applications/unpack-dacpac-file.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: "Unpack a DACPAC file to review or examine the contents."
44
author: dzsquared
55
ms.author: drskwier
66
ms.reviewer: randolphwest, maghan
7-
ms.date: 12/16/2025
7+
ms.date: 02/06/2026
88
ms.service: sql
99
ms.subservice: sql-database-projects
1010
ms.topic: how-to
@@ -61,9 +61,9 @@ Deploying the `.dacpac` to a test instance results in the contents of the `.dacp
6161
> [!NOTE]
6262
> One option for creating a test instance locally is with [SQL Server in Docker](../../../../linux/quickstart-install-connect-docker.md#pullandrun2022).
6363
64-
### Deploy the DACPAC using Azure Data Studio
64+
### Deploy the DACPAC using Visual Studio Code
6565

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.
6767

6868
1. Connect to the desired instance. Right-click on the server node and select **Data-tier application wizard** from the menu.
6969

@@ -79,7 +79,7 @@ Deploying the `.dacpac` to a test instance results in the contents of the `.dacp
7979

8080
### Other tools with DACPAC deployment capabilities
8181

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:
8383

8484
- SQL Server Management Studio
8585
- Visual Studio: SQL Server Data Tools
@@ -119,5 +119,5 @@ namespace DacUnpack
119119

120120
- [Data-tier applications (DAC) overview](overview.md)
121121
- [SqlPackage Publish parameters, properties, and SQLCMD variables](../../../sqlpackage/sqlpackage-publish.md)
122-
- [SQL Server dacpac extension in Azure Data Studio](/azure-data-studio/extensions/sql-server-dacpac-extension)
122+
- [Data-tier Application (Preview)](../../../visual-studio-code-extensions/mssql/mssql-data-tier-application.md)
123123
- [Install SQL Server Data Tools (SSDT) for Visual Studio](../../../../ssdt/download-sql-server-data-tools-ssdt.md)

docs/tools/sql-database-projects/concepts/database-references.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Extend a SQL project with references to additional database compone
44
author: dzsquared
55
ms.author: drskwier
66
ms.reviewer: maghan, randolphwest
7-
ms.date: 10/10/2025
7+
ms.date: 02/06/2026
88
ms.service: sql
99
ms.subservice: sql-database-projects
1010
ms.topic: concept-article
@@ -144,7 +144,7 @@ FROM [$(WWIServer)].[$(WorldWideImporters)].[Purchasing].[Suppliers]
144144

145145
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**.
146146

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.":::
148148

149149
The available reference types are:
150150

docs/tools/sql-database-projects/concepts/schema-comparison.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Visualize the difference in database models with schema compare.
44
author: dzsquared
55
ms.author: drskwier
66
ms.reviewer: maghan, randolphwest, tsiddique
7-
ms.date: 10/10/2025
7+
ms.date: 02/06/2026
88
ms.service: sql
99
ms.subservice: sql-database-projects
1010
ms.topic: overview
@@ -46,7 +46,7 @@ The differences between source and target appear in a grid for easy review. Comp
4646
- SQL database project
4747
- `.dacpac` file
4848

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.
5050

5151
### Schema comparison options
5252

@@ -68,7 +68,7 @@ The comparison definition for schema compare can be saved as an `.scmp` file, kn
6868
- comparison options
6969
- excluded object types
7070

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.
7272

7373
## Launch and use schema compare
7474

@@ -189,7 +189,7 @@ More in-depth information about schema comparison in Visual Studio Code is avail
189189

190190
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.
191191

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":::
193193

194194
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.
195195

docs/tools/sql-database-projects/howto/compare-database-project.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -4,16 +4,16 @@ description: "Compare a project and a database and with different approaches."
44
author: dzsquared
55
ms.author: drskwier
66
ms.reviewer: maghan, randolphwest
7-
ms.date: 08/30/2024
7+
ms.date: 02/06/2026
88
ms.service: sql
99
ms.subservice: sql-database-projects
1010
ms.topic: how-to
1111
ms.collection:
1212
- data-tools
13-
zone_pivot_groups: sq1-sql-projects-tools
1413
ms.custom:
1514
- ignite-2024
1615
- sfi-ropc-nochange
16+
zone_pivot_groups: sq1-sql-projects-tools
1717
---
1818

1919
# Compare a database and a project
@@ -42,14 +42,14 @@ This article reviews methods for comparing a database and a SQL project using di
4242

4343
::: zone pivot="sq1-visual-studio-sdk"
4444

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.
4646

4747
::: zone-end
4848

4949
::: zone pivot="sq1-visual-studio-code"
5050

5151
- [.NET 8 SDK](https://dotnet.microsoft.com/download/dotnet/8.0)
52-
- [SQL Database Projects extension for Azure Data Studio](/azure-data-studio/extensions/sql-database-project-extension)
52+
- [SQL Database Projects extension](../../visual-studio-code-extensions/sql-database-projects/sql-database-projects-extension.md)
5353

5454
::: zone-end
5555

@@ -127,7 +127,7 @@ An advantage of the deploy report XML operation is that it can be used to automa
127127

128128
## Import changes from a database
129129

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.
131131

132132
### Prerequisites
133133

docs/tools/sql-database-projects/howto/convert-original-sql-project.md

Lines changed: 10 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: "Create an SDK-style SQL project from an existing project."
44
author: dzsquared
55
ms.author: drskwier
66
ms.reviewer: maghan, randolphwest
7-
ms.date: 09/25/2025
7+
ms.date: 02/06/2026
88
ms.service: sql
99
ms.subservice: sql-database-projects
1010
ms.topic: how-to
@@ -39,7 +39,6 @@ SDK-style projects aren't supported in SQL Server Data Tools (SSDT) in Visual St
3939

4040
- the command line
4141
- the SQL Database Projects extension in Visual Studio Code
42-
- the SQL Database Projects extension in Azure Data Studio
4342
- the SQL Server Data Tools, SDK-style (preview) in Visual Studio 2022
4443

4544
> [!NOTE]
@@ -66,8 +65,8 @@ SDK-style projects aren't supported in SQL Server Data Tools (SSDT) in Visual St
6665
::: zone pivot="sq1-visual-studio-code"
6766

6867
- [.NET 8 SDK](https://dotnet.microsoft.com/download/dotnet/8.0)
69-
- [VS Code](https://code.visualstudio.com/Download)
70-
- [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)
69+
- [SQL Database Projects extension](../../visual-studio-code-extensions/sql-database-projects/sql-database-projects-extension.md)
7170

7271
::: zone-end
7372

@@ -103,7 +102,7 @@ Build the project in Visual Studio by right-clicking on the database node in **S
103102

104103
::: zone pivot="sq1-visual-studio-code"
105104

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**.
107106

108107
::: zone-end
109108

@@ -255,7 +254,6 @@ The SQL project is no longer compatible with Visual Studio 2022. To build or edi
255254

256255
- the command line
257256
- the SQL Database Projects extension in Visual Studio Code
258-
- the SQL Database Projects extension in Azure Data Studio
259257
- the SQL Server Data Tools, SDK-style (preview) in Visual Studio 2022
260258

261259
::: zone-end
@@ -268,7 +266,7 @@ The project file is now in the SDK-style format, but to open it in Visual Studio
268266

269267
::: zone pivot="sq1-visual-studio-code"
270268

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**.
272270

273271
::: zone-end
274272

@@ -303,7 +301,7 @@ The syntax for DacpacVerify is to specify the filepath to two `.dacpac` files as
303301
DacpacVerify original_project.dacpac modified_project.dacpac
304302
```
305303

306-
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.
307305

308306
::: zone pivot="sq1-visual-studio"
309307

@@ -313,23 +311,23 @@ Launch Visual Studio without a project loaded. Go to **Tools** > **SQL Server**
313311

314312
::: zone pivot="sq1-visual-studio-sdk"
315313

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.
317315

318316
::: zone-end
319317

320318
::: zone pivot="sq1-visual-studio-code"
321319

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.
323321

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`.
325323

326324
Select the original `.dacpac` file as the source and the modified `.dacpac` file as the target.
327325

328326
::: zone-end
329327

330328
::: zone pivot="sq1-command-line"
331329

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.
333331

334332
::: zone-end
335333

docs/tools/sql-database-projects/sql-database-projects.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: "This overview introduces SQL database projects, which enable datab
44
author: dzsquared
55
ms.author: drskwier
66
ms.reviewer: maghan, randolphwest
7-
ms.date: 12/03/2025
7+
ms.date: 02/06/2026
88
ms.service: sql
99
ms.subservice: sql-database-projects
1010
ms.topic: overview
@@ -34,15 +34,15 @@ The SQL database projects framework around your database code that adds two foun
3434

3535
:::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":::
3636

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.
3838

3939
### Validation
4040

4141
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.
4242

4343
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.
4444

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 Studio Code and Visual Studio), there's a menu item to build the SQL project.
4646

4747
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.
4848

@@ -78,7 +78,7 @@ SQL database projects are used to track the source of truth for database state,
7878

7979
:::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":::
8080

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.
8282

8383
## Original projects vs SDK-style projects
8484

@@ -100,7 +100,7 @@ The exception to the functionality coverage is support for SQLCLR objects, which
100100
## Related content
101101

102102
- [Project-Oriented Offline Database Development](../../ssdt/project-oriented-offline-database-development.md)
103-
- [SQL Database Projects extension](/azure-data-studio/extensions/sql-database-project-extension)
103+
- [SQL Database Projects extension](../visual-studio-code-extensions/sql-database-projects/sql-database-projects-extension.md)
104104
- [SqlPackage](../sqlpackage/sqlpackage.md)
105105
- [Sample CI/CD pipelines for SQL projects](https://github.com/Azure-Samples/sql-projects-devops-samples)
106106
- [GitHub sql-action](https://github.com/azure/sql-action)

0 commit comments

Comments
 (0)