# Paginator::query()

URL: https://chugunov.pro/api-bitrix/main/db/paginator/query/
Проверено на 1С-Битрикс 25.x, обновлено 03.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией 1С-Битрикс.

Класс: [`\Bitrix\Main\DB\Paginator`](https://chugunov.pro/api-bitrix/main/db/paginator/)
Модуль: Main.
Свойства элемента: method, public, static.

## Сигнатура

```php
public static query(string $sql, Connection $connection, int $numberOfRecords, int $pageNumber, int $numberOfRecordsPerPage[, bool $backward = false ]) : Result
```

## Описание

Выполняет вычисления смещения и лимита и выполняет ограниченный запрос к $connection.

## Параметры

- `$sql` `string` — обязательный. SQL-запрос.
- `$connection` `Connection` — обязательный. Соединение с базой данных для выполнения запроса.
- `$numberOfRecords` `int` — обязательный. Общее количество записей, возвращённых SQL-запросом.
- `$pageNumber` `int` — обязательный. Отображаемая страница.
- `$numberOfRecordsPerPage` `int` — обязательный. Размер страницы.
- `$backward` `bool` — необязательный, по умолчанию `false`. Использовать обратную постраничную навигацию.

## Возвращаемое значение

`Result`

Оригинал в официальной документации: https://docs.1c-bitrix.ru/api/classes/Bitrix-Main-DB-Paginator.html