Управление расширениями языка в кластере 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. Выберите Сохранить.

Примечание.

Включение расширения языка может занять до 60 минут. Процесс не влияет на доступность кластера.

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

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

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

Примечание.

Обновление процесса изображения может занять до 60 минут. Процесс не влияет на доступность кластера.

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

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

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

Примечание.

Отключение процесса изображения может занять до 30 минут. Процесс не влияет на доступность кластера.

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

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

Ограничения

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

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

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