Запросы к таблицам и агрегации

Prev Next

Узнайте, как выполнять запросы к таблицам Tulip и создавать агрегаты, доступные в приложениях Tulip

В этой статье вы узнаете...

  • Возможности запросов к таблицам и агрегаций
  • Как создавать запросы и агрегации
  • Как использовать запросы и агрегаты в приложениях

Обзор

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

В этой статье мы будем использовать следующую таблицу заказов, состоящую из 10 строк:

В правом верхнем углу вы видите кнопки «Запросы » и «Агрегации». Нажмите «Запросы », чтобы добавить новый запрос.

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

Агрегации добавляются поверх запроса и, как и запросы, создаются на уровне таблицы. Нажмите «Агрегации», чтобы создать новую агрегацию.

В следующем примере будет произведена сумма по полю таблицы «Количество товара»:

Запросы

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

Фильтры

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

Примеры вариантов сравнения:

  • равно / не равно
  • значение равно нулю / значение не равно нулю
  • содержит / не содержит
  • начинается с / не начинается с
  • заканчивается на / не заканчивается на
  • находится в
  • больше или равно / меньше или равно
  • находится после или равен / находится до или равен

Статическое значение будет задано статически при построении запроса, а ввод из приложения будет настраиваться в самом приложении. Ввод из приложения можно настроить как:

  • переменной
  • Статическое значение
  • Информация о приложении
  • Запись в таблице Tulip

Теперь в запросах к таблицам можно использовать поля «Создано» и «Обновлено ».

Сортировка

Настройте отображение записей, используя параметр «Сортировка ». Примеры:

  • От A до Z / От Z до A
  • От 0 до 9 / От 9 до 0

Ограничения

Максимальное количество записей, возвращаемых по запросу.

  • По умолчанию: 1 000
  • Максимум: 1 000

:::(Предупреждение) (Поведение при достижении предела)

Если в таблице содержится больше записей records, соответствующих фильтрам запроса (или вообще, если фильтры не заданы), чем предусмотрено ограничением, в результат запроса включается только то количество записей, которое указано в ограничении.

Если запрос содержит сортировку, будут включены первые records в соответствии с этой сортировкой.
:::

Тестирование

После настройки запроса с помощью параметров «Фильтр», «Сортировка» и «Ограничение» запрос можно протестировать прямо в таблице, нажав кнопку «Тест». Это позволит увидеть, какие результаты запрос вернет в приложении.

Использование запросов в приложениях

Чтобы добавить запрос в приложение, сначала добавьте таблицу в приложение, перейдя на вкладку «Записи» и нажав «+Добавить таблицу». Затем нажмите «Запрос ».

В появившемся модальном окне присвойте запросу «Имя запроса» и, если необходимо, настройте «Ввод данных приложения», связанный с фильтром. В этом примере рассмотрим запрос «Неотправленные товары»:

Теперь, когда запрос настроен в приложении, встройте интерактивную таблицу и выберите в качестве источника данных этот запрос.

Во встроенной таблице будут отображаться результаты запроса. В данном примере возвращаются 3 записи, соответствующие фильтру:«Отправлено» равно «Нет»:

Агрегации

Агрегации — это сводные значения, которые вычисляются на основе запросов и могут определять одно из следующих значений для конкретного столбца:

Среднее* — возвращает среднее значение чисел или целых чисел

Count* — возвращает количество записей; поле не требуется

Max* — возвращает максимальное значение из числа или целого числа

Min* — возвращает минимальное значение из числа или целого числа

Мода* Возвращает наиболее часто встречающееся значение* Примечание: если два значения имеют одинаковую частоту встречаемости, всегда возвращается меньшее значение.

Sum* — возвращает сумму чисел или целых чисел

Уникальные значения* Возвращает массив отдельных уникальных значений заданного запроса, независимо от типа данных

Ограничения

Агрегации могут учитывать не более 1 000 записей.

Агрегации выполняются над записями, возвращаемыми настроенным запросом. Ограничение, установленное для родительского запроса агрегации, также применяется к самой агрегации (1 000 записей).

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

Если вам необходимо выполнить агрегацию более 1 000 записей для использования в приложении, воспользуйтесь конечной точкой runAggregation API Tulip, которая поддерживает до 100 000 записей, через функцию коннектора.

Если вам нужно лишь визуализировать агрегацию, содержащую более 1 000 записей, создайте анализ «Одиночное значение» (Single Value ) с помощью Analytics, который позволяет проводить агрегацию по всем записям в таблице.

Использование агрегаций в приложениях

Аналогично тому, как запрос добавляется в приложение, добавьте агрегацию, нажав «+Добавить агрегацию», и присвойте ей имя.

В данном примере агрегация «Общее количество заказанных товаров » выполняется над запросом, который возвращает только записи, не отгруженные. По этой причине агрегация получила название «Количество товаров, подлежащих отгрузке»:

Чтобы встроить агрегацию в приложение, перетащите переменную в приложение и выберите источник данных — «Агрегация таблицы Tulip». Затем выберите имя агрегации, которое было задано при добавлении агрегации в приложение.

В данном примере агрегация «Сумма количества товаров » была запущена на основе запроса, возвращающего записи, которые необходимо отправить. В результате получается итоговое значение 17:

Использование агрегаций в логике приложения

С помощью агрегаций у вас есть возможность строить логику приложения на основе значения агрегации. См. пример ниже:

Обратите внимание, что в настоящее время однозначные показатели Tulip Analytics недоступны из приложения и не могут напрямую использоваться в логике приложения. Запустив агрегацию на основе запроса, вы сможете ориентироваться на это значение и, таким образом, построить логику приложения вокруг него.

{{snippet.Нашли ли вы то, что искали?}}