CommunityToolkit.Aspire.Hosting.SqlDatabaseProjects 9.8.1-beta.406

Prefix Reserved
This is a prerelease version of CommunityToolkit.Aspire.Hosting.SqlDatabaseProjects.
There is a newer prerelease version of this package available.
See the version list below for details.
dotnet add package CommunityToolkit.Aspire.Hosting.SqlDatabaseProjects --version 9.8.1-beta.406
                    
NuGet\Install-Package CommunityToolkit.Aspire.Hosting.SqlDatabaseProjects -Version 9.8.1-beta.406
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="CommunityToolkit.Aspire.Hosting.SqlDatabaseProjects" Version="9.8.1-beta.406" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="CommunityToolkit.Aspire.Hosting.SqlDatabaseProjects" Version="9.8.1-beta.406" />
                    
Directory.Packages.props
<PackageReference Include="CommunityToolkit.Aspire.Hosting.SqlDatabaseProjects" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add CommunityToolkit.Aspire.Hosting.SqlDatabaseProjects --version 9.8.1-beta.406
                    
#r "nuget: CommunityToolkit.Aspire.Hosting.SqlDatabaseProjects, 9.8.1-beta.406"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package CommunityToolkit.Aspire.Hosting.SqlDatabaseProjects@9.8.1-beta.406
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=CommunityToolkit.Aspire.Hosting.SqlDatabaseProjects&version=9.8.1-beta.406&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=CommunityToolkit.Aspire.Hosting.SqlDatabaseProjects&version=9.8.1-beta.406&prerelease
                    
Install as a Cake Tool

CommunityToolkit.Aspire.Hosting.SqlDatabaseProjects library

This package provides .NET Aspire integration for SQL Server Database Projects. It allows you to publish SQL Database Projects as part of your .NET Aspire AppHost projects. It currently works with both MSBuild.Sdk.SqlProj and Microsoft.Build.Sql (aka .sqlprojx) based projects.

Usage

To use this package, install it into your .NET Aspire AppHost project:

dotnet add package CommunityToolkit.Aspire.Hosting.SqlDatabaseProjects

Next, add a reference to the MSBuild.Sdk.SqlProj or Microsoft.Build.Sql project you want to publish in your .NET Aspire AppHost project:

dotnet add reference ../MySqlProj/MySqlProj.csproj

Note: Adding this reference will currently result in warning ASPIRE004. This is a known issue and will be resolved in a future release.

Finally add the project as a resource to your .NET Aspire AppHost:

var builder = DistributedApplication.CreateBuilder(args);

var sql = builder.AddSqlServer("sql")
                 .AddDatabase("test");

builder.AddSqlProject<Projects.MySqlProj>("mysqlproj")
       .WithReference(sql);

builder.Build().Run();

Now when you run your .NET Aspire AppHost project you will see the SQL Database Project being published to the specified SQL Server.

Local .dacpac file support

If you are sourcing your .dacpac file from somewhere other than a project reference, you can also specify the path to the .dacpac file directly:

var builder = DistributedApplication.CreateBuilder(args);

var sql = builder.AddSqlServer("sql")
                 .AddDatabase("test");

builder.AddSqlProject("mysqlproj")
       .WithDacpac("path/to/mysqlproj.dacpac")
       .WithReference(sql);

builder.Build().Run();

Support for existing SQL Server

Instead of using the AddSqlServer method to use a SQL Server container, you can specify a connection string to an existing server:

var builder = DistributedApplication.CreateBuilder(args);

// Get an existing connection string from the configuration
var connection = builder.AddConnectionString("Aspire");

builder.AddSqlProject<Projects.SdkProject>("mysqlproj")
       .WithReference(connection);

builder.Build().Run();

Deployment options support

Define options that affect the behavior of package deployment.

var builder = DistributedApplication.CreateBuilder(args);

var sql = builder.AddSqlServer("sql")
                 .AddDatabase("test");

builder.AddSqlProject("mysqlproj")
       .WithConfigureDacDeployOptions(options => options.IncludeCompositeObjects = true)
       .WithReference(sql);

builder.Build().Run();
Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 is compatible.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
9.8.1-beta.410 110 10/16/2025
9.8.1-beta.408 99 10/16/2025
9.8.1-beta.407 104 10/16/2025
9.8.1-beta.406 108 10/15/2025
9.8.0 1,728 9/26/2025
9.8.0-beta.405 107 10/15/2025
9.8.0-beta.404 112 10/13/2025
9.8.0-beta.402 120 9/29/2025
9.8.0-beta.401 116 9/29/2025
9.8.0-beta.399 122 9/26/2025
9.8.0-beta.398 125 9/25/2025
9.8.0-beta.397 124 9/25/2025
9.8.0-beta.395 118 9/24/2025
9.8.0-beta.394 122 9/23/2025
9.8.0-beta.393 122 9/23/2025
9.8.0-beta.392 119 9/23/2025
9.8.0-beta.389 248 9/18/2025
9.8.0-beta.388 254 9/16/2025
9.8.0-beta.386 262 9/15/2025
9.8.0-beta.385 203 9/15/2025
9.8.0-beta.384 49 9/13/2025
9.8.0-beta.376 133 9/8/2025
9.8.0-beta.375 63 9/6/2025
9.8.0-beta.373 135 9/5/2025
9.8.0-beta.372 135 9/4/2025
9.8.0-beta.370 123 9/2/2025
9.8.0-beta.364 123 9/1/2025
9.7.2 3,100 8/29/2025
9.7.2-beta.362 167 8/29/2025
9.7.2-beta.361 167 8/29/2025
9.7.2-beta.360 170 8/29/2025
9.7.2-beta.359 167 8/28/2025
9.7.2-beta.358 164 8/28/2025
9.7.2-beta.357 173 8/28/2025
9.7.1 817 8/27/2025
9.7.1-beta.355 169 8/27/2025
9.7.1-beta.354 173 8/27/2025
9.7.1-beta.353 166 8/27/2025
9.7.1-beta.352 168 8/27/2025
9.7.1-beta.351 174 8/27/2025
9.7.1-beta.348 144 8/14/2025
9.7.1-beta.344 76 8/10/2025
9.7.1-beta.343 200 8/8/2025
9.7.1-beta.342 202 8/7/2025
9.7.1-beta.341 202 8/6/2025
9.7.1-beta.340 185 8/5/2025
9.7.1-beta.339 184 8/5/2025
9.7.0 1,917 8/1/2025
9.7.0-beta.337 84 8/1/2025
9.7.0-beta.336 98 8/1/2025
9.7.0-beta.335 97 8/1/2025
9.7.0-beta.333 98 7/30/2025
9.6.1-beta.332 101 7/30/2025
9.6.1-beta.331 99 7/30/2025
9.6.1-beta.330 102 7/30/2025
9.6.1-beta.329 100 7/30/2025
9.6.1-beta.328 191 7/29/2025
9.6.1-beta.327 120 7/28/2025
9.6.1-beta.326 116 7/28/2025
9.6.0 2,988 7/10/2025
9.6.0-beta.324 124 7/10/2025
9.5.1-beta.323 121 7/10/2025
9.5.1-beta.322 126 7/10/2025
9.5.1-beta.321 128 7/10/2025
9.5.1-beta.320 127 7/9/2025
9.5.1-beta.319 125 7/8/2025
9.5.1-beta.318 126 7/2/2025
9.5.1-beta.317 123 6/30/2025
9.5.1-beta.315 124 6/26/2025
9.5.1-beta.314 141 6/23/2025
9.5.1-beta.313 125 6/20/2025
9.5.1-beta.312 117 6/20/2025
9.5.1-beta.311 133 6/18/2025
9.5.1-beta.310 148 6/17/2025
9.5.1-beta.309 123 6/17/2025
9.5.1-beta.308 144 6/17/2025
9.5.1-beta.307 144 6/16/2025
9.5.1-beta.306 294 6/11/2025
9.5.1-beta.305 126 6/7/2025
9.5.1-beta.304 114 6/6/2025
9.5.1-beta.303 170 6/4/2025
9.5.1-beta.302 136 6/4/2025
9.5.1-beta.301 148 6/2/2025
9.5.1-beta.300 138 5/28/2025
9.5.0 8,338 5/27/2025
9.5.0-beta.299 146 5/27/2025
9.5.0-beta.298 160 5/26/2025
9.5.0-beta.297 88 5/24/2025
9.5.0-beta.296 97 5/24/2025
9.5.0-beta.295 82 5/24/2025
9.4.1-beta.291 149 5/19/2025
9.4.1-beta.289 165 5/16/2025
9.4.1-beta.288 224 5/16/2025
9.4.1-beta.287 210 5/16/2025
9.4.1-beta.286 219 5/16/2025
9.4.1-beta.285 209 5/14/2025
9.4.1-beta.284 227 5/13/2025
9.4.1-beta.283 222 5/12/2025
9.4.1-beta.282 136 5/7/2025
9.4.1-beta.280 149 5/2/2025
9.4.1-beta.279 133 5/2/2025
9.4.1-beta.277 143 4/23/2025
9.4.1-beta.276 160 4/23/2025
9.4.1-beta.275 159 4/23/2025
9.4.1-beta.274 169 4/23/2025
9.4.1-beta.273 151 4/23/2025
9.4.1-beta.272 161 4/23/2025
9.4.1-beta.271 156 4/23/2025
9.4.1-beta.270 164 4/20/2025
9.4.0 4,412 4/20/2025
9.4.0-beta.269 160 4/20/2025
9.4.0-beta.268 157 4/20/2025
9.3.1-beta.267 163 4/20/2025
9.3.1-beta.266 91 4/19/2025
9.3.1-beta.265 290 4/15/2025
9.3.1-beta.264 170 4/15/2025
9.3.1-beta.263 188 4/15/2025
9.3.1-beta.262 201 4/15/2025
9.3.1-beta.260 159 4/10/2025
9.3.1-beta.259 1,697 4/8/2025
9.3.1-beta.258 158 4/8/2025
9.3.1-beta.257 148 4/8/2025
9.3.1-beta.256 166 4/8/2025
9.3.1-beta.255 147 4/8/2025
9.3.1-beta.254 167 4/8/2025
9.3.1-beta.253 168 4/1/2025
9.3.1-beta.252 406 3/27/2025
9.3.1-beta.250 123 3/27/2025
9.3.1-beta.249 122 3/27/2025
9.3.1-beta.248 122 3/27/2025
9.3.1-beta.247 137 3/27/2025
9.3.1-beta.244 490 3/25/2025
9.3.1-beta.242 474 3/24/2025
9.3.1-beta.241 165 3/19/2025
9.3.0 7,706 3/19/2025
9.3.0-beta.239 136 3/19/2025
9.2.2-beta.237 150 3/19/2025
9.2.2-beta.236 116 3/14/2025
9.2.2-beta.230 168 3/13/2025
9.2.2-beta.229 154 3/13/2025
9.2.2-beta.228 169 3/11/2025
9.2.2-beta.227 158 3/11/2025
9.2.2-beta.226 152 3/11/2025
9.2.2-beta.225 157 3/11/2025
9.2.2-beta.224 144 3/11/2025
9.2.2-beta.223 174 3/10/2025
9.2.2-beta.222 173 3/10/2025
9.2.2-beta.220 159 3/9/2025
9.2.2-beta.218 150 3/9/2025
9.2.2-beta.217 215 3/7/2025
9.2.2-beta.216 191 3/7/2025
9.2.2-beta.215 191 3/7/2025
9.2.2-beta.214 204 3/5/2025
9.2.2-beta.213 196 3/5/2025
9.2.2-beta.212 182 3/5/2025
9.2.2-beta.211 200 3/4/2025
9.2.2-beta.210 205 3/4/2025
9.2.2-beta.208 87 3/3/2025
9.2.1 1,637 3/3/2025
9.2.1-beta.207 143 3/2/2025
9.2.1-beta.206 93 3/1/2025
9.2.1-beta.205 84 2/27/2025
9.2.1-beta.204 99 2/26/2025
9.2.1-beta.203 88 2/26/2025
9.2.0 873 2/26/2025
9.2.0-beta.202 96 2/26/2025
9.2.0-beta.201 114 2/26/2025
9.2.0-beta.199 90 2/26/2025
9.2.0-beta.198 81 2/26/2025
9.1.1-beta.197 114 2/25/2025
9.1.1-beta.196 93 2/25/2025
9.1.1-beta.195 103 2/25/2025
9.1.1-beta.194 80 2/25/2025
9.1.1-beta.193 90 2/25/2025
9.1.1-beta.192 94 2/24/2025
9.1.1-beta.191 109 2/24/2025
9.1.1-beta.190 99 2/19/2025
9.1.1-beta.189 98 2/19/2025
9.1.1-beta.188 95 2/19/2025
9.1.1-beta.187 106 2/19/2025
9.1.1-beta.183 112 2/18/2025
9.1.1-beta.182 86 2/18/2025
9.1.1-beta.181 117 2/18/2025
9.1.1-beta.180 102 2/17/2025
9.1.1-beta.178 101 2/17/2025
9.1.1-beta.177 115 2/12/2025
9.1.1-beta.176 118 2/11/2025
9.1.1-beta.175 112 2/11/2025
9.1.1-beta.173 100 2/10/2025
9.1.1-beta.169 99 2/6/2025
9.1.1-beta.168 96 2/5/2025
9.1.1-beta.166 163 2/5/2025
9.1.1-beta.165 90 2/5/2025
9.1.1-beta.164 102 2/3/2025
9.1.1-beta.162 79 2/3/2025
9.1.1-beta.155 110 1/30/2025
9.1.1-beta.154 107 1/30/2025
9.1.1-beta.153 74 1/30/2025
9.1.1-beta.152 93 1/29/2025
9.1.1-beta.150 102 1/29/2025
9.1.1-beta.148 104 1/26/2025
9.1.1-beta.147 94 1/26/2025
9.1.1-beta.146 91 1/23/2025
9.1.1-beta.145 72 1/22/2025
9.1.1-beta.144 93 1/22/2025
9.1.1-beta.142 93 1/22/2025
9.1.1-beta.140 93 1/22/2025
9.1.1-beta.139 99 1/21/2025
9.1.1-beta.138 87 1/20/2025
9.1.1-beta.137 75 1/17/2025
9.1.1-beta.136 91 1/15/2025
9.1.1-beta.135 50 1/15/2025
9.1.1-beta.134 55 1/15/2025
9.1.1-beta.128 78 1/9/2025
9.1.1-beta.127 63 1/9/2025
9.1.1-beta.126 83 1/9/2025
9.1.1-beta.125 96 1/9/2025
9.1.1-beta.124 76 1/9/2025
9.1.0 2,851 12/12/2024
9.1.0-beta.123 103 1/3/2025
9.1.0-beta.122 113 1/3/2025
9.1.0-beta.121 81 1/2/2025
9.1.0-beta.120 92 12/30/2024
9.1.0-beta.119 77 12/30/2024
9.1.0-beta.118 93 12/30/2024
9.1.0-beta.116 99 12/30/2024
9.1.0-beta.114 82 12/30/2024
9.1.0-beta.113 91 12/30/2024
9.1.0-beta.112 91 12/18/2024
9.1.0-beta.110 101 12/16/2024
9.1.0-beta.109 95 12/12/2024
9.0.1-beta.108 113 12/12/2024
9.0.1-beta.107 82 12/11/2024
9.0.1-beta.106 95 12/12/2024
9.0.1-beta.104 97 12/11/2024
9.0.1-beta.102 84 12/6/2024
9.0.1-beta.99 102 12/6/2024
9.0.1-beta.98 90 12/6/2024
9.0.1-beta.95 82 12/5/2024
9.0.1-beta.94 78 12/5/2024
9.0.1-beta.93 74 12/2/2024
9.0.1-beta.92 182 11/30/2024
9.0.1-beta.91 94 11/30/2024
9.0.1-beta.90 94 11/29/2024
9.0.1-beta.89 106 11/29/2024
9.0.1-beta.88 97 11/27/2024
9.0.1-beta.87 94 11/27/2024
9.0.1-beta.86 101 11/27/2024
9.0.1-beta.84 108 11/24/2024
9.0.1-beta.83 99 11/22/2024
9.0.1-beta.82 99 11/21/2024
9.0.1-beta.81 91 11/19/2024
9.0.1-beta.80 84 11/19/2024
9.0.1-beta.79 107 11/19/2024
9.0.1-beta.77 96 11/15/2024
9.0.0 730 11/15/2024
9.0.0-beta.76 89 11/14/2024
9.0.0-beta.75 102 11/14/2024
9.0.0-beta.74 92 11/14/2024
9.0.0-beta.73 209 11/14/2024
9.0.0-beta.72 72 11/14/2024
9.0.0-beta.71 84 11/13/2024
9.0.0-beta.70 149 11/13/2024
9.0.0-beta.69 101 11/13/2024
9.0.0-beta.68 94 11/13/2024
9.0.0-beta.67 79 11/13/2024
9.0.0-beta.66 145 11/13/2024
9.0.0-beta.63 104 11/12/2024