Библиотека запросов
Last updated
Last updated
Библиотека запросов позволяет хранить, повторно использовать и предоставлять общий доступ к запросам данных для всех источников данных в рабочей области. Вы можете создавать и запускать запросы в библиотеке запросов и вызывать их из любого приложения Apeekflow. Это поможет вам организовать и заранее определить важные запросы, например, для коллег, которые работают с вами над приложениями.
Основная функция библиотеки запросов — создавать повторно используемые запросы и управлять ими с помощью управления версиями.
Нажмите + Создать и выберите источник данных. Вы можете переименовать запрос.
Введите код и нажмите ▶ Выполнить, чтобы получить результаты. Результаты будут отображены в нижней части окна.
Если они доступны на основе источника данных, вспомогательные метаданные будут отображаться справа, что ускорит создание запросов.
В некоторых случаях требуется передавать в запрос динамические параметры. Функция Apeekflow поддерживает это, вводя входную конфигурацию запроса.
Нажмите кнопку Добавить на вкладке Входные данные в правой верхней панели, чтобы добавить входные параметры.
Используя обозначение шаблона {{}}
, вы можете использовать динамические входные параметры в запросе. Чтобы протестировать входной параметр, вы можете задать тестовые значения, которые непосредственно используются в запросе.
Вы можете ссылаться только на переменные вместо написания кода JavaScript в {{}}
.
Чтобы отредактировать название и описание входных переменных, нажмите ···
и выберите Изменить или щелкните непосредственно на названии переменной.
Когда вы закончите писать версию запроса, вы сможете опубликовать ее. Нажмите ···
> Опубликовать.
Чтобы просмотреть и восстановить хронологические версии запроса, перейдите в ···
> История версий.
Вы можете восстановить свой текущий черновик до версии журнала, выбрав целевую версию из списка версий журнала и нажав Восстановить эту версию. Нажмите Выход, чтобы вернуться в режим редактирования.
Запросы могут обновляться по требованию. Вы можете адаптировать запрос к более новой версии и в то же время поддерживать более старую версию. Такое управление версиями возможно в библиотеке запросов. Нажмите ···
в правом верхнем углу, чтобы опубликовать различные версии запросов, и вы сможете просматривать и восстанавливать историю версий.
Библиотека запросов автоматически предлагает на выбор формат обновления версий (от незначительного к основному изменению версии), поэтому вы можете использовать семантическое управление версиями (также известное как SemVer) для присвоения названия вашей версии.
В приложении или модуле нажмите +Создать в Редакторе запросов на нижней панели, затем выберите Импортировать из библиотеки запросов.
Выберите запрос из библиотеки в выпадающем списке, выберите желаемую версию и введите соответствующие входные параметры.
Вы можете экспортировать запрос в виде файла определения в формате JSON. Это помогает повторно использовать запрос или просто в качестве резервной копии.
Имейте ввиду, что подключенный источник данных запроса может иметь разные учетные данные безопасности.
На основе файла JSON вы можете импортировать запросы в Apeekflow. На экране обзора библиотеки запросов вы можете использовать кнопку Импортировать из файла.
Администратор рабочей области и разработчики имеют доступ к Библиотеке запросов и разрешения на чтение и запись для всех запросов в библиотеке.