Skip to content

Commit 7b2a949

Browse files
authored
Merge pull request #35946 from dzsquared/drskwier/sqlproj-dec2025
ignite rel cleanup
2 parents a29e1bc + 69e0b19 commit 7b2a949

File tree

5 files changed

+90
-67
lines changed

5 files changed

+90
-67
lines changed

docs/ssdt/download-sql-server-data-tools-ssdt.md

Lines changed: 36 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: "Learn about SQL Server Data Tools (SSDT). See how to install this
44
author: dzsquared
55
ms.author: drskwier
66
ms.reviewer: randolphwest
7-
ms.date: 09/09/2025
7+
ms.date: 12/03/2025
88
ms.service: sql
99
ms.subservice: ssdt
1010
ms.topic: install-set-up-deploy
@@ -23,7 +23,7 @@ monikerRange: ">=aps-pdw-2016 || =azuresqldb-current || =azure-sqldw-latest || >
2323

2424
**SQL Server Data Tools (SSDT)** is a set of development tooling for building SQL Server databases, Azure SQL databases, Analysis Services (AS) data models, Integration Services (IS) packages, and Reporting Services (RS) reports. With SSDT, you can design and deploy SQL objects with the same project concept as other application development tools. The **SQL projects** capability extends to CI/CD pipelines, enabling you to automate the build and deployment of your database projects with the [SqlPackage CLI](../tools/sqlpackage/sqlpackage.md).
2525

26-
The release notes for SSDT and its components are available for [Visual Studio 2017, 2019, and 2022](sql-server-data-tools.md#release-notes). An overview of the core SSDT functionality is provided in the [SSDT Overview](sql-server-data-tools.md#core-sql-server-data-tools).
26+
The release notes for SSDT and its components are available for [Visual Studio 2017, 2019, 2022, and 2026](sql-server-data-tools.md#release-notes). An overview of the core SSDT functionality is provided in the [SSDT Overview](sql-server-data-tools.md#core-sql-server-data-tools).
2727

2828
:::image type="content" source="media/download-sql-server-data-tools-ssdt/install-layout.png" alt-text="Screenshot of graphic with SQL Server Data Tools component and three extensions.":::
2929

@@ -34,7 +34,7 @@ SSDT is installed as a Visual Studio component, both for [online installation](#
3434
3535
## Install SSDT with Visual Studio
3636

37-
If [Visual Studio 2022](/visualstudio/install/install-visual-studio?preserve-view=true&view=vs-2022) or [Visual Studio 2019](/visualstudio/install/install-visual-studio?preserve-view=true&view=vs-2019) is already installed, you can edit the list of workloads to include SSDT. If you don't have Visual Studio 2019/2022 installed, then you can download and install [Visual Studio 2022](https://visualstudio.microsoft.com/downloads/).
37+
If [Visual Studio 2026](/visualstudio/install/install-visual-studio?preserve-view=true&view=vs-2026) or [Visual Studio 2022](/visualstudio/install/install-visual-studio?preserve-view=true&view=vs-2022) is already installed, you can edit the list of workloads to include SSDT. If you don't have Visual Studio 2022 or 2026 installed, then you can download and install [Visual Studio 2026](https://visualstudio.microsoft.com/downloads/).
3838

3939
To modify the installed Visual Studio workloads to include SSDT, use the Visual Studio Installer.
4040

@@ -48,9 +48,15 @@ To modify the installed Visual Studio workloads to include SSDT, use the Visual
4848

4949
### Visual Studio for Arm64
5050

51-
Visual Studio is available as a [native Arm64 application](/visualstudio/install/visual-studio-on-arm-devices) on Windows 11 Arm64. In Visual Studio 17.10 and later, SSDT is available for Arm64 with [some limitations](https://techcommunity.microsoft.com/blog/azuresqlblog/announcing-sql-server-data-tools-ssdt-for-arm64-architecture-in-visual-studio-17/4103928). To install or configure Visual Studio to include SSDT on an Arm64 device:
51+
Visual Studio is available as a [native Arm64 application](/visualstudio/install/visual-studio-on-arm-devices) on Windows 11 Arm64. In Visual Studio 2026, SSDT is available for Arm64 with some limitations:
5252

53-
1. Install Visual Studio 17.10 or later on your Arm64 device.
53+
- IntelliSense and code completion aren't available for T-SQL files in SQL projects
54+
- The T-SQL debugger isn't available
55+
- Visual Studio can't connect to LocalDB
56+
57+
To install or configure Visual Studio to include SSDT on an Arm64 device:
58+
59+
1. Install Visual Studio 2026 or later on your Arm64 device.
5460

5561
1. In the installer, select the **Individual components** tab and search for **SQL Server Data Tools**.
5662

@@ -62,9 +68,17 @@ Visual Studio is available as a [native Arm64 application](/visualstudio/install
6268

6369
For Analysis Services (SSAS), Integration Services (SSIS), or Reporting Services (SSRS) projects, you can install the appropriate [extensions](/visualstudio/ide/finding-and-using-visual-studio-extensions) from within Visual Studio with **Extensions** > **Manage Extensions** or from the [Marketplace](https://marketplace.visualstudio.com/search?term=services&target=VS&category=All%20categories&vsVersion=&sortBy=Relevance).
6470

71+
### [Visual Studio 2026 extensions](#tab/vs2026)
72+
73+
The extensions for Visual Studio 2022 and 2026 are shared:
74+
75+
- [Analysis Services](https://marketplace.visualstudio.com/items?itemName=ProBITools.MicrosoftAnalysisServicesModelingProjects2022)
76+
- [Integration Services](https://marketplace.visualstudio.com/items?itemName=SSIS.MicrosoftDataToolsIntegrationServices)
77+
- [Reporting Services](https://marketplace.visualstudio.com/items?itemName=ProBITools.MicrosoftReportProjectsforVisualStudio2022)
78+
6579
### [Visual Studio 2022 extensions](#tab/vs2022)
6680

67-
Extensions for Visual Studio 2022:
81+
The extensions for Visual Studio 2022 and 2026 are shared:
6882

6983
- [Analysis Services](https://marketplace.visualstudio.com/items?itemName=ProBITools.MicrosoftAnalysisServicesModelingProjects2022)
7084
- [Integration Services](https://marketplace.visualstudio.com/items?itemName=SSIS.MicrosoftDataToolsIntegrationServices)
@@ -82,25 +96,35 @@ Extensions for Visual Studio 2019:
8296

8397
## Supported SQL versions
8498

99+
### [Supported SQL versions in Visual Studio 2026](#tab/vs2026)
100+
101+
Supported SQL versions in Visual Studio 2026:
102+
103+
| Project templates | SQL platforms supported |
104+
| --- | --- |
105+
| Relational databases | [!INCLUDE [sssql16-md](../includes/sssql16-md.md)] - [!INCLUDE [sssql22-md](../includes/sssql25-md.md)]<br /><br />Azure SQL Database, Azure SQL Managed Instance<br /><br />Azure Synapse Analytics Dedicated Pools<br />Azure Synapse Analytics Serverless Pools<br /><br />Warehouse in Microsoft Fabric<br />SQL database in Microsoft Fabric |
106+
| Analysis Services models<br /><br />Reporting Services reports | [!INCLUDE [sssql16-md](../includes/sssql16-md.md)] - [!INCLUDE [sssql25-md](../includes/sssql25-md.md)] |
107+
| Integration Services packages | [!INCLUDE [sssql19-md](../includes/sssql19-md.md)] - [!INCLUDE [sssql25-md](../includes/sssql25-md.md)] |
108+
85109
### [Supported SQL versions in Visual Studio 2022](#tab/vs2022)
86110

87111
Supported SQL versions in Visual Studio 2022:
88112

89113
| Project templates | SQL platforms supported |
90114
| --- | --- |
91-
| Relational databases | [!INCLUDE [sssql16-md](../includes/sssql16-md.md)] - [!INCLUDE [sssql22-md](../includes/sssql22-md.md)]<br /><br />Azure SQL Database, Azure SQL Managed Instance<br /><br />Azure Synapse Analytics Dedicated Pools<br />Azure Synapse Analytics Serverless Pools (requires VS2022 17.7 see [the release notes](/visualstudio/releases/2022/release-notes-v17.7#support-for-serverless-sql-pool-in-ssdt))<br /><br />Warehouse in Microsoft Fabric (requires VS2022 17.12)<br />SQL database in Microsoft Fabric (requires VS2022 17.12) |
92-
| Analysis Services models<br /><br />Reporting Services reports` | SQL Server 2016 - SQL Server 2022 |
93-
| Integration Services packages | SQL Server 2019 - SQL Server 2022 |
115+
| Relational databases | [!INCLUDE [sssql16-md](../includes/sssql16-md.md)] - [!INCLUDE [sssql22-md](../includes/sssql22-md.md)]<br /><br />Azure SQL Database, Azure SQL Managed Instance<br /><br />Azure Synapse Analytics Dedicated Pools<br />Azure Synapse Analytics Serverless Pools (requires VS2022 17.7) |
116+
| Analysis Services models<br /><br />Reporting Services reports | [!INCLUDE [sssql16-md](../includes/sssql16-md.md)] - [!INCLUDE [sssql22-md](../includes/sssql22-md.md)] |
117+
| Integration Services packages | [!INCLUDE [sssql19-md](../includes/sssql19-md.md)] - [!INCLUDE [sssql22-md](../includes/sssql22-md.md)] |
94118

95119
### [Supported SQL versions in Visual Studio 2019](#tab/vs2019)
96120

97121
Supported SQL versions in Visual Studio 2019:
98122

99123
| Project templates | SQL platforms supported |
100124
| --- | --- |
101-
| Relational databases | SQL Server 2012 - SQL Server 2019<br /><br />Azure SQL Database, Azure SQL Managed Instance<br /><br />Azure Synapse Analytics (dedicated pools only) |
102-
| Analysis Services models<br /><br />Reporting Services reports | SQL Server 2008 - SQL Server 2019 |
103-
| Integration Services packages | SQL Server 2012 - SQL Server 2022 |
125+
| Relational databases | [!INCLUDE [sssql11-md](../includes/sssql11-md.md)] - [!INCLUDE [sssql19-md](../includes/sssql19-md.md)]<br /><br />Azure SQL Database, Azure SQL Managed Instance<br /><br />Azure Synapse Analytics (dedicated pools only) |
126+
| Analysis Services models<br /><br />Reporting Services reports | [!INCLUDE [sql2008-md](../includes/sql2008-md.md)] - [!INCLUDE [sssql19-md](../includes/sssql19-md.md)] |
127+
| Integration Services packages | [!INCLUDE [sssql11-md](../includes/sssql11-md.md)] - [!INCLUDE [sssql22-md](../includes/sssql22-md.md)] |
104128

105129
---
106130

docs/ssdt/sql-server-data-tools-sdk-style.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -4,10 +4,10 @@ description: SDK-style SQL projects in Visual Studio enable the next generation
44
author: dzsquared
55
ms.author: drskwier
66
ms.reviewer: randolphwest
7-
ms.date: 10/14/2025
7+
ms.date: 12/03/2025
88
ms.service: sql
99
ms.subservice: ssdt
10-
ms.topic: conceptual
10+
ms.topic: article
1111
---
1212

1313
# SQL Server Data Tools, SDK-style (preview)
@@ -22,7 +22,7 @@ The original SQL project format is based on MSBuild (.NET Framework) and is the
2222
- NuGet [package references](../tools/sql-database-projects/concepts/package-references.md) for database references
2323
- Default globbing pattern for `.sql` files in the project
2424

25-
New development work should consider using the SDK-style project format, as it's the format that is supported in the future. SDK-style projects have a superset of functionality from original SQL projects and existing SQL projects can be converted to SDK-style projects through [modification of the project file](../tools/sql-database-projects/howto/convert-original-sql-project.md). The exception to the functionality coverage is support for SQLCLR objects, which require .NET Framework and aren't supported in SDK-style projects.
25+
Visual Studio 2026 doesn't support SDK-style SQL projects, and the original SQL projects are the only SQL project format available in that version of Visual Studio. Visual Studio 2022 is the only version of Visual Studio that contains SDK-style SQL projects in the **SQL Server Data Tools, SDK-style (preview)** component.
2626

2727
For more information about SQL projects, see [What are SQL database projects?](../tools/sql-database-projects/sql-database-projects.md). The Microsoft.Build.Sql SDK is available on [GitHub](https://github.com/microsoft/DacFx) and on [NuGet.org](https://www.nuget.org/packages/Microsoft.build.sql).
2828

@@ -39,9 +39,9 @@ To install the SDK-style SQL projects in Visual Studio 2022, follow these steps:
3939

4040
1. Search for ".NET SDK" in the **Individual components** tab and select the ".NET SDK" component. Selecting this item automatically selects required dependencies, including supported .NET runtimes. The .NET SDK component enables support for additional versions of the Microsoft.Build.Sql SDK in Visual Studio, which are available through [NuGet.org](https://www.nuget.org/packages/Microsoft.build.sql#versions-body-tab).
4141

42-
:::image type="content" source="media/sql-server-data-tools-sdk-style/installer-individual-component.png" alt-text="Screenshot of the Visual Studio installer with the individual components tab open." lightbox="media/sql-server-data-tools-sdk-style/installer-individual-component.png":::
42+
:::image type="content" source="media/sql-server-data-tools-sdk-style/installer-individual-component.png" alt-text="Screenshot of the Visual Studio installer with the individual components tab open." lightbox="media/sql-server-data-tools-sdk-style/installer-individual-component.png":::
4343

44-
4. Continue the install without selecting workloads or extra features.
44+
1. Continue the install without selecting workloads or extra features.
4545

4646
The Visual Studio [documentation](/visualstudio/install/modify-visual-studio#change-workloads-or-individual-components) provides additional information on modifying Visual Studio installations to select individual components.
4747

docs/ssdt/sql-server-data-tools.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -4,10 +4,10 @@ description: View resources on database development tasks that you can accomplis
44
author: dzsquared
55
ms.author: drskwier
66
ms.reviewer: randolphwest
7-
ms.date: 09/09/2025
7+
ms.date: 12/03/2025
88
ms.service: sql
99
ms.subservice: ssdt
10-
ms.topic: conceptual
10+
ms.topic: article
1111
f1_keywords:
1212
- "sql.data.tools.errortask.generichelp"
1313
- "sql.data.tools.sqlserverobjectexplorer"
@@ -27,9 +27,9 @@ The core of SQL Server Data Tools functionality is available as a workload compo
2727
2828
## Release notes
2929

30-
The latest release notes for SQL Server Data Tools with Visual Studio 2022 can be found in the following locations:
30+
The latest release notes for SQL Server Data Tools with Visual Studio 2022 and Visual Studio 2026 can be found in the following locations:
3131

32-
- SQL Server Data Tools (SSDT) release notes are listed with the [release notes for Visual Studio 2022](/visualstudio/releases/2022/release-notes)
32+
- SQL Server Data Tools (SSDT) release notes are listed with the release notes for [Visual Studio 2022](/visualstudio/releases/2022/release-notes) and [Visual Studio 2026](/visualstudio/releases/2026/release-notes).
3333
- Analysis Services (SSAS) extension release notes are listed on the [extension marketplace](https://marketplace.visualstudio.com/items?itemName=ProBITools.MicrosoftAnalysisServicesModelingProjects2022)
3434
- Integration Services (SSIS) extension release notes are listed on the [extension marketplace](https://marketplace.visualstudio.com/items?itemName=SSIS.MicrosoftDataToolsIntegrationServices)
3535
- Reporting Services (SSRS) extension release notes are listed on the [extension marketplace](https://marketplace.visualstudio.com/items?itemName=ProBITools.MicrosoftReportProjectsforVisualStudio2022)
@@ -55,7 +55,7 @@ For more information about SQL projects and database development tasks that you
5555

5656
## SDK-style SQL projects (preview)
5757

58-
Support for the Microsoft.Build.Sql project SDK is available in preview in Visual Studio as the next generation of SQL projects. The SDK-style SQL projects are based on the .NET SDK-style project format and are designed to be more flexible and extensible than the original SQL projects. The SDK-style SQL projects are recommended for new development and are available in Visual Studio 2022 as an optional component "SQL Server Data Tools, SDK-style (preview)." For more information about the SDK-style SQL projects and Visual Studio, see [SQL Server Data Tools, SDK-style (preview)](sql-server-data-tools-sdk-style.md).
58+
Support for the Microsoft.Build.Sql project SDK is available in preview in Visual Studio 2022 as the next generation of SQL projects. The SDK-style SQL projects are based on the .NET SDK-style project format and are designed to be more flexible and extensible than the original SQL projects. The SDK-style SQL projects are available in Visual Studio 2022 as an optional component "SQL Server Data Tools, SDK-style (preview)" and aren't available in Visual Studio 2026. For more information about the SDK-style SQL projects and Visual Studio, see [SQL Server Data Tools, SDK-style (preview)](sql-server-data-tools-sdk-style.md).
5959

6060
## Related content
6161

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

Lines changed: 7 additions & 4 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: 03/11/2025
7+
ms.date: 12/03/2025
88
ms.service: sql
99
ms.subservice: sql-database-projects
1010
ms.topic: overview
@@ -82,17 +82,20 @@ SQL database projects support the SQL Server and Azure SQL family of databases,
8282

8383
## Original projects vs SDK-style projects
8484

85-
The Microsoft.Build.Sql SDK-style project format is based on the new SDK-style projects introduced in .NET Core and is the format used by the SQL Database Projects extension for Azure Data Studio and VS Code. Microsoft.Build.Sql projects are replacing the original SQL project format based on MSBuild (.NET Framework). Support for SDK-style SQL projects in Visual Studio is currently in preview and under active development, with both the original and SDK-style project formats available in Visual Studio.
85+
The Microsoft.Build.Sql SDK-style project format is based on the new SDK-style projects introduced in .NET Core and is the format used by the SQL Database Projects extension for VS Code and with the SQL database in Fabric integrated source control. Microsoft.Build.Sql projects are replacing the original SQL project format based on MSBuild (.NET Framework).
86+
87+
> [!NOTE]
88+
> Visual Studio 2026 only supports the original SQL project format. SDK-style SQL projects are in preview in Visual Studio 2022 and generally available in VS Code. Learn more about [SQL projects tools](sql-projects-tools.md).
8689
8790
New development work should consider using Microsoft.Build.Sql projects, as SDK-style projects are the format that will be supported in the future. The SDK-style project format is more flexible and contains new features not available with the original SQL projects:
8891

89-
- .NET 8 support (cross platform)
92+
- .NET 8+ support (cross platform)
9093
- NuGet [package references](concepts/package-references.md) for database references
9194
- Default globbing pattern for .sql files in the project
9295

9396
SDK-style projects have a superset of functionality from original SQL projects and existing SQL projects can be converted to SDK-style projects through [modification of the project file](howto/convert-original-sql-project.md).
9497

95-
The exception to the functionality coverage is support for SQLCLR objects, which require .NET Framework. A project that contains SQLCLR objects can be converted to an SDK-style project, but the project requires .NET Framework and must be built in Visual Studio on Windows. Once the project with the SQLCLR object is built, the `.dacpac` can be deployed with SqlPackage on .NET and .NET Framework and can be used as a `.dacpac` reference in a project (both same database or same server different database).
98+
The exception to the functionality coverage is support for SQLCLR objects, which are supported in both original and SDK-style SQL projects but require .NET Framework. An original SQL project that contains SQLCLR objects can be converted to an SDK-style project, but the project requires .NET Framework instead of .NET for the project build. Once the project with the SQLCLR object is built, the `.dacpac` can be deployed with SqlPackage on .NET and .NET Framework and can be used as a `.dacpac` reference in a project (both same database or same server different database).
9699

97100
## Related content
98101

0 commit comments

Comments
 (0)