Создание хранимых функций и управление ими

Функции — это многократно используемые запросы или части запросов. Аналитика в режиме реального времени поддерживает два типа функций:

• Встроенные функции — жестко запрограммированные, их нельзя модифицировать.

• Определяемые пользователем функции, разделенные на два типа:

  • Хранимые функции: определяемые пользователем функции, которые хранятся и управляются как сущности схемы базы данных, такие как таблицы. Дополнительные сведения о создании и управлении хранимыми функциями см. в обзоре управления хранимыми функциями.
  • Определяемые запросом функции: определяемые пользователем функции, которые определяются и используются в области одного запроса. Эти функции определяются с помощью инструкции let . Дополнительные сведения о создании определяемых запросом функций см. в статье "Создание определяемой пользователем функции".

Из этой статьи вы узнаете, как создать или изменить существующую хранимую функцию с помощью ..create-or-alterfunction

Для получения дополнительной информации о команде .create-or-alterfunction см. .create-or-alter function.

Предварительные условия

• Пространство для рабочих процессов с поддержкой Microsoft Fabric, обеспечивающее вместимость
• База данных KQL с разрешениями на редактирование

Создание функций

Эта функция позволяет создавать или изменять существующую функцию с помощью .create-or-alterfunction команды. Команда сохраняет функцию в метаданных базы данных. Если функция с предоставленным именем функции не существует в метаданных базы данных, команда создает новую функцию. В противном случае команда изменяет именованную функцию.

1. Перейдите к базе данных KQL и выберите "Создать>функцию". Команда .create-or-alter автоматически отображается в окне "Изучение данных ".

   

2. Введите имя функции и параметры запроса для вашей функции вместо текста-заполнителя, а затем выберите "Выполнить".

   

   Сохраненные функции отображаются в разделе "Функции " в области обозревателя .

   

3. В окне "Изучение данных " выполните запрос, чтобы убедиться, что вы успешно создали или изменили функцию.

   

Список хранимых функций

Список всех хранимых функций в базе данных можно просмотреть. Щелкнув пункт "Функции " или выбрав " Показать функции " в раскрывающемся меню, можно открыть список функций.

Этот список содержит следующие параметры:

• Папка функции и ее описание.
• Дополнительные возможности сортировки и поиска помогут вам найти определенные функции.

Щелкните функцию в списке левой кнопкой мыши, откроется предварительная версия функции только для чтения. В раскрывающемся меню можно также выбрать "Показать функцию ", чтобы открыть предварительную версию функции, изменить или удалить функцию.

Просмотр и предварительный просмотр хранимой функции

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

1. В области обозревателя разверните раздел "Функции ". Щелкните нужную функцию, чтобы открыть предварительный просмотр или выбрать три точки и показать функцию.

2. Откроется версия скрипта функции только для чтения в окне просмотра данных .

   • Вы можете выбрать предварительный просмотр результатов , чтобы просмотреть результаты функции.
   • Если функция содержит параметры, можно ввести значения для этих параметров. Затем выберите результаты предварительного просмотра , чтобы просмотреть выходные данные на основе указанных значений параметров.
   • Результаты предварительного просмотра отображаются до 100 записей на основе функционального запроса.

   

Изменение или удаление хранимой функции

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

1. В области обозревателя разверните раздел "Функции ". Выберите три точки рядом с требуемой функцией.

2. В раскрывающемся меню выберите один из следующих вариантов:

   • Редактировать с помощью кода чтобы изменить скрипт функции в окне исследования данных.
   • Удалить

   

3. Если вы изменили скрипт функции, нажмите кнопку "Выполнить ", чтобы сохранить изменения.

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

• Запрос данных в наборе запросов KQL
• Изменение политик данных
• Создание политики обновления таблицы