Manage language extensions in your Azure Data Explorer cluster
The language extensions feature allows you to use language extension plugins to integrate other languages into your Azure Data Explorer KQL queries. When you run a user-defined-function (UDF) using a relevant script, the script gets tabular data as its input and is expected to produce tabular output. The plugin's runtime is hosted in a sandbox, an isolated and secure environment, running on the cluster's nodes. In this article, you manage the language extensions plugin in your Azure Data Explorer cluster within the Azure portal.
Prerequisites
- An Azure subscription. Create a free Azure account.
- An Azure Data Explorer cluster and database. Create a cluster and database.
- Review the limitations.
Enable language extensions on your cluster
Do the following steps to enable a language extension on your cluster:
In the Azure portal, go to your Azure Data Explorer cluster.
Select Settings.
Under Configurations, locate the language extension you want to use, and then select On.
For Python, in the pane that opens, select a Python image from the list, and then select OK.
Select Save.
Note
Enabling the language extension can take up to 30 minutes. The process doesn't impact on cluster availability.
Change the Python language extensions image on your cluster
Do the following steps to edit the image of your Python language extension on your cluster:
In the Azure portal, go to your Azure Data Explorer cluster.
Select Settings.
Under Configurations, locate the Python language extension, and then select Edit.
In the pane that opens, select a Python image from the list, and then select OK.
Select Save.
Note
Updating the image process can take up to 30 minutes. The process doesn't impact on cluster availability.
Disable language extensions on your cluster
Note
Disabling the image process can take up to 30 minutes. The process doesn't impact on cluster availability.
Do the following steps to disable language extensions on your cluster:
In the Azure portal, go to your Azure Data Explorer cluster.
In Settings, select Configurations.
In the Configurations pane, select Off to disable a language extension.
Select Save.
Limitations
- The language extensions runtime sandbox allocates disk space even if no query runs in the scope of the relevant language. For more detailed limitations, see sandboxes.
- For VM SKUs that don't support nested virtualization, see limitations.
Related content
- Learn how to run Python integrated KQL queries
- Learn how to run R integrated KQL queries
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for