CommunityToolkit.Aspire.Hosting.SqlDatabaseProjects 9.6.0-beta.324

Prefix Reserved
This is a prerelease version of CommunityToolkit.Aspire.Hosting.SqlDatabaseProjects.
There is a newer version of this package available.
See the version list below for details.
dotnet add package CommunityToolkit.Aspire.Hosting.SqlDatabaseProjects --version 9.6.0-beta.324
                    
NuGet\Install-Package CommunityToolkit.Aspire.Hosting.SqlDatabaseProjects -Version 9.6.0-beta.324
                    
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.6.0-beta.324" />
                    
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.6.0-beta.324" />
                    
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.6.0-beta.324
                    
#r "nuget: CommunityToolkit.Aspire.Hosting.SqlDatabaseProjects, 9.6.0-beta.324"
                    
#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.6.0-beta.324
                    
#: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.6.0-beta.324&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=CommunityToolkit.Aspire.Hosting.SqlDatabaseProjects&version=9.6.0-beta.324&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.6.0 260 7/10/2025
9.6.0-beta.324 105 7/10/2025
9.5.1-beta.323 104 7/10/2025
9.5.1-beta.322 109 7/10/2025
9.5.1-beta.321 110 7/10/2025
9.5.1-beta.320 109 7/9/2025
9.5.1-beta.319 111 7/8/2025
9.5.1-beta.318 113 7/2/2025
9.5.1-beta.317 105 6/30/2025
9.5.1-beta.315 111 6/26/2025
9.5.1-beta.314 113 6/23/2025
9.5.1-beta.313 103 6/20/2025
9.5.1-beta.312 104 6/20/2025
9.5.1-beta.311 113 6/18/2025
9.5.1-beta.310 113 6/17/2025
9.5.1-beta.309 107 6/17/2025
9.5.1-beta.308 116 6/17/2025
9.5.1-beta.307 116 6/16/2025
9.5.1-beta.306 264 6/11/2025
9.5.1-beta.305 97 6/7/2025
9.5.1-beta.304 102 6/6/2025
9.5.1-beta.303 133 6/4/2025
9.5.1-beta.302 118 6/4/2025
9.5.1-beta.301 121 6/2/2025
9.5.1-beta.300 125 5/28/2025
9.5.0 2,737 5/27/2025
9.5.0-beta.299 119 5/27/2025
9.5.0-beta.298 131 5/26/2025
9.5.0-beta.297 75 5/24/2025
9.5.0-beta.296 71 5/24/2025
9.5.0-beta.295 51 5/24/2025
9.4.1-beta.291 121 5/19/2025
9.4.1-beta.289 138 5/16/2025
9.4.1-beta.288 185 5/16/2025
9.4.1-beta.287 184 5/16/2025
9.4.1-beta.286 192 5/16/2025
9.4.1-beta.285 197 5/14/2025
9.4.1-beta.284 203 5/13/2025
9.4.1-beta.283 206 5/12/2025
9.4.1-beta.282 123 5/7/2025
9.4.1-beta.280 128 5/2/2025
9.4.1-beta.279 121 5/2/2025
9.4.1-beta.277 131 4/23/2025
9.4.1-beta.276 134 4/23/2025
9.4.1-beta.275 138 4/23/2025
9.4.1-beta.274 136 4/23/2025
9.4.1-beta.273 129 4/23/2025
9.4.1-beta.272 136 4/23/2025
9.4.1-beta.271 130 4/23/2025
9.4.1-beta.270 138 4/20/2025
9.4.0 3,213 4/20/2025
9.4.0-beta.269 135 4/20/2025
9.4.0-beta.268 128 4/20/2025
9.3.1-beta.267 134 4/20/2025
9.3.1-beta.266 64 4/19/2025
9.3.1-beta.265 268 4/15/2025
9.3.1-beta.264 159 4/15/2025
9.3.1-beta.263 165 4/15/2025
9.3.1-beta.262 168 4/15/2025
9.3.1-beta.260 144 4/10/2025
9.3.1-beta.259 1,086 4/8/2025
9.3.1-beta.258 140 4/8/2025
9.3.1-beta.257 134 4/8/2025
9.3.1-beta.256 139 4/8/2025
9.3.1-beta.255 132 4/8/2025
9.3.1-beta.254 137 4/8/2025
9.3.1-beta.253 145 4/1/2025
9.3.1-beta.252 381 3/27/2025
9.3.1-beta.250 109 3/27/2025
9.3.1-beta.249 108 3/27/2025
9.3.1-beta.248 110 3/27/2025
9.3.1-beta.247 116 3/27/2025
9.3.1-beta.244 460 3/25/2025
9.3.1-beta.242 453 3/24/2025
9.3.1-beta.241 134 3/19/2025
9.3.0 4,983 3/19/2025
9.3.0-beta.239 121 3/19/2025
9.2.2-beta.237 131 3/19/2025
9.2.2-beta.236 100 3/14/2025
9.2.2-beta.230 137 3/13/2025
9.2.2-beta.229 129 3/13/2025
9.2.2-beta.228 147 3/11/2025
9.2.2-beta.227 132 3/11/2025
9.2.2-beta.226 139 3/11/2025
9.2.2-beta.225 129 3/11/2025
9.2.2-beta.224 131 3/11/2025
9.2.2-beta.223 145 3/10/2025
9.2.2-beta.222 146 3/10/2025
9.2.2-beta.220 139 3/9/2025
9.2.2-beta.218 137 3/9/2025
9.2.2-beta.217 183 3/7/2025
9.2.2-beta.216 177 3/7/2025
9.2.2-beta.215 177 3/7/2025
9.2.2-beta.214 176 3/5/2025
9.2.2-beta.213 172 3/5/2025
9.2.2-beta.212 170 3/5/2025
9.2.2-beta.211 179 3/4/2025
9.2.2-beta.210 176 3/4/2025
9.2.2-beta.208 75 3/3/2025
9.2.1 1,424 3/3/2025
9.2.1-beta.207 111 3/2/2025
9.2.1-beta.206 69 3/1/2025
9.2.1-beta.205 70 2/27/2025
9.2.1-beta.204 74 2/26/2025
9.2.1-beta.203 67 2/26/2025
9.2.0 839 2/26/2025
9.2.0-beta.202 70 2/26/2025
9.2.0-beta.201 86 2/26/2025
9.2.0-beta.199 67 2/26/2025
9.2.0-beta.198 60 2/26/2025
9.1.1-beta.197 84 2/25/2025
9.1.1-beta.196 69 2/25/2025
9.1.1-beta.195 74 2/25/2025
9.1.1-beta.194 68 2/25/2025
9.1.1-beta.193 67 2/25/2025
9.1.1-beta.192 73 2/24/2025
9.1.1-beta.191 84 2/24/2025
9.1.1-beta.190 75 2/19/2025
9.1.1-beta.189 77 2/19/2025
9.1.1-beta.188 72 2/19/2025
9.1.1-beta.187 80 2/19/2025
9.1.1-beta.183 87 2/18/2025
9.1.1-beta.182 75 2/18/2025
9.1.1-beta.181 93 2/18/2025
9.1.1-beta.180 77 2/17/2025
9.1.1-beta.178 74 2/17/2025
9.1.1-beta.177 89 2/12/2025
9.1.1-beta.176 93 2/11/2025
9.1.1-beta.175 81 2/11/2025
9.1.1-beta.173 80 2/10/2025
9.1.1-beta.169 77 2/6/2025
9.1.1-beta.168 67 2/5/2025
9.1.1-beta.166 135 2/5/2025
9.1.1-beta.165 63 2/5/2025
9.1.1-beta.164 74 2/3/2025
9.1.1-beta.162 66 2/3/2025
9.1.1-beta.155 69 1/30/2025
9.1.1-beta.154 80 1/30/2025
9.1.1-beta.153 62 1/30/2025
9.1.1-beta.152 63 1/29/2025
9.1.1-beta.150 77 1/29/2025
9.1.1-beta.148 78 1/26/2025
9.1.1-beta.147 67 1/26/2025
9.1.1-beta.146 68 1/23/2025
9.1.1-beta.145 60 1/22/2025
9.1.1-beta.144 65 1/22/2025
9.1.1-beta.142 69 1/22/2025
9.1.1-beta.140 62 1/22/2025
9.1.1-beta.139 73 1/21/2025
9.1.1-beta.138 58 1/20/2025
9.1.1-beta.137 61 1/17/2025
9.1.1-beta.136 64 1/15/2025
9.1.1-beta.135 35 1/15/2025
9.1.1-beta.134 36 1/15/2025
9.1.1-beta.128 56 1/9/2025
9.1.1-beta.127 48 1/9/2025
9.1.1-beta.126 62 1/9/2025
9.1.1-beta.125 75 1/9/2025
9.1.1-beta.124 62 1/9/2025
9.1.0 2,793 12/12/2024
9.1.0-beta.123 77 1/3/2025
9.1.0-beta.122 86 1/3/2025
9.1.0-beta.121 69 1/2/2025
9.1.0-beta.120 71 12/30/2024
9.1.0-beta.119 65 12/30/2024
9.1.0-beta.118 70 12/30/2024
9.1.0-beta.116 74 12/30/2024
9.1.0-beta.114 68 12/30/2024
9.1.0-beta.113 67 12/30/2024
9.1.0-beta.112 67 12/18/2024
9.1.0-beta.110 77 12/16/2024
9.1.0-beta.109 70 12/12/2024
9.0.1-beta.108 84 12/12/2024
9.0.1-beta.107 71 12/11/2024
9.0.1-beta.106 72 12/12/2024
9.0.1-beta.104 71 12/11/2024
9.0.1-beta.102 68 12/6/2024
9.0.1-beta.99 75 12/6/2024
9.0.1-beta.98 66 12/6/2024
9.0.1-beta.95 71 12/5/2024
9.0.1-beta.94 67 12/5/2024
9.0.1-beta.93 64 12/2/2024
9.0.1-beta.92 166 11/30/2024
9.0.1-beta.91 71 11/30/2024
9.0.1-beta.90 72 11/29/2024
9.0.1-beta.89 77 11/29/2024
9.0.1-beta.88 71 11/27/2024
9.0.1-beta.87 68 11/27/2024
9.0.1-beta.86 72 11/27/2024
9.0.1-beta.84 81 11/24/2024
9.0.1-beta.83 73 11/22/2024
9.0.1-beta.82 76 11/21/2024
9.0.1-beta.81 67 11/19/2024
9.0.1-beta.80 61 11/19/2024
9.0.1-beta.79 71 11/19/2024
9.0.1-beta.77 70 11/15/2024
9.0.0 676 11/15/2024
9.0.0-beta.76 71 11/14/2024
9.0.0-beta.75 74 11/14/2024
9.0.0-beta.74 70 11/14/2024
9.0.0-beta.73 194 11/14/2024
9.0.0-beta.72 61 11/14/2024
9.0.0-beta.71 69 11/13/2024
9.0.0-beta.70 126 11/13/2024
9.0.0-beta.69 76 11/13/2024
9.0.0-beta.68 76 11/13/2024
9.0.0-beta.67 63 11/13/2024
9.0.0-beta.66 110 11/13/2024
9.0.0-beta.63 78 11/12/2024