Библиотека запросов

Библиотека запросов позволяет хранить, повторно использовать и предоставлять общий доступ к запросам данных для всех источников данных в рабочей области. Вы можете создавать и запускать запросы в библиотеке запросов и вызывать их из любого приложения Apeekflow. Это поможет вам организовать и заранее определить важные запросы, например, для коллег, которые работают с вами над приложениями.

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

Создание нового запроса

1. Нажмите + Создать и выберите источник данных. Вы можете переименовать запрос.

Введите код и нажмите ▶ Выполнить, чтобы получить результаты. Результаты будут отображены в нижней части окна.

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

Входные параметры

В некоторых случаях требуется передавать в запрос динамические параметры. Функция Apeekflow поддерживает это, вводя входную конфигурацию запроса.

Нажмите кнопку Добавить на вкладке Входные данные в правой верхней панели, чтобы добавить входные параметры.

Используя обозначение шаблона {{}}, вы можете использовать динамические входные параметры в запросе. Чтобы протестировать входной параметр, вы можете задать тестовые значения, которые непосредственно используются в запросе.

Чтобы отредактировать название и описание входных переменных, нажмите ··· и выберите Изменить или щелкните непосредственно на названии переменной.

Публикация запросов

Когда вы закончите писать версию запроса, вы сможете опубликовать ее. Нажмите ··· > Опубликовать.

История версий запросов

Чтобы просмотреть и восстановить хронологические версии запроса, перейдите в ··· > История версий.

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

Управление версиями запросов к данным

Запросы могут обновляться по требованию. Вы можете адаптировать запрос к более новой версии и в то же время поддерживать более старую версию. Такое управление версиями возможно в библиотеке запросов. Нажмите ··· в правом верхнем углу, чтобы опубликовать различные версии запросов, и вы сможете просматривать и восстанавливать историю версий.

Библиотека запросов автоматически предлагает на выбор формат обновления версий (от незначительного к основному изменению версии), поэтому вы можете использовать семантическое управление версиями (также известное как SemVer) для присвоения названия вашей версии.

Использование запросов к данным из библиотеки запросов

В приложении или модуле нажмите +Создать в Редакторе запросов на нижней панели, затем выберите Импортировать из библиотеки запросов.

Выберите запрос из библиотеки в выпадающем списке, выберите желаемую версию и введите соответствующие входные параметры.

Экспорт и импорт запросов

Экспорт запросов к данным

Вы можете экспортировать запрос в виде файла определения в формате JSON. Это помогает повторно использовать запрос или просто в качестве резервной копии.

Запросы на импорт

На основе файла JSON вы можете импортировать запросы в Apeekflow. На экране обзора библиотеки запросов вы можете использовать кнопку Импортировать из файла.

Разрешения

Администратор рабочей области и разработчики имеют доступ к Библиотеке запросов и разрешения на чтение и запись для всех запросов в библиотеке.