- Распечатать
Запросы и агрегации в таблице Tulip Table
Назначение
Узнайте, как выполнять запросы к таблицам Tulip и создавать агрегации, доступные в приложениях Tulip.
В этой статье вы узнаете...
- Возможности запросов к таблицам
- Как создавать запросы и агрегации
- Как использовать запросы и агрегации в приложениях
Обзор табличных запросов и агрегаций таблиц
С помощью запросов и агрегаций таблиц вы можете запрашивать и динамически фильтровать таблицы Tulip в приложениях.
В этой статье мы обратимся к следующей таблице заказов, содержащей 10 строк:
В правом верхнем углу вы можете видеть кнопки Запросы и Агрегации. Нажмите на кнопку Запросы, чтобы добавить новый запрос.
В следующем примере используется фильтр для возврата только тех записей, которые не были отгружены:
Агрегации добавляются поверх запроса и строятся на уровне таблицы, как и запросы. Нажмите на Агрегации, чтобы создать новую агрегацию.
В следующем примере суммируется поле таблицы " Количество товара":
Параметры запроса
Фильтр
Фильтр записей осуществляется путем сравнения определенного столбца или нескольких столбцов со статическим значением или входом приложения.
Примеры вариантов сравнения включают:
- равно / не равно
- равен нулю / не равен нулю
- содержит / не содержит
- начинается с / не начинается с
- заканчивается / не заканчивается
- находится в
- больше или равно / меньше или равно
- находится после или в / находится до или в
Static Value будет статически задаваться при построении запроса, а App Input будет настраиваться в самом приложении. App Input может быть настроен как:
- Переменная
- Статическое значение
- Информация приложения
- Запись в таблице Tulip
Теперь вы можете использовать поля Created At и Updated At в запросах к таблице.
Сортировка
Настройте отображение записей, настроив параметр Sort. Примеры включают:
- от A до Z / от Z до A
- от 0 до 9 / от 9 до 0
Лимит
Установите ограничение на количество записей, возвращаемых запросом, настроив ограничение.
После настройки запроса с помощью параметров фильтра, сортировки и ограничения запрос можно протестировать прямо в таблице, нажав кнопку Test. Это будет имитировать то, что запрос будет возвращать в приложении.
Параметры агрегирования
Агрегации - это суммарные значения, которые выполняются поверх запросов и могут вычислять одно из следующих значений для определенного столбца:
- Среднее
- Количество
- Max
- Мин
- Режим
- Сумма
- Уникальные значения
Использование запросов и агрегаций в приложениях
Добавление запросов в приложения
Чтобы добавить запрос в приложение, сначала добавьте таблицу в приложение, нажав на вкладку Records и +Add Table. Затем нажмите кнопку Запрос.
В появившемся модальном окне задайте запросу имя запроса и, если применимо, настройте App Input, связанный с фильтром. В этом примере показан запрос Products Not Shipped:
Теперь, когда запрос настроен в приложении, встройте интерактивную таблицу и выберите источник данных для запроса.
Встроенная таблица отобразит результаты запроса. В этом примере возвращены 3 записи, удовлетворяющие фильтру**"Отгружено", равному "Нет"**:
Добавление агрегаций в приложения
Аналогично тому, как запрос добавляется в приложение, добавьте агрегацию, нажав +Add Aggregation, и назначьте имя агрегации.
В этом примере агрегация Total Qty Products Ordered выполняется на запросе, который возвращает только записи, которые не были отгружены. По этой причине имя агрегации - Количество продуктов, которые будут отгружены:
Чтобы встроить агрегацию в приложение, поместите переменную в приложение и выберите Datasource - Tulip Table Aggregation. Затем выберите имя агрегации, которое было настроено при добавлении агрегации в приложение.
В этом примере агрегация Сумма количества продукта была запущена поверх запроса, возвращающего записи, которые должны быть отправлены. В результате было получено 17 записей:
Использование агрегаций в логике приложения
С помощью агрегаций у вас есть возможность построить логику приложения на основе значения агрегации. Смотрите пример ниже:
Обратите внимание, что аналитика Tulip Analytics по одному числу в настоящее время недоступна из приложения и не может быть напрямую использована в логике приложения. Запустив агрегацию в запросе, вы сможете нацелиться на это значение и, таким образом, построить логику приложения на его основе.