Управление расширениями языка в кластере Azure Data Explorer

Функция расширения языка позволяет использовать подключаемые модули расширения языка для интеграции других языков в запросы KQL Azure Data Explorer. Среда выполнения подключаемого модуля размещается в песочнице, изолированной и безопасной среде, работающей на узлах кластера. В этой статье вы узнаете, как управлять подключаемым модулем языковых расширений в кластере Azure Data Explorer на портале Azure.

Необходимые компоненты

• Подписка Azure. Создайте бесплатную учетную запись Azure.
• Кластер и база данных Azure Data Explorer. Создайте кластер и базу данных.
• Просмотрите ограничения. Обратите внимание, что расширения языка можно включить только на номерах SKU, поддерживающих вложенную виртуализацию.
• Разрешения Cluster AllDatabasesAdmin. Управление разрешениями кластера Azure Data Explorer.

Включение расширений языка в кластере

Выполните следующие действия, чтобы включить расширение языка в кластере:

1. На портале Azure перейдите к кластеру Azure Data Explorer.

2. Выберите Параметры.

3. В разделе "Конфигурации" найдите расширение языка, которое вы хотите использовать, и нажмите кнопку "Вкл.".

   

4. Для Python выберите нужное изображение из списка. Образ можно управлять или пользовательским образом.

5. Выберите Сохранить.

Изменение образа расширений языка Python в кластере

Чтобы изменить изображение расширения языка Python в кластере, сделайте следующее:

1. На портале Azure перейдите к кластеру Azure Data Explorer.
2. Выберите Параметры.
3. В разделе "Конфигурации" выберите нужный образ Python из списка.
4. Выберите Сохранить.

Создание пользовательского образа

1. На портале Azure перейдите к кластеру Azure Data Explorer.

2. Выберите Параметры.

3. В разделе "Конфигурации" выберите + Добавить пользовательский образ (предварительная версия)

4. В открывающейся области укажите следующие сведения:

   • Имя пользовательского образа: имя пользовательского образа.
   • Начните с: выберите подсистему Python или существующий образ.
     • Подсистема Python:
       1. Введите допустимый номер версии Python.
       2. Добавьте файл требований.
     • Существующий образ:
       1. Выберите существующее изображение из раскрывающегося списка.
       2. Добавьте файл требований.

5. Нажмите OK.

   

После создания образа можно изменить или удалить его.

Файл требований

Поддерживаемые файлы требований находятся в формате pip requirements.txt и могут включать любой пакет Python. Каждая строка содержит имя пакета, за которым следует номер пакета. Например:

annotated-types==0.6.0
anytree
arrow==1.3.0
attrs==23.2.0

Отключение расширений языка в кластере

Чтобы отключить расширения языка в кластере, выполните следующие действия:

1. На портале Azure перейдите к кластеру Azure Data Explorer.
2. В разделе Параметры выберите пункт Конфигурации.
3. В области Конфигурации выберите Выкл., чтобы отключить расширение языка.
4. Выберите Сохранить.

Ограничения

• Песочница среды выполнения расширений языка выделяет место на диске, даже если в области соответствующего языка не выполняется ни один запрос. Дополнительные сведения об ограничениях см. в разделе Песочницы.

Связанный контент

• Узнайте, как запускать интегрированные запросы KQL на Python
• Узнайте, как запускать интегрированные запросы KQL R