Skip to content

Commit e7eda08

Browse files
authored
Merge pull request #298385 from ShawnJackson/azure-database-for-mysql-bindings
[AQ] edit pass: Articles about Azure Database for MySQL bindings
2 parents 39d6840 + 351f762 commit e7eda08

7 files changed

+387
-439
lines changed

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

Lines changed: 128 additions & 143 deletions
Large diffs are not rendered by default.

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

Lines changed: 86 additions & 91 deletions
Large diffs are not rendered by default.

articles/azure-functions/functions-bindings-azure-mysql-trigger.md

Lines changed: 128 additions & 152 deletions
Large diffs are not rendered by default.
Lines changed: 37 additions & 46 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Azure Database for MySQL bindings for Functions
2+
title: Azure Database for MySQL Bindings for Functions
33
description: Understand how to use Azure Database for MySQL bindings in Azure Functions.
44
author: JetterMcTedder
55
ms.topic: reference
@@ -15,37 +15,37 @@ ms.reviewer: glenga
1515
zone_pivot_groups: programming-languages-set-functions-lang-workers
1616
---
1717

18-
# Azure Database for MySQL bindings for Azure Functions overview (Preview)
18+
# Overview of Azure Database for MySQL bindings for Azure Functions (preview)
1919

20-
This set of articles explains how to work with [Azure Database for MySQL](/azure/mysql/index) bindings in Azure Functions. For preview, Azure Functions supports input bindings and output bindings for Azure Database for MySQL.
20+
This set of articles explains how to work with [Azure Database for MySQL](/azure/mysql/index) bindings in Azure Functions. For the preview, Azure Functions supports input bindings and output bindings for Azure Database for MySQL.
2121

2222
| Action | Type |
2323
|---------|---------|
2424
| Read data from a database | [Input binding](./functions-bindings-azure-mysql-input.md) |
2525
| Save data to a database |[Output binding](./functions-bindings-azure-mysql-output.md) |
26-
| Trigger a function when a change is detected on a MySQL Table | [Trigger binding](./functions-bindings-azure-mysql-trigger.md) |
26+
| Trigger a function when a change is detected in a MySQL table | [Trigger binding](./functions-bindings-azure-mysql-trigger.md) |
2727

2828
::: zone pivot="programming-language-csharp"
2929

30-
## Install extension
30+
## Install the extension
3131

32-
The extension NuGet package you install depends on the C# mode you're using in your function app:
32+
The extension NuGet package that you install depends on the C# mode you're using in your function app:
3333

3434
# [Isolated worker model](#tab/isolated-process)
3535

36-
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).
36+
Functions run 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).
3737

38-
Add the extension to your project by installing this [NuGet package](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.Extensions.MySql/1.0.3-preview/).
38+
Add the extension to your project by installing [this NuGet package](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.Extensions.MySql/1.0.3-preview/).
3939

4040
```bash
4141
dotnet add package Microsoft.Azure.Functions.Worker.Extensions.MySql --version 1.0.3-preview
4242
```
4343

4444
# [In-process model](#tab/in-process)
4545

46-
Functions execute in the same process as the Functions host. To learn more, see [Develop C# class library functions using Azure Functions](functions-dotnet-class-library.md).
46+
Functions run in the same process as the Azure Functions host. To learn more, see [Develop C# class library functions using Azure Functions](functions-dotnet-class-library.md).
4747

48-
Add the extension to your project by installing this [NuGet package](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Extensions.MySql/1.0.3-preview).
48+
Add the extension to your project by installing [this NuGet package](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Extensions.MySql/1.0.3-preview).
4949

5050
```bash
5151
dotnet add package Microsoft.Azure.WebJobs.Extensions.MySql --version 1.0.3-preview
@@ -55,16 +55,15 @@ dotnet add package Microsoft.Azure.WebJobs.Extensions.MySql --version 1.0.3-prev
5555

5656
::: zone-end
5757

58-
5958
::: zone pivot="programming-language-javascript, programming-language-powershell"
6059

61-
## Install bundle
60+
## Install the bundle
6261

63-
The MySQL bindings extension is part of the v4 [extension bundle](./functions-bindings-register.md#extension-bundles), which is specified in your host.json project file.
62+
The extension for Azure Database for MySQL bindings is part of the v4 [extension bundle](./functions-bindings-register.md#extension-bundles). This bundle is specified in your host.json project file.
6463

65-
### Preview Bundle v4.x
64+
### Preview bundle v4.x
6665

67-
You can use the preview extension bundle by adding or replacing the following code in your `host.json` file:
66+
You can use the preview extension bundle by adding or replacing the following code in your host.json file:
6867

6968
```json
7069
{
@@ -80,20 +79,15 @@ You can use the preview extension bundle by adding or replacing the following co
8079

8180
::: zone-end
8281

83-
8482
::: zone pivot="programming-language-python"
8583

86-
## Functions runtime
87-
88-
89-
## Install bundle
84+
## Install the bundle
9085

91-
The MySQL bindings extension is part of the v4 [extension bundle](./functions-bindings-register.md#extension-bundles), which is specified in your host.json project file.
86+
The extension for Azure Database for MySQL bindings is part of the v4 [extension bundle](./functions-bindings-register.md#extension-bundles). This bundle is specified in your host.json project file.
9287

88+
### Preview bundle v4.x
9389

94-
### Preview Bundle v4.x
95-
96-
You can use the preview extension bundle by adding or replacing the following code in your `host.json` file:
90+
You can use the preview extension bundle by adding or replacing the following code in your host.json file:
9791

9892
```json
9993
{
@@ -109,17 +103,15 @@ You can use the preview extension bundle by adding or replacing the following co
109103

110104
::: zone-end
111105

112-
113106
::: zone pivot="programming-language-java"
114107

108+
## Install the bundle
115109

116-
## Install bundle
110+
The extension for Azure Database for MySQL bindings is part of the v4 [extension bundle](./functions-bindings-register.md#extension-bundles). This bundle is specified in your host.json project file.
117111

118-
The MySQL bindings extension is part of the v4 [extension bundle](./functions-bindings-register.md#extension-bundles), which is specified in your host.json project file.
112+
### Preview bundle v4.x
119113

120-
### Preview Bundle v4.x
121-
122-
You can use the preview extension bundle by adding or replacing the following code in your `host.json` file:
114+
You can use the preview extension bundle by adding or replacing the following code in your host.json file:
123115

124116
```json
125117
{
@@ -135,7 +127,7 @@ You can use the preview extension bundle by adding or replacing the following co
135127

136128
## Update packages
137129

138-
You can use the preview extension bundle with an update to the `pom.xml` file in your Java Azure Functions project as seen in the following snippet:
130+
You can use the preview extension bundle with an update to the pom.xml file in your Java Azure Functions project, as shown in the following snippet:
139131

140132
```xml
141133
<dependency>
@@ -149,27 +141,26 @@ You can use the preview extension bundle with an update to the `pom.xml` file in
149141

150142
## MySQL connection string
151143

152-
Azure Database for MySQL bindings for Azure Functions have a required property for the connection string on all bindings. These pass the connection string to the MySql.Data.MySqlClient library and supports the connection string as defined in the [MySqlClient ConnectionString documentation](https://dev.mysql.com/doc/connector-net/en/connector-net-connections-string.html). Notable keywords include:
144+
Azure Database for MySQL bindings for Azure Functions have a required property for the connection string. These bindings pass the connection string to the MySql.Data.MySqlClient library and provide support as defined in the [MySqlClient ConnectionString documentation](https://dev.mysql.com/doc/connector-net/en/connector-net-connections-string.html). Notable keywords include:
153145

154-
- `server` the host on which the server instance is running. The value can be a host name, IPv4 address, or IPv6 address.
155-
- `uid` the MySQL user account to provide for the authentication process
156-
- `pwd` the password to use for the authentication process.
157-
- `database` The default database for the connection. If no database is specified, the connection has no default database
146+
- `server`: The host on which the server instance is running. The value can be a host name, IPv4 address, or IPv6 address.
147+
- `uid`: The MySQL user account to provide for the authentication process.
148+
- `pwd`: The password to use for the authentication process.
149+
- `database`: The default database for the connection. If no database is specified, the connection has no default database.
158150

159151
## Considerations
160152

161-
- Azure Database for MySQL binding supports version 4.x and later of the Functions runtime.
162-
- Source code for the Azure Database for MySQL bindings can be found in [this GitHub repository](https://github.com/Azure/azure-functions-mysql-extension/tree/main/src).
163-
- This binding requires connectivity to an Azure Database for MySQL.
164-
- Output bindings against tables with columns of spatial data types `GEOMETRY`, `POINT`, or `POLYGON` aren't supported and data upserts will fail.
153+
- Azure Database for MySQL bindings support version 4.x and later of the Azure Functions runtime.
154+
- You can find source code for the Azure Database for MySQL bindings in [this GitHub repository](https://github.com/Azure/azure-functions-mysql-extension/tree/main/src).
155+
- These bindings require connectivity to Azure Database for MySQL.
156+
- Output bindings against tables with columns of spatial data types `GEOMETRY`, `POINT`, and `POLYGON` aren't supported. Data upserts fail.
165157

166158
## Samples
167159

168-
In addition to the samples for C#, Java, JavaScript, PowerShell, and Python available in the [Azure MySQL bindings GitHub repository](https://github.com/Azure/azure-functions-mysql-extension/tree/main/samples), more are available in Azure Samples.
169-
160+
In addition to the samples for C#, Java, JavaScript, PowerShell, and Python available in the [GitHub repository for Azure Database for MySQL bindings](https://github.com/Azure/azure-functions-mysql-extension/tree/main/samples), more are available in [Azure Samples](https://github.com/Azure-Samples).
170161

171-
## Next steps
162+
## Related content
172163

173-
- [Read data from a database (Input binding)](./functions-bindings-azure-mysql-input.md)
174-
- [Save data to a database (Output binding)](./functions-bindings-azure-mysql-output.md)
175-
- [Trigger a function when a change is detected on a table (Trigger binding)](./functions-bindings-azure-mysql-trigger.md)
164+
- [Read data from a database (input binding)](./functions-bindings-azure-mysql-input.md)
165+
- [Save data to a database (output binding)](./functions-bindings-azure-mysql-output.md)
166+
- [Trigger a function when a change is detected in a table (trigger binding)](./functions-bindings-azure-mysql-trigger.md)

includes/functions-bindings-csharp-intro-with-csx.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -6,8 +6,8 @@ ms.date: 11/16/2021
66
ms.author: glenga
77
---
88

9-
A C# function can be created by using one of the following C# modes:
9+
You can create a C# function by using one of the following C# modes:
1010

11-
* [Isolated worker model](../articles/azure-functions/dotnet-isolated-process-guide.md): Compiled C# function that runs in a worker process that's isolated from the runtime. Isolated worker process is required to support C# functions running on LTS and non-LTS versions .NET and the .NET Framework.
12-
* [In-process model](../articles/azure-functions/functions-dotnet-class-library.md): Compiled C# function that runs in the same process as the Functions runtime.
11+
* [Isolated worker model](../articles/azure-functions/dotnet-isolated-process-guide.md): Compiled C# function that runs in a worker process that's isolated from the runtime. An isolated worker process is required to support C# functions running on long-term support (LTS) and non-LTS versions for .NET and the .NET Framework.
12+
* [In-process model](../articles/azure-functions/functions-dotnet-class-library.md): Compiled C# function that runs in the same process as the Azure Functions runtime.
1313
* [C# script](../articles/azure-functions/functions-reference-csharp.md): Used primarily when you create C# functions in the Azure portal.

includes/functions-host-json-section-intro.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,4 +6,4 @@ ms.date: 10/05/2021
66
ms.author: glenga
77
---
88

9-
This section describes the configuration settings available for this binding in versions 2.x and higher. Settings in the host.json file apply to all functions in a function app instance. The example host.json file below contains only the version 2.x+ settings for this binding. For more information about function app configuration settings in versions 2.x and later versions, see [host.json reference for Azure Functions](../articles/azure-functions/functions-host-json.md).
9+
This section describes the configuration settings available for this binding in version 2.x and later. Settings in the host.json file apply to all functions in a function app instance. The following example host.json file contains only the version 2.x+ settings for this binding. For more information about function app configuration settings in version 2.x and later, see [host.json reference for Azure Functions](../articles/azure-functions/functions-host-json.md).

includes/functions-runtime-scaling.md

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -8,9 +8,10 @@ ms.author: glenga
88

99
# [Azure portal](#tab/portal)
1010

11-
In the Azure portal, in your function app, choose **Configuration** and on the **Function runtime settings** tab turn **Runtime scale monitoring** to **On**.
11+
1. In the Azure portal, in your function app, select **Configuration**.
12+
1. On the **Function runtime settings** tab, for **Runtime Scale Monitoring**, select **On**.
1213

13-
:::image type="content" source="../articles/azure-functions/media/functions-create-vnet/11-enable-runtime-scaling.png" alt-text="Screenshot of Azure portal panel to enable runtime scaling.":::
14+
:::image type="content" source="../articles/azure-functions/media/functions-create-vnet/11-enable-runtime-scaling.png" alt-text="Screenshot of the Azure portal area for enabling runtime scaling.":::
1415

1516
# [Azure CLI](#tab/azure-cli)
1617

@@ -20,4 +21,4 @@ Use the following Azure CLI command to enable runtime scale monitoring:
2021
az resource update -g <RESOURCE_GROUP> -n <FUNCTION_APP_NAME>/config/web --set properties.functionsRuntimeScaleMonitoringEnabled=1 --resource-type Microsoft.Web/sites
2122
```
2223

23-
---
24+
---

0 commit comments

Comments
 (0)