Skip to content

Corrected info for Azure SQL SKU #3508

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
May 27, 2025
Merged
Changes from 2 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 7 additions & 5 deletions docs/whats-new/dotnet-aspire-9.3.md
Original file line number Diff line number Diff line change
Expand Up @@ -813,11 +813,11 @@ If your deployment relied on Aspire setting the managed identity as the SQL Serv

📖 Related: [dotnet/aspire#8381](https://github.com/dotnet/aspire/issues/8381) and [dotnet/aspire#8389](https://github.com/dotnet/aspire/issues/8389)

### 💸 Default Azure SQL SKU is now Free (Breaking change)
### 💸 Default Azure SQL SKU now uses the Free Offer (Breaking change)

.NET Aspire 9.3 changes the default SKU used when provisioning **Azure SQL databases** to the **Free (Basic)** tier. This helps reduce unexpected costs during development and experimentation.
.NET Aspire 9.3 changes the default SKU used when provisioning **Azure SQL databases** to the **GP_S_Gen5_2** (General Purpose Serverless) tier with the [**Free Offer**](https://learn.microsoft.com/azure/azure-sql/database/free-offer?view=azuresql). This helps reduce unexpected costs during development and experimentation.

Previously, Aspire defaulted to the **General Purpose (GP)** tier, which could incur charges even for small or test apps.
Previously, Aspire defaulted to the **General Purpose (GP)** tier *without* the Free Offer, which could incur charges even for small or test apps.

#### What's new

Expand All @@ -829,17 +829,19 @@ var sql = builder.AddAzureSqlServer("sqlserver");
sql.AddDatabase("appdb");
```

Aspire now automatically uses the **free-tier SKU** for `appdb`, unless you override it.
Aspire now automatically uses the **Free Offer** for `appdb`, which will deploy a **GP_S_Gen5_2** (General Purpose Serverless), unless you override it.

#### How to restore the previous behavior

If your app requires the performance or features of a paid tier, you can opt out of the new default using:
If your app requires the performance or features of the General Purpose paid tier, you can opt out of the new default using:

```csharp
sql.AddDatabase("appdb")
.WithDefaultAzureSku(); // Uses the previous (General Purpose) default
```

If you want to specify what SKU to use, you the `ConfigureInfrastructure` method as explained here: [Setting a specific SKU](https://github.com/dotnet/aspire/tree/main/src/Aspire.Hosting.Azure.Sql#setting-a-specific-sku).

#### ⚠️ Breaking change

This change affects cost, performance, and available features in new deployments. If your app depends on higher-tier capabilities, be sure to configure the SKU accordingly.
Expand Down
Loading