Использование действия KQL для выполнения запроса

Действие KQL в Data Factory для Microsoft Fabric позволяет выполнять запрос на языке запросов Kusto (KQL) в экземпляре Azure Data Explorer.

Требуемые условия

Чтобы приступить к работе, необходимо выполнить следующие предварительные требования:

Добавьте KQL-активность в конвейер с пользовательским интерфейсом

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

Создание активности

  1. Создайте конвейер в рабочей области.

  2. Найдите KQL в области Деятельности конвейера и выберите его, чтобы добавить на рабочую область конвейера.

    Примечание.

    Возможно, потребуется развернуть меню и прокрутить вниз, чтобы увидеть действие KQL, как показано на снимке экрана ниже.

    Снимок экрана пользовательского интерфейса Fabric с выделенной панелью действий и активностью KQL.

  3. Выберите новое действие KQL на рабочей области редактора конвейера, если оно еще не выбрано.

    Снимок экрана: вкладка

Ознакомьтесь с руководством по общим параметрам, чтобы настроить вкладку "Общие параметры".

Параметры активности KQL

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

  2. Затем предоставьте запрос KQL для выполнения запроса в выбранной базе данных для свойства Command. Динамическое содержимое можно использовать в запросе, выбрав ссылку "Добавить динамическое содержимое ", которая отображается при выборе текстового поля.

    Снимок экрана: вкладка

  3. Наконец, укажите время ожидания команды или оставьте время ожидания по умолчанию в течение 20 минут. Вы также можете использовать динамическое содержимое для этого свойства.

Сохраните, запустите или запланируйте выполнение конвейера

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

Перейдите на вкладку "Главная " в верхней части редактора конвейера и нажмите кнопку "Сохранить", чтобы сохранить конвейер. Выберите "Выполнить" , чтобы запустить его напрямую или запланировать выполнение в определенный момент времени или интервалы. Дополнительные сведения о запусках конвейера см. в статье "Планирование запусков конвейера".

Снимок экрана: вкладка

После выполнения можно отслеживать выполнение конвейера и просматривать журнал выполнения с вкладки "Выходные данные " под холстом.

Известные ограничения

  • Ограничение развертывания между рабочими областями: Когда конвейер, содержащий действие KQL, развертывается между рабочими областями с помощью конвейеров развертывания, свойства связанной службы, специфичные для рабочей области, не переназначаются и по-прежнему ссылаются на исходную рабочую область. Это может привести к сбою выполнения конвейера в целевой рабочей области из-за UserErrorKustoReadFailed / EntityNotFoundException.

Обходной путь — использовать переменные рабочей области (библиотека переменных) для всех свойств подключения для конкретной рабочей области и ссылаться на них с помощью endpointVariableLibrary, artifactIdVariableLibrary и workspaceIdVariableLibrary.