Merge pull request #224302 from dzsquared/sqlbindings-oopcsharp

adding out of process docs for sqlbindings

Author: prmerger-automator[bot]

articles/azure-functions/functions-bindings-azure-sql-input.md

@@ -21,10 +21,12 @@ For information on setup and configuration details, see the [overview](./functio
 
 ::: zone pivot="programming-language-csharp"
 
-More samples for the Azure SQL input binding are available in the [GitHub repository](https://github.com/Azure/azure-functions-sql-extension/tree/main/samples/samples-csharp).
+[!INCLUDE [functions-bindings-csharp-intro](../../includes/functions-bindings-csharp-intro.md)]
 
 # [In-process](#tab/in-process)
 
+More samples for the Azure SQL input binding are available in the [GitHub repository](https://github.com/Azure/azure-functions-sql-extension/tree/main/samples/samples-csharp).
+
 This section contains the following examples:
 
 * [HTTP trigger, get row by ID from query string](#http-trigger-look-up-id-from-query-string-c)
@@ -119,7 +121,121 @@ The stored procedure `dbo.DeleteToDo` must be created on the SQL database.  In t
 
 # [Isolated process](#tab/isolated-process)
 
-Isolated worker process isn't currently supported.
+More samples for the Azure SQL input binding are available in the [GitHub repository](https://github.com/Azure/azure-functions-sql-extension/tree/main/samples/samples-outofproc).
+
+This section contains the following examples:
+
+* [HTTP trigger, get row by ID from query string](#http-trigger-look-up-id-from-query-string-c-oop)
+* [HTTP trigger, get multiple rows from route data](#http-trigger-get-multiple-items-from-route-data-c-oop)
+* [HTTP trigger, delete rows](#http-trigger-delete-one-or-multiple-rows-c-oop)
+
+The examples refer to a `ToDoItem` class and a corresponding database table:
+
+:::code language="csharp" source="~/functions-sql-todo-sample/ToDoModel.cs" range="6-16":::
+
+:::code language="sql" source="~/functions-sql-todo-sample/sql/create.sql" range="1-7":::
+
+<a id="http-trigger-look-up-id-from-query-string-c-oop"></a>
+### HTTP trigger, get row by ID from query string
+
+The following example shows a [C# function](functions-dotnet-class-library.md) that retrieves a single record. The function is triggered by an HTTP request that uses a query string to specify the ID. That ID is used to retrieve a `ToDoItem` record with the specified query.
+
+> [!NOTE]
+> The HTTP query string parameter is case-sensitive.
+>
+
+```cs
+using System.Collections.Generic;
+using System.Linq;
+using Microsoft.AspNetCore.Http;
+using Microsoft.AspNetCore.Mvc;
+using Microsoft.Azure.Functions.Worker;
+using Microsoft.Azure.Functions.Worker.Extensions.Sql;
+using Microsoft.Azure.Functions.Worker.Http;
+
+namespace AzureSQLSamples
+{
+    public static class GetToDoItem
+    {
+        [FunctionName("GetToDoItem")]
+        public static IActionResult Run(
+            [HttpTrigger(AuthorizationLevel.Anonymous, "get", Route = "gettodoitem")]
+            HttpRequest req,
+            [Sql("select [Id], [order], [title], [url], [completed] from dbo.ToDo where Id = @Id",
+                CommandType = System.Data.CommandType.Text,
+                Parameters = "@Id={Query.id}",
+                ConnectionStringSetting = "SqlConnectionString")]
+            IEnumerable<ToDoItem> toDoItem)
+        {
+            return new OkObjectResult(toDoItem.FirstOrDefault());
+        }
+    }
+}
+```
+
+<a id="http-trigger-get-multiple-items-from-route-data-c-oop"></a>
+### HTTP trigger, get multiple rows from route parameter
+
+The following example shows a [C# function](functions-dotnet-class-library.md) that retrieves documents returned by the query. The function is triggered by an HTTP request that uses route data to specify the value of a query parameter. That parameter is used to filter the `ToDoItem` records in the specified query.
+
+```cs
+using System.Collections.Generic;
+using Microsoft.AspNetCore.Http;
+using Microsoft.AspNetCore.Mvc;
+using Microsoft.Azure.Functions.Worker;
+using Microsoft.Azure.Functions.Worker.Extensions.Sql;
+using Microsoft.Azure.Functions.Worker.Http;
+
+namespace AzureSQLSamples
+{
+    public static class GetToDoItems
+    {
+        [FunctionName("GetToDoItems")]
+        public static IActionResult Run(
+            [HttpTrigger(AuthorizationLevel.Anonymous, "get", Route = "gettodoitems/{priority}")]
+            HttpRequest req,
+            [Sql("select [Id], [order], [title], [url], [completed] from dbo.ToDo where [Priority] > @Priority",
+                CommandType = System.Data.CommandType.Text,
+                Parameters = "@Priority={priority}",
+                ConnectionStringSetting = "SqlConnectionString")]
+            IEnumerable<ToDoItem> toDoItems)
+        {
+            return new OkObjectResult(toDoItems);
+        }
+    }
+}
+```
+
+<a id="http-trigger-delete-one-or-multiple-rows-c-oop"></a>
+### HTTP trigger, delete rows
+
+The following example shows a [C# function](functions-dotnet-class-library.md) that executes a stored procedure with input from the HTTP request query parameter.
+
+The stored procedure `dbo.DeleteToDo` must be created on the SQL database.  In this example, the stored procedure deletes a single record or all records depending on the value of the parameter.
+
+:::code language="sql" source="~/functions-sql-todo-sample/sql/create.sql" range="11-25":::
+
+```cs
+namespace AzureSQL.ToDo
+{
+    public static class DeleteToDo
+    {
+        // delete all items or a specific item from querystring
+        // returns remaining items
+        // uses input binding with a stored procedure DeleteToDo to delete items and return remaining items
+        [FunctionName("DeleteToDo")]
+        public static IActionResult Run(
+            [HttpTrigger(AuthorizationLevel.Anonymous, "delete", Route = "DeleteFunction")] HttpRequest req,
+            ILogger log,
+            [Sql("DeleteToDo", CommandType = System.Data.CommandType.StoredProcedure, 
+                Parameters = "@Id={Query.id}", ConnectionStringSetting = "SqlConnectionString")] 
+                IEnumerable<ToDoItem> toDoItems)
+        {
+            return new OkObjectResult(toDoItems);
+        }
+    }
+}
+```
 
 <!-- Uncomment to support C# script examples.
 # [C# Script](#tab/csharp-script)

articles/azure-functions/functions-bindings-azure-sql-output.md

@@ -21,10 +21,12 @@ For information on setup and configuration details, see the [overview](./functio
 
 ::: zone pivot="programming-language-csharp"
 
-More samples for the Azure SQL output binding are available in the [GitHub repository](https://github.com/Azure/azure-functions-sql-extension/tree/main/samples/samples-csharp).
+[!INCLUDE [functions-bindings-csharp-intro](../../includes/functions-bindings-csharp-intro.md)]
 
 # [In-process](#tab/in-process)
 
+More samples for the Azure SQL output binding are available in the [GitHub repository](https://github.com/Azure/azure-functions-sql-extension/tree/main/samples/samples-csharp).
+
 This section contains the following examples:
 
 * [HTTP trigger, write one record](#http-trigger-write-one-record-c)
@@ -154,7 +156,144 @@ namespace AzureSQLSamples
 
 # [Isolated process](#tab/isolated-process)
 
-Isolated worker process isn't currently supported.
+More samples for the Azure SQL output binding are available in the [GitHub repository](https://github.com/Azure/azure-functions-sql-extension/tree/main/samples/samples-outofproc).
+
+This section contains the following examples:
+
+* [HTTP trigger, write one record](#http-trigger-write-one-record-c-oop)
+* [HTTP trigger, write to two tables](#http-trigger-write-to-two-tables-c-oop)
+* [HTTP trigger, write records using IAsyncCollector](#http-trigger-write-records-using-iasynccollector-c-oop)
+
+The examples refer to a `ToDoItem` class and a corresponding database table:
+
+:::code language="csharp" source="~/functions-sql-todo-sample/ToDoModel.cs" range="6-16":::
+
+:::code language="sql" source="~/functions-sql-todo-sample/sql/create.sql" range="1-7":::
+
+
+<a id="http-trigger-write-one-record-c-oop"></a>
+
+### HTTP trigger, write one record
+
+The following example shows a [C# function](functions-dotnet-class-library.md) that adds a record to a database, using data provided in an HTTP POST request as a JSON body.
+
+:::code language="csharp" source="~/functions-sql-todo-sample/PostToDo.cs" range="4-49":::
+
+<a id="http-trigger-write-to-two-tables-c-oop"></a>
+
+### HTTP trigger, write to two tables
+
+The following example shows a [C# function](functions-dotnet-class-library.md) that adds records to a database in two different tables (`dbo.ToDo` and `dbo.RequestLog`), using data provided in an HTTP POST request as a JSON body and multiple output bindings.
+
+```sql
+CREATE TABLE dbo.RequestLog (
+    Id int identity(1,1) primary key,
+    RequestTimeStamp datetime2 not null,
+    ItemCount int not null
+)
+```
+
+
+```cs
+using System;
+using System.Collections.Generic;
+using System.IO;
+using System.Threading.Tasks;
+using Microsoft.Azure.Functions.Worker.Extensions.Sql;
+using Microsoft.Azure.Functions.Worker;
+using Microsoft.Azure.Functions.Worker.Http;
+using Microsoft.Extensions.Logging;
+using Newtonsoft.Json;
+
+namespace AzureSQL.ToDo
+{
+    public static class PostToDo
+    {
+        // create a new ToDoItem from body object
+        // uses output binding to insert new item into ToDo table
+        [FunctionName("PostToDo")]
+        public static async Task<IActionResult> Run(
+            [HttpTrigger(AuthorizationLevel.Anonymous, "post", Route = "PostFunction")] HttpRequest req,
+            ILogger log,
+            [Sql("dbo.ToDo", ConnectionStringSetting = "SqlConnectionString")] IAsyncCollector<ToDoItem> toDoItems,
+            [Sql("dbo.RequestLog", ConnectionStringSetting = "SqlConnectionString")] IAsyncCollector<RequestLog> requestLogs)
+        {
+            string requestBody = await new StreamReader(req.Body).ReadToEndAsync();
+            ToDoItem toDoItem = JsonConvert.DeserializeObject<ToDoItem>(requestBody);
+
+            // generate a new id for the todo item
+            toDoItem.Id = Guid.NewGuid();
+
+            // set Url from env variable ToDoUri
+            toDoItem.url = Environment.GetEnvironmentVariable("ToDoUri")+"?id="+toDoItem.Id.ToString();
+
+            // if completed is not provided, default to false
+            if (toDoItem.completed == null)
+            {
+                toDoItem.completed = false;
+            }
+
+            await toDoItems.AddAsync(toDoItem);
+            await toDoItems.FlushAsync();
+            List<ToDoItem> toDoItemList = new List<ToDoItem> { toDoItem };
+
+            requestLog = new RequestLog();
+            requestLog.RequestTimeStamp = DateTime.Now;
+            requestLog.ItemCount = 1;
+            await requestLogs.AddAsync(requestLog);
+            await requestLogs.FlushAsync();
+
+            return new OkObjectResult(toDoItemList);
+        }
+    }
+
+    public class RequestLog {
+        public DateTime RequestTimeStamp { get; set; }
+        public int ItemCount { get; set; }
+    }
+}
+```
+
+<a id="http-trigger-write-records-using-iasynccollector-c-oop"></a>
+
+### HTTP trigger, write records using IAsyncCollector
+
+The following example shows a [C# function](functions-dotnet-class-library.md) that adds a collection of records to a database, using data provided in an HTTP POST body JSON array.
+
+```cs
+using Microsoft.AspNetCore.Http;
+using Microsoft.AspNetCore.Mvc;
+using Microsoft.Azure.Functions.Worker;
+using Microsoft.Azure.Functions.Worker.Extensions.Sql;
+using Microsoft.Azure.Functions.Worker.Http;
+using Newtonsoft.Json;
+using System.IO;
+using System.Threading.Tasks;
+
+namespace AzureSQLSamples
+{
+    public static class WriteRecordsAsync
+    {
+        [FunctionName("WriteRecordsAsync")]
+        public static async Task<IActionResult> Run(
+            [HttpTrigger(AuthorizationLevel.Anonymous, "post", Route = "addtodo-asynccollector")]
+            HttpRequest req,
+            [Sql("dbo.ToDo", ConnectionStringSetting = "SqlConnectionString")] IAsyncCollector<ToDoItem> newItems)
+        {
+            string requestBody = await new StreamReader(req.Body).ReadToEndAsync();
+            var incomingItems = JsonConvert.DeserializeObject<ToDoItem[]>(requestBody);
+            foreach (ToDoItem newItem in incomingItems)
+            {
+                await newItems.AddAsync(newItem);
+            }
+            // Rows are upserted here
+            await newItems.FlushAsync();
+
+            return new CreatedResult($"/api/addtodo-asynccollector", "done");
+        }
+    }
+}
+```
 
 <!-- Uncomment to support C# script examples.
 # [C# Script](#tab/csharp-script)

articles/azure-functions/functions-bindings-azure-sql.md

@@ -35,16 +35,19 @@ Functions execute in the same process as the Functions host. To learn more, see
 
 Add the extension to your project by installing this [NuGet package](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Extensions.Sql).
 
+```bash
+dotnet add package Microsoft.Azure.WebJobs.Extensions.Sql --prerelease
+```
+
 # [Isolated process](#tab/isolated-process)
 
 Functions execute in an isolated C# worker process. To learn more, see [Guide for running C# Azure Functions in an isolated worker process](dotnet-isolated-process-guide.md).
 
-> [!NOTE]
-> In the current preview, Azure SQL bindings aren't supported when your function app runs in an isolated worker process.
+Add the extension to your project by installing this [NuGet package](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.Extensions.Sql/).
 
-<!--
-Add the extension to your project by installing this [NuGet package](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.Extensions.SignalRService/).
--->
+```bash
+dotnet add package Microsoft.Azure.Functions.Worker.Extensions.Sql --prerelease
+```
 
 <!-- awaiting bundle support
 # [C# script](#tab/csharp-script)