Skip to content

Commit 020edb0

Browse files
Merge pull request #228918 from davidmrdavid/dajusto/update-df-backends-for-csharp-isolated
Mention DF backend packages for C#-isolated in storage provider docs
2 parents b7ae3bf + 3d4456b commit 020edb0

File tree

1 file changed

+28
-2
lines changed

1 file changed

+28
-2
lines changed

articles/azure-functions/durable/durable-functions-storage-providers.md

Lines changed: 28 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -109,7 +109,9 @@ Additional properties may be set to customize the connection. See [Common proper
109109

110110
### Configuring the Netherite storage provider
111111

112-
To use the Netherite storage provider, you must first add a reference to the [Microsoft.Azure.DurableTask.Netherite.AzureFunctions](https://www.nuget.org/packages/Microsoft.Azure.DurableTask.Netherite.AzureFunctions) NuGet package in your **csproj** file (.NET apps) or your **extensions.proj** file (JavaScript, Python, and PowerShell apps).
112+
Enabling the Netherite storage provider requires a configuration change in your `host.json`. For C# users, it also requires an additional installation step.
113+
114+
#### `host.json` Configuration
113115

114116
The following host.json example shows the minimum configuration required to enable the Netherite storage provider.
115117

@@ -130,9 +132,22 @@ The following host.json example shows the minimum configuration required to enab
130132

131133
For more detailed setup instructions, see the [Netherite getting started documentation](https://microsoft.github.io/durabletask-netherite/#/?id=getting-started).
132134

135+
#### Install the Netherite extension (.NET only)
136+
137+
> [!NOTE]
138+
> If your app uses [Extension Bundles](../functions-bindings-register.md#extension-bundles), you should ignore this section as Extension Bundles removes the need for manual Extension management.
139+
140+
You'll need to install the latest version of the Netherite Extension on NuGet. This usually means including a reference to it in your `.csproj` file and building the project.
141+
142+
The Extension package to install depends on the .NET worker you are using:
143+
- For the _in-process_ .NET worker, install [`Microsoft.Azure.DurableTask.Netherite.AzureFunctions`](https://www.nuget.org/packages/Microsoft.Azure.DurableTask.Netherite.AzureFunctions).
144+
- For the _isolated_ .NET worker, install [`Microsoft.Azure.Functions.Worker.Extensions.DurableTask.Netherite`](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.Extensions.DurableTask.Netherite).
145+
133146
### Configuring the MSSQL storage provider
134147

135-
To use the MSSQL storage provider, you must first add a reference to the [Microsoft.DurableTask.SqlServer.AzureFunctions](https://www.nuget.org/packages/Microsoft.DurableTask.SqlServer.AzureFunctions) NuGet package in your **csproj** file (.NET apps) or your **extensions.proj** file (JavaScript, Python, and PowerShell apps).
148+
Enabling the MSSQL storage provider requires a configuration change in your `host.json`. For C# users, it also requires an additional installation step.
149+
150+
#### `host.json` Configuration
136151

137152
The following example shows the minimum configuration required to enable the MSSQL storage provider.
138153

@@ -152,6 +167,17 @@ The following example shows the minimum configuration required to enable the MSS
152167

153168
For more detailed setup instructions, see the [MSSQL provider's getting started documentation](https://microsoft.github.io/durabletask-mssql/#/quickstart).
154169

170+
#### Install the Durable Task MSSQL extension (.NET only)
171+
172+
> [!NOTE]
173+
> If your app uses [Extension Bundles](../functions-bindings-register.md#extension-bundles), you should ignore this section as Extension Bundles removes the need for manual Extension management.
174+
175+
You'll need to install the latest version of the MSSQL storage provider Extension on NuGet. This usually means including a reference to it in your `.csproj` file and building the project.
176+
177+
The Extension package to install depends on the .NET worker you are using:
178+
- For the _in-process_ .NET worker, install [`Microsoft.DurableTask.SqlServer.AzureFunctions`](https://www.nuget.org/packages/Microsoft.DurableTask.SqlServer.AzureFunctions).
179+
- For the _isolated_ .NET worker, install [`Microsoft.Azure.Functions.Worker.Extensions.DurableTask.SqlServer`](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.Extensions.DurableTask.SqlServer).
180+
155181
## Comparing storage providers
156182

157183
There are many significant tradeoffs between the various supported storage providers. The following table can be used to help you understand these tradeoffs and decide which storage provider is best for your needs.

0 commit comments

Comments
 (0)