Edit

Azure Data Explorer bindings for Azure Functions overview (preview)

  • Article

This set of articles explains how to work with Azure Data Explorer bindings in Azure Functions. Azure Functions supports input bindings and output bindings for Azure Data Explorer clusters.

Action Type
Read data from a database Input binding
Ingest data to a database Output binding

Install the extension

The extension NuGet package you install depends on the C# mode you're using in your function app.

Functions run in an isolated C# worker process. To learn more, see Guide for running C# Azure Functions in an isolated worker process.

Add the extension to your project by installing this NuGet package.

dotnet add package Microsoft.Azure.Functions.Worker.Extensions.Kusto --prerelease

Install the bundle

Azure Data Explorer bindings extension is part of a preview extension bundle, which is specified in your host.json project file.

You can add the preview extension bundle by adding or replacing the following code in your host.json file:

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

Functions runtime

Note

Python language support for the Azure Data Explorer bindings extension is available starting with v4.6.0 or later of the Functions runtime. You might need to update your installation of Azure Functions Core Tools for local development.

Install the bundle

The Azure Data Explorer bindings extension is part of a preview extension bundle, which is specified in your host.json project file.

You can add the preview extension bundle by adding or replacing the following code in your host.json file:

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

Install the bundle

Azure Data Explorer bindings extension is part of a preview extension bundle, which is specified in your host.json project file.

You can add the preview extension bundle by adding or replacing the following code in your host.json file:

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

Update packages

Add the Java library for Azure Data Explorer bindings to your Functions project with an update to the pom.xml file in your Python Azure Functions project, as follows:

<dependency>
    <groupId>com.microsoft.azure.functions</groupId>
    <artifactId>azure-functions-java-library-kusto</artifactId>
    <version>1.0.4-Preview</version>
</dependency>

Kusto connection string

Azure Data Explorer bindings for Azure Functions have a required property for the connection string on all bindings. The connection string is documented at Kusto connection strings.

Considerations

  • Azure Data Explorer binding supports version 4.x and later of the Functions runtime.
  • Source code for the Azure Data Explorer bindings is in this GitHub repository.
  • This binding requires connectivity to Azure Data Explorer. For input bindings, users require Viewer permissions. For output bindings, users require Ingestor permissions. For more information about permissions, see Role-based access control.

Next steps