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
**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).
25
25
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).
27
27
28
28
:::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.":::
29
29
@@ -34,7 +34,7 @@ SSDT is installed as a Visual Studio component, both for [online installation](#
34
34
35
35
## Install SSDT with Visual Studio
36
36
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/).
38
38
39
39
To modify the installed Visual Studio workloads to include SSDT, use the Visual Studio Installer.
40
40
@@ -48,9 +48,15 @@ To modify the installed Visual Studio workloads to include SSDT, use the Visual
48
48
49
49
### Visual Studio for Arm64
50
50
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:
52
52
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.
54
60
55
61
1. In the installer, select the **Individual components** tab and search for **SQL Server Data Tools**.
56
62
@@ -62,9 +68,17 @@ Visual Studio is available as a [native Arm64 application](/visualstudio/install
62
68
63
69
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).
64
70
71
+
### [Visual Studio 2026 extensions](#tab/vs2026)
72
+
73
+
The extensions for Visual Studio 2022 and 2026 are shared:
Copy file name to clipboardExpand all lines: docs/ssdt/sql-server-data-tools-sdk-style.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,10 +4,10 @@ description: SDK-style SQL projects in Visual Studio enable the next generation
4
4
author: dzsquared
5
5
ms.author: drskwier
6
6
ms.reviewer: randolphwest
7
-
ms.date: 10/14/2025
7
+
ms.date: 12/03/2025
8
8
ms.service: sql
9
9
ms.subservice: ssdt
10
-
ms.topic: conceptual
10
+
ms.topic: article
11
11
---
12
12
13
13
# 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
22
22
- NuGet [package references](../tools/sql-database-projects/concepts/package-references.md) for database references
23
23
- Default globbing pattern for `.sql` files in the project
24
24
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.
26
26
27
27
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).
28
28
@@ -39,9 +39,9 @@ To install the SDK-style SQL projects in Visual Studio 2022, follow these steps:
39
39
40
40
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).
41
41
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":::
43
43
44
-
4. Continue the install without selecting workloads or extra features.
44
+
1. Continue the install without selecting workloads or extra features.
45
45
46
46
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.
Copy file name to clipboardExpand all lines: docs/ssdt/sql-server-data-tools.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,10 +4,10 @@ description: View resources on database development tasks that you can accomplis
4
4
author: dzsquared
5
5
ms.author: drskwier
6
6
ms.reviewer: randolphwest
7
-
ms.date: 09/09/2025
7
+
ms.date: 12/03/2025
8
8
ms.service: sql
9
9
ms.subservice: ssdt
10
-
ms.topic: conceptual
10
+
ms.topic: article
11
11
f1_keywords:
12
12
- "sql.data.tools.errortask.generichelp"
13
13
- "sql.data.tools.sqlserverobjectexplorer"
@@ -27,9 +27,9 @@ The core of SQL Server Data Tools functionality is available as a workload compo
27
27
28
28
## Release notes
29
29
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:
31
31
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).
33
33
- Analysis Services (SSAS) extension release notes are listed on the [extension marketplace](https://marketplace.visualstudio.com/items?itemName=ProBITools.MicrosoftAnalysisServicesModelingProjects2022)
34
34
- Integration Services (SSIS) extension release notes are listed on the [extension marketplace](https://marketplace.visualstudio.com/items?itemName=SSIS.MicrosoftDataToolsIntegrationServices)
35
35
- 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
55
55
56
56
## SDK-style SQL projects (preview)
57
57
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).
@@ -82,17 +82,20 @@ SQL database projects support the SQL Server and Azure SQL family of databases,
82
82
83
83
## Original projects vs SDK-style projects
84
84
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).
86
89
87
90
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:
88
91
89
-
- .NET 8 support (cross platform)
92
+
- .NET 8+ support (cross platform)
90
93
- NuGet [package references](concepts/package-references.md) for database references
91
94
- Default globbing pattern for .sql files in the project
92
95
93
96
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).
94
97
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).
0 commit comments