Introducción a los enlaces de Azure Data Explorer para Azure Functions (versión preliminar)
En este conjunto de artículos se explica cómo trabajar con enlaces de Azure Data Explorer en Azure Functions. Azure Functions admite enlaces de entrada y enlaces de salida para clústeres de Azure Data Explorer.
| Acción | Tipo |
|---|---|
| Lectura de datos de una base de datos | Enlace de entrada |
| Ingesta de datos en una base de datos | Enlace de salida |
Instale la extensión
El paquete NuGet de extensión que instale depende del modo de C# que esté usando 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 C# Azure Functions 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.Kusto --prerelease
Instalación de la agrupación
La extensión de enlaces de Azure Data Explorer forma parte de una agrupación de extensiones en versión preliminar, que se especifica en el archivo de proyecto de host.json.
Puede agregar la agrupación de extensiones en versión preliminar agregando o reemplazando el código siguiente en el archivo host.json :
{
"version": "2.0",
"extensionBundle": {
"id": "Microsoft.Azure.Functions.ExtensionBundle.Preview",
"version": "[4.*, 5.0.0)"
}
}
Sistema en tiempo de ejecución de Functions
Nota
La compatibilidad del lenguaje Python con la extensión de enlaces de Azure Data Explorer está disponible a partir de la versión 4.6.0 o posterior del entorno de ejecución de Functions. Es posible que tenga que actualizar la instalación de Azure Functions Core Tools para el desarrollo local.
Instalación de la agrupación
La extensión de enlaces de Azure Data Explorer forma parte de una agrupación de extensiones en versión preliminar, que se especifica en el archivo de proyecto de host.json.
Puede agregar la agrupación de extensiones en versión preliminar agregando o reemplazando el código siguiente en el archivo 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 enlaces de Azure Data Explorer forma parte de una agrupación de extensiones en versión preliminar, que se especifica en el archivo de proyecto de host.json.
Puede agregar la agrupación de extensiones en versión preliminar agregando o reemplazando el código siguiente en el archivo host.json :
{
"version": "2.0",
"extensionBundle": {
"id": "Microsoft.Azure.Functions.ExtensionBundle.Preview",
"version": "[4.*, 5.0.0)"
}
}
Actualizar paquetes
Agregue la biblioteca de Java para enlaces de Azure Data Explorer al proyecto de Functions con una actualización del archivo en el pom.xml proyecto de Azure Functions de Python, como se indica a continuación:
<dependency>
<groupId>com.microsoft.azure.functions</groupId>
<artifactId>azure-functions-java-library-kusto</artifactId>
<version>1.0.4-Preview</version>
</dependency>
Cadena de conexión de Kusto
Los enlaces de Azure Data Explorer para Azure Functions tienen una propiedad obligatoria para la cadena de conexión en todos los enlaces. La cadena de conexión se documenta en las cadenas de conexión de Kusto.
Consideraciones
- El enlace de Azure Data Explorer admite tanto la versión 4.x del entorno de ejecución de Functions como las posteriores.
- El código fuente de los enlaces de Azure Data Explorer se encuentra en este repositorio de GitHub.
- Este enlace requiere conectividad a Azure Data Explorer. Para los enlaces de entrada, los usuarios requieren permisos de visor . Para los enlaces de salida, los usuarios requieren permisos de ingestor . Para obtener más información sobre los permisos, consulte Control de acceso basado en rol.