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
Copy file name to clipboardExpand all lines: articles/azure-functions/durable/quickstart-mssql.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -14,7 +14,7 @@ Durable Functions supports several [storage providers](durable-functions-storage
14
14
15
15
> [!NOTE]
16
16
>
17
-
> - The MSSQL back end was designed to maximize application portability and control over your data. It uses [Microsoft SQL Server](https://www.microsoft.com/sql-server/) to persist all task hub data state so that users get the benefits of a modern, enterprise-grade database management system (DBMS) infrastructure. To learn more about when to use the MSSQL storage provider, see the [storage providers overview](durable-functions-storage-providers.md).
17
+
> - The MSSQL back end was designed to maximize application portability and control over your data. It uses [Microsoft SQL Server](https://www.microsoft.com/sql-server/) to persist all task hub data so that users get the benefits of a modern, enterprise-grade database management system (DBMS) infrastructure. To learn more about when to use the MSSQL storage provider, see the [storage providers overview](durable-functions-storage-providers.md).
18
18
>
19
19
> - Migrating [task hub data](durable-functions-task-hubs.md) across storage providers currently isn't supported. Function apps that have existing runtime data start with a fresh, empty task hub after they switch to the MSSQL back end. Similarly, the task hub contents that are created by using MSSQL can't be preserved if you switch to a different storage provider.
20
20
@@ -36,7 +36,7 @@ If you don't meet these prerequisites, we recommend that you begin with one of t
36
36
-[Create your first durable function - PowerShell](quickstart-powershell-vscode.md)
37
37
-[Create your first durable function - Java](quickstart-java.md)
38
38
39
-
## Add the durable task MSSQL extension (.NET only)
39
+
## Add the Durable Task MSSQL extension (.NET only)
40
40
41
41
> [!NOTE]
42
42
> If your app uses [Extension Bundles](../functions-bindings-register.md#extension-bundles), skip this section. Extension Bundles removes the need for manual extension management.
# Quickstart: Create a TypeScript durable function
13
+
# Quickstart: Create a TypeScript Durable Functions app
14
14
15
-
Durable Functions is a feature of [Azure Functions](../functions-overview.md) that you can use to write stateful functions in a serverless environment. You install Durable Functions by installing the [Azure Functions extension](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-azurefunctions) in Visual Studio Code. The extension manages state, checkpoints, and restarts for you.
15
+
Durable Functions is a feature of [Azure Functions](../functions-overview.md) that you can use to write stateful functions in a serverless environment. You install Durable Functions by installing the [Azure Functions extension](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-azurefunctions) in Visual Studio Code. The extension manages state, checkpoints, and restarts for your application.
16
16
17
-
In this quickstart, you use the Durable Functions extension in Visual Studio Code to locally create and test a "hello world" durable function in Azure Functions. The durable function orchestrates and chains together calls to other functions. Then, you publish the function code to Azure. The tools you use are available via the Visual Studio Code extension.
17
+
In this quickstart, you use the Durable Functions extension in Visual Studio Code to locally create and test a "hello world" Durable Functions app in Azure Functions. The Durable Functions app orchestrates and chains together calls to other functions. Then, you publish the function code to Azure. The tools you use are available via the Visual Studio Code extension.

21
+

22
22
23
23
## Prerequisites
24
24
@@ -74,7 +74,7 @@ In this section, you use Visual Studio Code to create a local Azure Functions pr
74
74
75
75
1. In Visual Studio Code, select F1 (or select Ctrl/Cmd+Shift+P) to open the command palette. At the prompt (`>`), enter and then select **Azure Functions: Create New Project**.
76
76
77
-

77
+
:::image type="content" source="media/quickstart-js-vscode/functions-create-project.png" alt-text="Screenshot that shows the Visual Studio Code command palette, with Azure Functions Create New Project highlighted.":::
78
78
79
79
2. Select **Browse**. In the **Select Folder** dialog, go to a folder to use for your project, and then choose **Select**.
80
80
@@ -136,7 +136,7 @@ To use the v4 programming model, you need to install the preview v3.x version of
136
136
137
137
## Create your functions
138
138
139
-
The most basic durable function app has three functions:
139
+
The most basic Durable Functions app has three functions:
140
140
141
141
***Orchestrator function**: A workflow that orchestrates other functions.
142
142
***Activity function**: A function that is called by the orchestrator function, performs work, and optionally returns a value.
@@ -146,17 +146,17 @@ The most basic durable function app has three functions:
146
146
147
147
### Orchestrator function
148
148
149
-
You use a template to create the durable function code in your project.
149
+
You use a template to create the Durable Functions code in your project.
150
150
151
151
1. In the command palette, enter and then select **Azure Functions: Create Function**.
152
152
153
153
2. At the prompts, provide the following information:
154
154
155
155
| Prompt | Action | Description |
156
156
| ------ | ----- | ----------- |
157
-
|**Select a template for your function**| Select **Durable Functions orchestrator**. | Creates a durable functions orchestration. |
158
-
|**Choose a durable storage type**| Select **Azure Storage (Default)**. | Sets the storage back end to use for your durable function. |
159
-
|**Provide a function name**| Enter **HelloOrchestrator**. | The name of your durable function. |
157
+
|**Select a template for your function**| Select **Durable Functions orchestrator**. | Creates a Durable Functions orchestration. |
158
+
|**Choose a durable storage type**| Select **Azure Storage (Default)**. | Sets the storage back end to use for your Durable Functions app. |
159
+
|**Provide a function name**| Enter **HelloOrchestrator**. | The name of your function. |
160
160
161
161
You added an orchestrator to coordinate activity functions. Open *HelloOrchestrator/index.ts* to see the orchestrator function. Each call to `context.df.callActivity` invokes an activity function named `Hello`.
162
162
@@ -170,8 +170,8 @@ Next, you add the referenced `Hello` activity function.
170
170
171
171
| Prompt | Action | Description |
172
172
| ------ | ----- | ----------- |
173
-
| Select a template for your function | Durable Functions activity |Create an activity function |
174
-
| Provide a function name | Hello |Name of your activity function |
173
+
|**Select a template for your function**|Select **Durable Functions activity**.|Creates an activity function.|
174
+
|**Provide a function name**|Enter **Hello**.|A name for your activity function.|
175
175
176
176
You added the `Hello` activity function that is invoked by the orchestrator. Open *Hello/index.ts* to see that it's taking a name as input and returning a greeting. An activity function is where you perform "the real work" in your workflow, such as making a database call or performing some nondeterministic computation.
177
177
@@ -205,9 +205,9 @@ One of the benefits of the v4 programming model is the flexibility of where you
205
205
206
206
| Prompt | Action | Description |
207
207
| ------ | ----- | ----------- |
208
-
|**Select a template for your function**| Select **Durable Functions orchestrator**. | Creates a file with a durable function orchestration, an activity function, and a durable client starter function. |
208
+
|**Select a template for your function**| Select **Durable Functions orchestrator**. | Creates a file that has a Durable Functions orchestration, an activity function, and a durable client starter function. |
209
209
|**Choose a durable storage type**| Select **Azure Storage (Default)**. | Sets the storage back end to use for your durable function. |
210
-
|**Provide a function name**| Enter **hello**. |The name for your durable function. |
210
+
|**Provide a function name**| Enter **Hello**. |A name for your durable function. |
211
211
212
212
Open *src/functions/hello.ts* to view the functions you created.
213
213
@@ -217,7 +217,7 @@ You also added the `hello` activity function that is invoked by the orchestrator
217
217
218
218
Finally, you added an HTTP-triggered function that starts an orchestration. In the same file, you can see that it uses `client.startNew` to start a new orchestration. Then it uses `client.createCheckStatusResponse` to return an HTTP response containing URLs that can be used to monitor and manage the new orchestration.
219
219
220
-
You now have a durable function app that you can run locally and deploy to Azure.
220
+
You now have a Durable Functions app that you can run locally and deploy to Azure.
221
221
222
222
::: zone-end
223
223
@@ -259,7 +259,7 @@ Azure Functions Core Tools gives you the capability to run an Azure Functions pr
259
259
260
260
4. In the terminal panel, copy the URL endpoint of your HTTP-triggered function.
261
261
262
-

262
+
:::image type="content" source="media/quickstart-js-vscode/functions-f5.png" alt-text="Screenshot that shows the Visual Studio Code terminal panel. The URL of the HTTP starter function is highlighted." lightbox="media/quickstart-js-vscode/functions-f5.png":::
263
263
264
264
::: zone pivot="nodejs-model-v3"
265
265
@@ -306,7 +306,7 @@ Azure Functions Core Tools gives you the capability to run an Azure Functions pr
306
306
307
307
6. Copy the URL value for `statusQueryGetUri`, paste it in your browser's address bar, and execute the request. Alternatively, you can also continue to use Postman to issue the GET request.
308
308
309
-
The request queries the orchestration instance for the status. You should see that the instance finished and that it includes the outputs or results of the durable function. It looks similar to this example:
309
+
The request queries the orchestration instance for the status. You should see that the instance finished and that it includes the outputs or results of the Durable Functions app. It looks similar to this example:
310
310
311
311
```json
312
312
{
@@ -362,12 +362,12 @@ After you verify that the function runs correctly on your local computer, it's t
362
362
363
363
2. Paste the new URL for the HTTP request in your browser's address bar. When you use the published app, you can expect to get the same status response that you got when you tested locally.
364
364
365
-
The TypeScript durable function app that you created and published by using Visual Studio Code is ready to use.
365
+
The TypeScript Durable Functions app that you created and published by using Visual Studio Code is ready to use.
366
366
367
367
## Clean up resources
368
368
369
369
If you no longer need the resources that you created to complete the quickstart, to avoid related costs in your Azure subscription, [delete the resource group](/azure/azure-resource-manager/management/delete-resource-group?tabs=azure-portal#delete-resource-group) and all related resources.
370
370
371
371
## Related content
372
372
373
-
* Learn about [common durable function patterns](durable-functions-overview.md#application-patterns).
373
+
* Learn about [common Durable Functions app patterns](durable-functions-overview.md#application-patterns).
0 commit comments