query_read — Документация Кванты

query_read

R · чтениепо подпискене изменяет проект

Проверяет текст запроса 1С, не выполняя его: синтаксис и типы, а с параметром project — существование таблиц и полей по конфигурации, как в конструкторе запроса EDT. Валидный запрос дополнительно проходит ревью по стандартам ИТС: советы приходят в секции Recommendations.

Когда использовать

Перед записью запроса в модуль или в набор СКД — чтобы не сохранить запрос к несуществующему полю.
Ревью запроса по стандартам ИТС: соединения без условий, виртуальные таблицы без периода и отбора, отбор в ГДЕ вместо параметров, соединение по неиндексированному реквизиту, ПОДОБНО "%…", ПЕРВЫЕ без сортировки и другие.
Запрос из схемы компоновки с {ВЫБРАТЬ …} — dcs: true.
Что запрос вернёт на данных — runtime_read.

Соседние инструменты домена «Запросы»

runtime_readRвыполнить запрос в живой базе и увидеть строки

Операции

Операции query_read
operation	Что делает	Нужно передать
`verify`по умолчанию	Проверка текста. Без `project` — синтаксис и проверки типов внутри запроса. С `project` — плюс таблицы и поля конфигурации и полный набор правил ревью. `dcs: true` — грамматика СКД без семантики. Диагностика с позицией `строка:колонка` и кодом.	`query`; для семантики — `project`

Параметры

Параметры query_read
Параметр и тип	Обязательный	Описание	По умолчанию
`operation`строка	нет	Операция инструмента — значения и их смысл в таблице «Операции».значения: verify	`verify`
`query`строка	да	Текст запроса на языке запросов 1С: `ВЫБРАТЬ … ИЗ … ГДЕ …` (или по-английски).	—
`project`строка	нет	Проект для семантики: таблицы и поля сверяются с его конфигурацией. Без проекта — только синтаксис и типы. При `dcs: true` не используется.	—
`dcs`булево	нет	true — грамматика схемы компоновки: конструкции `{ВЫБРАТЬ …}`, `{ГДЕ …}`; без семантики.	`false`
`limit`целое	нет	Окно чтения: сколько строк готового ответа вернуть. По умолчанию 200, максимум 1000.	`200`
`offset`целое	нет	Окно чтения: номер строки ответа, с которой начать (0 — первая страница). Значение для следующей страницы подсказывает строка `lines: …` в конце ответа.	`0`
`filter`строка	нет	Регулярное выражение без учёта регистра. Сужает вывод: оставляет строки ответа, в которых есть совпадение (заголовки секций с совпадениями сохраняются). Применяется до окна чтения.	—

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

Адреса

Адрес fqn не используется: на вход — текст запроса в query.

Пример вызова и ответа

Проверка без project: четыре правила, которым нужна конфигурация, перечислены в Skipped, а дайджест говорит об охвате — rules: 17/21. Совет не меняет зелёный кружок: запрос корректен. С project таблицы и поля сверяются с конфигурацией и работают все 21 правило.

аргументы query_read

{
  "query": "ВЫБРАТЬ Т.Ссылка ИЗ Справочник.Номенклатура КАК Т ГДЕ Т.Наименование ПОДОБНО \"%стол%\""
}

ответ инструмента

### 🟢 query_read verify

> Σ errors: 0 · warnings: 0 · recommendations: 1 · rules: 17/21

- **status:** 🟢 ok

#### Recommendations (1)

- 1:1 `Т.Наименование` [ql-like-leading-percent] — Уберите ведущий символ подстановки в ПОДОБНО "%стол%" — с ним индекс не работает, таблица читается целиком · std-658

#### Skipped (1)

- нужна семантика (укажите project): ql-vt-filter-in-where, ql-vt-period-in-where, ql-slice-join-inner, ql-join-on-unindexed-attribute

_std-NNN → its.1c.ru/db/v8std/content/NNN/hdoc_

Отказы и ошибки

ошибка в запросе

Синтаксическая или семантическая ошибка — кружок , строка ERROR строка:колонка [код] — сообщение. Ревью при ошибках не выполняется: дайджест говорит recommendations: n/a.

Таблица или поле не найдены

Только с project: имя сверяется с конфигурацией, как в конструкторе запроса. Без проекта такие ошибки не видны.

failed · Unknown operation

Неизвестное значение operation. В ответе — fix_hint: supported: … со списком допустимых операций и секция Did you mean. Допустимо: verify.

failed · лицензия

Без действующего ключа инструмент отвечает карточкой failed с сообщением лицензия: … и подсказкой, где ввести ключ; в секции Context — список инструментов, доступных без ключа. Подробнее — Лицензия и бесплатный доступ.

Ограничения

Запрос не выполняется; данные — runtime_read.
В режиме СКД семантика не проверяется, а правила про пустые параметры виртуальных таблиц не применяются: их подставляет компоновщик.
Советы ревью не влияют на статус; до 12 советов в ответе, до 3 на правило.