Manage language extensions in your Azure Data Explorer cluster

  • Article

The language extensions feature allows you to use language extension plugins to integrate other languages into your Azure Data Explorer KQL queries. 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

Enable language extensions on your cluster

Do the following steps to enable a language extension on your cluster:

  1. In the Azure portal, go to your Azure Data Explorer cluster.

  2. Select Settings.

  3. Under Configurations, locate the language extension you want to use, and then select On.

    Screenshot of Azure Data Explorer cluster configuration page, showing the enable language extension options.

  4. For Python, select the desired image from the list.

  5. Select Save.

Note

Enabling the language extension can take up to 60 minutes. The process doesn't impact 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:

  1. In the Azure portal, go to your Azure Data Explorer cluster.
  2. Select Settings.
  3. Under Configurations, select the desired Python image from the list.
  4. Select Save.

Note

Updating the image process can take up to 60 minutes. The process doesn't impact cluster availability.

Disable language extensions on your cluster

Note

Disabling the image process can take up to 30 minutes. The process doesn't impact cluster availability.

Do the following steps to disable language extensions on your cluster:

  1. In the Azure portal, go to your Azure Data Explorer cluster.
  2. In Settings, select Configurations.
  3. In the Configurations pane, select Off to disable a language extension.
  4. 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.

Related content