Merge pull request #279189 from JetterMcTedder/main

Update docs for python V2 examples and optional config samples

Author: v-dirichards

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

@@ -1,11 +1,11 @@
 ---
 title: Azure SQL input binding for Functions
 description: Learn to use the Azure SQL input binding in Azure Functions.
-author: dzsquared
+author: JetterMcTedder
 ms.topic: reference
 ms.custom: build-2023, devx-track-extended-java, devx-track-js, devx-track-python, devx-track-ts
-ms.date: 4/17/2023
-ms.author: drskwier
+ms.date: 6/20/2024
+ms.author: bspendolini
 ms.reviewer: glenga
 zone_pivot_groups: programming-languages-set-functions
 ---
@@ -413,7 +413,7 @@ The following example shows a SQL input binding that is [triggered by an HTTP](.
 
 # [Model v3](#tab/nodejs-v3)
 
-TypeScript samples are not documented for model v3.
+TypeScript samples aren't documented for model v3.
 
 ---
 
@@ -488,7 +488,7 @@ The following example shows a SQL input binding that is [triggered by an HTTP](.
 
 # [Model v3](#tab/nodejs-v3)
 
-TypeScript samples are not documented for model v3.
+TypeScript samples aren't documented for model v3.
 
 ---
 
@@ -568,7 +568,7 @@ The stored procedure `dbo.DeleteToDo` must be created on the database.  In this
 
 # [Model v3](#tab/nodejs-v3)
 
-TypeScript samples are not documented for model v3.
+TypeScript samples aren't documented for model v3.
 
 ---
 
@@ -816,6 +816,34 @@ The examples refer to a database table:
 
 The following example shows a SQL input binding in a function.json file and a Python function that is [triggered by an HTTP](./functions-bindings-http-webhook-trigger.md) request and reads from a query and returns the results in the HTTP response.
 
+# [v2](#tab/python-v2)
+
+```python
+import json
+import logging
+import azure.functions as func
+from azure.functions.decorators.core import DataType
+
+app = func.FunctionApp()
+
+@app.function_name(name="GetToDo")
+@app.route(route="gettodo")
+@app.sql_input(arg_name="todo",
+                        command_text="select [Id], [order], [title], [url], [completed] from dbo.ToDo",
+                        command_type="Text",
+                        connection_string_setting="SqlConnectionString")
+def get_todo(req: func.HttpRequest, todo: func.SqlRowList) -> func.HttpResponse:
+    rows = list(map(lambda r: json.loads(r.to_json()), todo))
+
+    return func.HttpResponse(
+        json.dumps(rows),
+        status_code=200,
+        mimetype="application/json"
+    )
+```
+
+# [v1](#tab/python-v1)
+
 The following is binding data in the function.json file:
 
 ```json
@@ -862,11 +890,42 @@ def main(req: func.HttpRequest, todoItems: func.SqlRowList) -> func.HttpResponse
     ) 
 ```
 
+---
+
 <a id="http-trigger-look-up-id-from-query-string-python"></a>
 ### HTTP trigger, get row by ID from query string
 
 The following example shows a SQL input binding in a Python function that is [triggered by an HTTP](./functions-bindings-http-webhook-trigger.md) request and reads from a query filtered by a parameter from the query string and returns the row in the HTTP response.
 
+# [v2](#tab/python-v2)
+
+```python
+import json
+import logging
+import azure.functions as func
+from azure.functions.decorators.core import DataType
+
+app = func.FunctionApp()
+
+@app.function_name(name="GetToDo")
+@app.route(route="gettodo/{id}")
+@app.sql_input(arg_name="todo",
+                        command_text="select [Id], [order], [title], [url], [completed] from dbo.ToDo where Id = @Id",
+                        command_type="Text",
+                        parameters="@Id={id}",
+                        connection_string_setting="SqlConnectionString")
+def get_todo(req: func.HttpRequest, todo: func.SqlRowList) -> func.HttpResponse:
+    rows = list(map(lambda r: json.loads(r.to_json()), todo))
+
+    return func.HttpResponse(
+        json.dumps(rows),
+        status_code=200,
+        mimetype="application/json"
+    )
+```
+
+# [v1](#tab/python-v1)
+
 The following is binding data in the function.json file:
 
 ```json
@@ -914,6 +973,7 @@ def main(req: func.HttpRequest, todoItem: func.SqlRowList) -> func.HttpResponse:
     ) 
 ```
 
+---
 
 <a id="http-trigger-delete-one-or-multiple-rows-python"></a>
 ### HTTP trigger, delete rows
@@ -924,6 +984,34 @@ The stored procedure `dbo.DeleteToDo` must be created on the database.  In this
 
 :::code language="sql" source="~/functions-sql-todo-sample/sql/create.sql" range="11-25":::
 
+# [v2](#tab/python-v2)
+
+```python
+import json
+import logging
+import azure.functions as func
+from azure.functions.decorators.core import DataType
+
+app = func.FunctionApp()
+
+@app.function_name(name="DeleteToDo")
+@app.route(route="deletetodo/{id}")
+@app.sql_input(arg_name="todo",
+                        command_text="DeleteToDo",
+                        command_type="StoredProcedure",
+                        parameters="@Id={id}",
+                        connection_string_setting="SqlConnectionString")
+def get_todo(req: func.HttpRequest, todo: func.SqlRowList) -> func.HttpResponse:
+    rows = list(map(lambda r: json.loads(r.to_json()), todo))
+
+    return func.HttpResponse(
+        json.dumps(rows),
+        status_code=200,
+        mimetype="application/json"
+    )
+```
+
+# [v1](#tab/python-v1)
 
 ```json
 {
@@ -970,6 +1058,8 @@ def main(req: func.HttpRequest, todoItems: func.SqlRowList) -> func.HttpResponse
     ) 
 ```
 
+---
+
 ::: zone-end
 
 
@@ -1058,7 +1148,7 @@ The attribute's constructor takes the SQL command text, the command type, parame
 
 Queries executed by the input binding are [parameterized](/dotnet/api/microsoft.data.sqlclient.sqlparameter) in Microsoft.Data.SqlClient to reduce the risk of [SQL injection](/sql/relational-databases/security/sql-injection) from the parameter values passed into the binding.
 
-If an exception occurs when a SQL input binding is executed then the function code will not execute.  This may result in an error code being returned, such as an HTTP trigger returning a 500 error code.
+If an exception occurs when a SQL input binding is executed then the function code won't execute.  This may result in an error code being returned, such as an HTTP trigger returning a 500 error code.
 
 ## Next steps
 

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

@@ -1,11 +1,11 @@
 ---
 title: Azure SQL output binding for Functions
 description: Learn to use the Azure SQL output binding in Azure Functions.
-author: dzsquared
+author: JetterMcTedder
 ms.topic: reference
 ms.custom: build-2023, devx-track-extended-java, devx-track-js, devx-track-python, devx-track-ts
-ms.date: 4/17/2023
-ms.author: drskwier
+ms.date: 6/20/2024
+ms.author: bspendolini
 ms.reviewer: glenga
 zone_pivot_groups: programming-languages-set-functions
 ---
@@ -44,7 +44,7 @@ The examples refer to a `ToDoItem` class and a corresponding database table:
 
 :::code language="sql" source="~/functions-sql-todo-sample/sql/create.sql" range="1-7":::
 
-To return [multiple output bindings](./dotnet-isolated-process-guide.md#multiple-output-bindings) in our samples, we will create a custom return type:
+To return [multiple output bindings](./dotnet-isolated-process-guide.md#multiple-output-bindings) in our samples, we'll create a custom return type:
 
 ```cs
 public static class OutputType
@@ -539,7 +539,7 @@ The following example shows a SQL output binding that adds records to a table, u
 
 # [Model v3](#tab/nodejs-v3)
 
-TypeScript samples are not documented for model v3.
+TypeScript samples aren't documented for model v3.
 
 ---
 
@@ -621,7 +621,7 @@ CREATE TABLE dbo.RequestLog (
 
 # [Model v3](#tab/nodejs-v3)
 
-TypeScript samples are not documented for model v3.
+TypeScript samples aren't documented for model v3.
 
 ---
 
@@ -860,6 +860,35 @@ The examples refer to a database table:
 
 The following example shows a SQL output binding in a function.json file and a Python function that adds records to a table, using data provided in an HTTP POST request as a JSON body.
 
+# [v2](#tab/python-v2)
+
+```python
+import json
+import logging
+import azure.functions as func
+from azure.functions.decorators.core import DataType
+
+app = func.FunctionApp()
+
+@app.function_name(name="AddToDo")
+@app.route(route="addtodo")
+@app.sql_output(arg_name="todo",
+                        command_text="[dbo].[ToDo]",
+                        connection_string_setting="SqlConnectionString")
+def add_todo(req: func.HttpRequest, todo: func.Out[func.SqlRow]) -> func.HttpResponse:
+    body = json.loads(req.get_body())
+    row = func.SqlRow.from_dict(body)
+    todo.set(row)
+
+    return func.HttpResponse(
+        body=req.get_body(),
+        status_code=201,
+        mimetype="application/json"
+    )
+```
+
+# [v1](#tab/python-v1)
+
 The following is binding data in the function.json file:
 
 ```json
@@ -918,6 +947,8 @@ def main(req: func.HttpRequest, todoItems: func.Out[func.SqlRow]) -> func.HttpRe
         )
 ```
 
+---
+
 <a id="http-trigger-write-to-two-tables-python"></a>
 ### HTTP trigger, write to two tables
 
@@ -933,6 +964,53 @@ CREATE TABLE dbo.RequestLog (
 )
 ```
 
+# [v2](#tab/python-v2)
+
+```python
+from datetime import datetime
+import json
+import logging
+import azure.functions as func
+
+app = func.FunctionApp()
+
+@app.function_name(name="PostToDo")
+@app.route(route="posttodo")
+@app.sql_output(arg_name="todoItems",
+                        command_text="[dbo].[ToDo]",
+                        connection_string_setting="SqlConnectionString")
+@app.sql_output(arg_name="requestLog",
+                        command_text="[dbo].[RequestLog]",
+                        connection_string_setting="SqlConnectionString")
+def add_todo(req: func.HttpRequest, todoItems: func.Out[func.SqlRow], requestLog: func.Out[func.SqlRow]) -> func.HttpResponse:
+    logging.info('Python HTTP trigger and SQL output binding function processed a request.')
+    try:
+        req_body = req.get_json()
+        rows = func.SqlRowList(map(lambda r: func.SqlRow.from_dict(r), req_body))
+    except ValueError:
+        pass
+
+    requestLog.set(func.SqlRow({
+        "RequestTimeStamp": datetime.now().isoformat(),
+        "ItemCount": 1
+    }))
+
+    if req_body:
+        todoItems.set(rows)
+        return func.HttpResponse(
+            "OK",
+            status_code=201,
+            mimetype="application/json"
+        )
+    else:
+        return func.HttpResponse(
+            "Error accessing request body",
+            status_code=400
+        )
+```
+
+# [v1](#tab/python-v1)
+
 The following is binding data in the function.json file:
 
 ```json
@@ -1004,6 +1082,7 @@ def main(req: func.HttpRequest, todoItems: func.Out[func.SqlRow], requestLog: fu
         )
 ```
 
+---
 
 ::: zone-end