Compartir a través de

Introducción a los enlaces de Azure Database for MySQL para Azure Functions

En este conjunto de artículos se explica cómo trabajar con enlaces de Azure Database for MySQL en Azure Functions. Azure Functions admite enlaces de entrada y enlaces de salida en disponibilidad general. Para la versión preliminar, Azure Functions admite enlaces de desencadenador para Azure Database for MySQL.

Acción Tipo
Lectura de datos de una base de datos Enlace de entrada
Guardado de datos en una base de datos Enlace de salida
Desencadenar una función cuando se detecta un cambio en una tabla MySQL (versión preliminar) Enlace del desencadenador

Instalación de la extensión

El paquete NuGet de extensión que instale depende del modo de C# que use en la aplicación de funciones:

Las funciones se ejecutan en un proceso de trabajo de C# aislado. Para más información, consulte Guía para ejecutar funciones de Azure de C# en un proceso de trabajo aislado.

Para agregar la extensión al proyecto, instale este paquete NuGet.

dotnet add package Microsoft.Azure.Functions.Worker.Extensions.MySql --version 1.0.3-preview

Instalación de la agrupación

La extensión de los enlaces de Azure Database for MySQL forma parte del conjunto de extensiones v4. Esta agrupación se especifica en el archivo de proyecto de host.json.

Paquete de versión preliminar v4.x

Puede usar la agrupación de extensiones en versión preliminar agregando o reemplazando el código siguiente en el archivo de host.json:

{
  "version": "2.0",
  "extensionBundle": {
    "id": "Microsoft.Azure.Functions.ExtensionBundle.Preview",
    "version": "[4.*, 5.0.0)"
  }
}

Instalación de la agrupación

La extensión de los enlaces de Azure Database for MySQL forma parte del conjunto de extensiones v4. Esta agrupación se especifica en el archivo de proyecto de host.json.

Paquete de versión preliminar v4.x

Puede usar la agrupación de extensiones en versión preliminar agregando o reemplazando el código siguiente en el archivo de host.json:

{
  "version": "2.0",
  "extensionBundle": {
    "id": "Microsoft.Azure.Functions.ExtensionBundle.Preview",
    "version": "[4.*, 5.0.0)"
  }
}

Instalación de la agrupación

La extensión de los enlaces de Azure Database for MySQL forma parte del conjunto de extensiones v4. Esta agrupación se especifica en el archivo de proyecto de host.json.

Paquete de versión preliminar v4.x

Puede usar la agrupación de extensiones en versión preliminar agregando o reemplazando el código siguiente en el archivo de host.json:

{
  "version": "2.0",
  "extensionBundle": {
    "id": "Microsoft.Azure.Functions.ExtensionBundle.Preview",
    "version": "[4.*, 5.0.0)"
  }
}

Actualizar paquetes

Puede usar la agrupación de extensiones en versión preliminar con una actualización del archivo pom.xml en el proyecto de Azure Functions de Java, como se muestra en el siguiente fragmento de código:

<dependency>
<groupId>com.microsoft.azure.functions</groupId>
<artifactId>azure-functions-java-library-mysql</artifactId>
<version>1.0.1-preview</version>
</dependency>

Cadena de conexión de MySQL

Los enlaces de Azure Database for MySQL para Azure Functions tienen una propiedad necesaria para la cadena de conexión. Estos enlaces pasan la cadena de conexión a la biblioteca MySql.Data.MySqlClient y proporcionan compatibilidad como se define en la documentación de ConnectionString de MySqlClient. Las palabras clave importantes incluyen las siguientes:

  • server: el host en el que se ejecuta la instancia del servidor. El valor puede ser un nombre de host, una dirección IPv4 o una dirección IPv6.
  • uid: la cuenta de usuario de MySQL que se va a proporcionar para el proceso de autenticación.
  • pwd: contraseña que se va a usar para el proceso de autenticación.
  • database: la base de datos predeterminada para la conexión. Si no se especifica ninguna base de datos, la conexión no tiene ninguna base de datos predeterminada.

Consideraciones

  • Los enlaces de Azure Database for MySQL admiten la versión 4.x y posteriores del entorno de ejecución de Azure Functions.
  • Puede encontrar código fuente para los enlaces de Azure Database for MySQL en este repositorio de GitHub.
  • Estos enlaces requieren conectividad a Azure Database for MySQL.
  • No se admiten enlaces de salida en tablas con columnas de tipos GEOMETRYde datos espaciales , POINTy POLYGON . Se produce un error en los upserts de datos.

Ejemplos

Además de los ejemplos de C#, Java, JavaScript, PowerShell y Python disponibles en el repositorio de GitHub para enlaces de Azure Database for MySQL, hay más disponibles en Ejemplos de Azure.

Contenido relacionado