Как ограничить число элементов в n8n через Limit

Ограничьте число элементов через Limit в n8n: первые или последние записи, учебный пример и проверка порядка. Отделите выбор количества от лимита запросов.

Если после выгрузки или API-запроса пришло слишком много записей и вы решаете, как ограничить количество элементов в n8n, добавьте Limit. Нода убирает из потока элементы сверх заданного максимума. Вы выбираете, какие записи оставить: с начала или с конца. Чтобы из трёх учебных записей оставить первые две, задайте Max Items = 2 и Keep = First Items. Затем сверьте число элементов и их ID на выходе.

Нода Limit: что она делает с потоком элементов

Нода Limit удаляет элементы сверх определённого максимума, а выбор того, берет ли n8n элементы с начала или с конца входных данных, остаётся за вами [1].

Это позиционное действие: нода не смотрит на значения полей и не решает, какие записи важнее. Она работает с порядком элементов так, как он пришёл на вход.

Параметры Max Items и Keep

Настройка ноды опирается на два параметра [1].

Max Items — максимальное число элементов, которое n8n должен сохранить. Если входных данных больше этого значения, n8n убирает лишние элементы.

Keep — применяется, когда ноде приходится удалять элементы, и указывает, где она удерживает входные элементы:

  • First Items — оставляет Max Items элементов с начала входных данных.
  • Last Items — оставляет Max Items элементов с конца входных данных.

Оба параметра задают только количество и сторону потока. Про содержимое записей они не говорят ничего.

First Items или Last Items: выбор по порядку входа

Выбор между First Items и Last Items зависит от того, в каком порядке элементы приходят на вход и какой конец потока для задачи важен.

First Items сохраняет первые Max Items элементов входных данных, Last Items сохраняет Max Items элементов с конца входных данных [1].

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

Когда элементов меньше, чем Max Items

Нода убирает элементы только тогда, когда вход содержит больше Max Items [1]. Если входных элементов меньше или ровно столько же, удалять нечего: нода пропускает набор дальше без изменений.

Отсюда простое правило проверки на старте: сравните число входных элементов с Max Items. При меньшем числе нода не изменит поток, при большем — оставит ровно Max Items.

Limit и Sort: позиция против значения поля

Если нужны первые элементы по значению поля (например, крупнейшие лиды по сумме или свежие записи по дате), сначала задайте порядок через Sort, затем Limit отберёт нужное количество.

Sort организует списки элементов в желаемом порядке или генерирует случайную выборку [2]. Тип Simple выполняет сортировку по возрастанию или убыванию по выбранным полям, где через Add Field To Sort By задаётся имя поля, а также определяется порядок Ascending или Descending [2].

Маршрут такой: Sort задаёт порядок потока, Limit берёт с нужной стороны число записей. Обратный порядок нод может дать другое множество на выходе: Sort получит только те записи, которые уже оставил Limit.

Чем Limit не является: Filter и rate limits

Limit работает по позиции и количеству, поэтому его легко перепутать с двумя другими задачами.

Filter отбирает элементы по условию: если элемент удовлетворяет условию, нода передаёт его дальше, а если не удовлетворяет — исключает из вывода [4]. Условия задаются сравнениями: для строк доступны проверки вроде «равно», «содержит» или «начинается с», для чисел — «больше» или «меньше» [4]. Limit такого условия не задаёт: правило задано одним числом и стороной потока, поэтому на выход проходят первые или последние записи в текущем порядке.

Ограничение частоты запросов к API решается отдельно от Limit. Rate limits — это ограничения на частоту запросов: сервис может ограничить число обращений в минуту или в день, а также объём данных в одном запросе или ответе [5]. В n8n такие лимиты обрабатывают настройкой Retry On Fail либо связкой нод Loop Over Items и Wait [5]: Retry On Fail добавляет паузу между попытками запроса, а Loop Over Items вместе с Wait разбивает данные на порции и выдерживает паузу между запросами [5]. Limit внутри такого сценария управляет тем, сколько элементов остаётся в потоке n8n — например, сколько записей сценарий продолжит обрабатывать после шага, который вернул больше данных, чем нужно.

Три задачи различаются по действию: Filter пропускает записи по условию, Limit оставляет заданную часть потока, ограничение частоты касается числа обращений к внешнему сервису за интервал.

Учебный прогон: три записи, Max Items 2

Учебный пример

Возьмём три записи, которые приходят на вход Limit в таком порядке:

Позиция ID
1
search30
2
social18
3
email12

Max Items = 2.

Вариант A, Keep = First Items. Нода оставляет первые две записи с начала входных данных:

Позиция ID
1
search30
2
social18

Число элементов на выходе — 2, совпадает с Max Items. Прошли ID search30 и social18, третий элемент email12 удалён.

Вариант B, Keep = Last Items. Нода оставляет две записи с конца входных данных:

Позиция ID
2
social18
3
email12

Число элементов на выходе — 2, совпадает с Max Items. Прошли ID social18 и email12, первый элемент search30 удалён.

Проверка результата. Сверьте два показателя: число элементов на выходе Limit и их ID. В варианте A ожидаем 2 элемента с ID search30 и social18, в варианте B — 2 элемента с ID social18 и email12. Если число на выходе меньше Max Items, проверьте, сколько элементов пришло на вход: при входе не больше Max Items нода ничего не убирает и пропускает набор как есть.

Есть нюанс с «топом по лидам». Если задача — оставить первые записи по значению поля (например, по сумме сделки), порядок сначала задаёт Sort, и уже потом Limit берёт нужное количество. В учебном наборе выше порядок задан позицией во входе, поэтому выбор First или Last решает, какой конец потока останется.

Дальше по цепочке этот результат попадает в другие ноды сценария. О том, как такие шаги связываются в измеримую автоматизацию маркетинга, — в разборе автоматизации маркетинга, а про расчёт отдачи от сценариев — в материале про ROI автоматизации.

Ограничение числа элементов в n8n этим не заканчивается. Limit отвечает за количество и сторону потока — это тот рычаг, который стоит проверять по числу и ID на выходе, прежде чем строить на нём дальнейшую логику.

Источники

  1. Limitdocs.n8n.io
  2. Sortdocs.n8n.io
  3. Filterdocs.n8n.io
  4. Handling API rate limitsdocs.n8n.io

Валерий Курземнек

Автор метода «Машиночитаемый маркетинг»

Что ещё почитать