--- title: "Запросы к таблицам и агрегации" slug: "tulip-table-queries-and-aggregations" updated: 2026-10-22T10:15:28Z published: 2026-10-22T10:15:28Z canonical: "support.tulip.co/tulip-table-queries-and-aggregations" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.tulip.co/llms.txt > Use this file to discover all available pages before exploring further. # Запросы к таблицам и агрегации *Узнайте, как выполнять запросы к таблицам Tulip и создавать агрегаты, доступные в приложениях Tulip* **В этой статье вы узнаете...** - **Возможности запросов к таблицам и агрегаций** - **Как создавать запросы и агрегации** - **Как использовать запросы и агрегаты в приложениях** ## Обзор Табличные запросы и агрегации позволяют динамически взаимодействовать с таблицами, фильтруя и обобщая данные для использования в приложениях. В этой статье мы будем использовать следующую таблицу **заказов**, состоящую из 10 строк: ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Tulip%20Table%20Queries%20and%20Aggregations_317280187.png) В правом верхнем углу вы видите кнопки **«Запросы** » и **«Агрегации».** Нажмите **«Запросы** », чтобы добавить новый запрос. В следующем примере используется **фильтр** для вывода только тех записей, которые еще **не** отправлены: ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Tulip%20Table%20Queries%20and%20Aggregations_317280394.png) Агрегации добавляются поверх запроса и, как и запросы, создаются на уровне таблицы. Нажмите **«Агрегации»**, чтобы создать новую агрегацию. В следующем примере будет **произведена сумма** по полю таблицы **«Количество товара**»: ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Tulip%20Table%20Queries%20and%20Aggregations_317280509.png) ## Запросы Запрос позволяет фильтровать и сортировать данные в таблицах. В запросах можно использовать как статические значения, так и динамические значения, основанные на вводе данных в приложении. ### Фильтры Фильтруйте записи, сравнивая значение одного или нескольких столбцов со **статическим значением** или **введенными в приложении данными**. Примеры вариантов сравнения: - равно / не равно - значение равно нулю / значение не равно нулю - содержит / не содержит - начинается с / не начинается с - заканчивается на / не заканчивается на - находится в - больше или равно / меньше или равно - находится после или равен / находится до или равен **Статическое значение** будет задано статически при построении запроса, а **ввод из приложения** будет настраиваться в самом приложении. **Ввод из приложения** можно настроить как: - переменной - Статическое значение - Информация о приложении - Запись в таблице Tulip Теперь в запросах к таблицам можно использовать поля **«Создано»** и **«Обновлено** ». ### Сортировка Настройте отображение записей, используя параметр **«Сортировка** ». Примеры: - От A до Z / От Z до A - От 0 до 9 / От 9 до 0 ### Ограничения Максимальное количество записей, возвращаемых по запросу. - По умолчанию: 1 000 - Максимум: 1 000 :::(Предупреждение) (Поведение при достижении предела) Если в таблице содержится больше записей records, соответствующих фильтрам запроса (или вообще, если фильтры не заданы), чем предусмотрено ограничением, в результат запроса включается только то количество записей, которое указано в ограничении. Если запрос содержит сортировку, будут включены первые records в соответствии с этой сортировкой. ::: ### Тестирование После настройки запроса с помощью параметров «Фильтр», «Сортировка» и «Ограничение» запрос можно протестировать прямо в таблице, нажав **кнопку «Тест**». Это позволит увидеть, какие результаты запрос вернет в приложении. ### Использование запросов в приложениях Чтобы добавить запрос в приложение, сначала добавьте таблицу в приложение, перейдя на вкладку «Записи» и нажав **«+Добавить таблицу».** Затем нажмите **«Запрос** **».** В появившемся модальном окне присвойте запросу **«Имя запроса**» и, если необходимо, настройте «Ввод данных приложения», связанный с фильтром. В этом примере рассмотрим запрос **«Неотправленные товары»:** ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Tulip%20Table%20Queries%20and%20Aggregations_321447212.png) Теперь, когда запрос настроен в приложении, встройте **интерактивную таблицу** и выберите в качестве **источника данных** этот запрос. Во встроенной таблице будут отображаться результаты запроса. В данном примере возвращаются 3 записи, соответствующие фильтру:**«Отправлено» равно «Нет»:** ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Tulip%20Table%20Queries%20and%20Aggregations_321454203.png) ## Агрегации Агрегации — это сводные значения, которые вычисляются на основе запросов и могут определять одно из следующих значений для конкретного столбца: **Среднее*** — возвращает среднее значение чисел или целых чисел **Count*** — возвращает количество записей; поле не требуется **Max*** — возвращает максимальное значение из числа или целого числа **Min*** — возвращает минимальное значение из числа или целого числа **Мода*** Возвращает наиболее часто встречающееся значение* *Примечание: если два значения имеют одинаковую частоту встречаемости, всегда возвращается меньшее значение.* **Sum*** — возвращает сумму чисел или целых чисел **Уникальные значения*** Возвращает массив отдельных уникальных значений заданного запроса, независимо от типа данных ### Ограничения Агрегации могут учитывать не более 1 000 записей. Агрегации выполняются над записями, возвращаемыми настроенным запросом. Ограничение, установленное для родительского запроса агрегации, также применяется к самой агрегации (1 000 записей). Агрегация может показать неожиданные результаты, если в таблице содержится больше записей, соответствующих заданным фильтрам, чем предусмотрено ограничением, а пользователь не знает об ограничении запроса. Если вам необходимо **выполнить агрегацию более 1 000 записей** для использования в приложении, воспользуйтесь конечной точкой runAggregation API Tulip, [которая поддерживает до 100 000 записей](/r230/docs/factory-274-release-march-2024), через функцию коннектора. Если вам нужно лишь **визуализировать агрегацию, содержащую более 1 000 записей**, создайте [анализ «Одиночное значение» (Single Value](https://support.tulip.co/docs/template-types#single-number) ) с помощью Analytics, который позволяет проводить агрегацию по всем записям в таблице. ### Использование агрегаций в приложениях Аналогично тому, как запрос добавляется в приложение, добавьте агрегацию, нажав **«+Добавить агрегацию»**, и присвойте **ей имя**. В данном примере агрегация **«Общее количество заказанных товаров** » выполняется над запросом, который возвращает только записи, не отгруженные. По этой причине агрегация получила название **«Количество товаров, подлежащих отгрузке»:** ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Tulip%20Table%20Queries%20and%20Aggregations_321454895.png) Чтобы встроить агрегацию в приложение, перетащите **переменную** в приложение и выберите **источник данных** — **«Агрегация таблицы Tulip**». Затем выберите **имя агрегации**, которое было задано при добавлении агрегации в приложение. В данном примере агрегация **«Сумма количества товаров** » была запущена на основе запроса, возвращающего записи, которые необходимо отправить. В результате получается итоговое значение 17: ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Tulip%20Table%20Queries%20and%20Aggregations_321456395.png) ### Использование агрегаций в логике приложения С помощью агрегаций у вас есть возможность строить логику приложения на основе значения агрегации. См. пример ниже: ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Tulip%20Table%20Queries%20and%20Aggregations_321442635.png) Обратите внимание, что в настоящее время **однозначные показатели** Tulip Analytics недоступны из приложения и не могут напрямую использоваться в логике приложения. Запустив агрегацию на основе запроса, вы **сможете** ориентироваться на это значение и, таким образом, построить логику приложения вокруг него. {{snippet.Нашли ли вы то, что искали?}}