Запросы и агрегации в таблице Tulip

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

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

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

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

Агрегации

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

• Среднее
• Count
• Max
• Min
• Режим
• Сумма
• Уникальные значения

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

Это означает, что агрегации могут учитывать максимум 1 000 записей. Поэтому они могут показывать неожиданные результаты, если в таблице больше записей для заданных фильтров, чем установлено ограничение, а пользователь не знает об ограничении запроса.

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

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

Добавление запросов в приложения

Чтобы добавить запрос в приложение, сначала добавьте таблицу в приложение, нажав на вкладку Records и +Add Table. Затем нажмите кнопку Запрос.

В появившемся модале задайте запросу имя запроса и, если применимо, настройте App Input, связанный с фильтром. В этом примере мы видим запрос Products Not Shipped:

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

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

Добавление агрегаций в приложения

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

В этом примере агрегация Total Qty Products Ordered выполняется на запросе, который возвращает только записи, которые не были отправлены. По этой причине имя агрегации - Количество товаров, которые будут отгружены:

Чтобы встроить агрегацию в приложение, поместите переменную в приложение и выберите Datasource - Tulip Table Aggregation. Затем выберите имя агрегации, которое было настроено при добавлении агрегации в приложение.

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

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

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

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