Инструменты · Запросы
runtime_read
Выполняет запрос ВЫБРАТЬ в живой информационной базе проекта и возвращает строки, типы колонок и время выполнения. Единственный инструмент, который видит данные, а не модель. Только чтение; по умолчанию выключен.
Когда использовать
- Отчёт пустой — ошибка в запросе или в регистре нет данных? Три строки из базы отвечают сразу.
- Проверить гипотезу о данных до правки кода: есть ли записи, какие значения.
- Правильность текста запроса без выполнения —
query_read.
Соседние инструменты домена «Запросы»
Операции
| operation | Что делает | Нужно передать |
|---|---|---|
queryпо умолчанию | Выполняет запрос и возвращает первые rows строк, типы колонок, общее число строк и время. Текст должен начинаться с ВЫБРАТЬ и не переписывается. | project, query |
Параметры
| Параметр и тип | Обязательный | Описание | По умолчанию |
|---|---|---|---|
operationстрока | нет | Операция инструмента — значения и их смысл в таблице «Операции».значения: query | query |
projectстрока | да | Проект конфигурации: используются его информационная база и конфигурация запуска EDT (пользователь, авторизация). | — |
queryстрока | да | Текст запроса, начинается с ВЫБРАТЬ. Лучше с явным ПЕРВЫЕ N: rows ограничивает только вывод, выборка целиком строится на сервере. | — |
rowsцелое | нет | Сколько строк вернуть: по умолчанию 20, максимум 200. Общее число строк всё равно указано в дайджесте. | 20 |
runner_projectстрока | нет | Проект внешней обработки, через которую выполняется запрос. Если его нет, ошибка подскажет готовый вызов project_write для создания. | КвантаРаннер |
limitцелое | нет | Окно чтения: сколько строк готового ответа вернуть. По умолчанию 200, максимум 1000. | 200 |
offsetцелое | нет | Окно чтения: номер строки ответа, с которой начать (0 — первая страница). Значение для следующей страницы подсказывает строка *lines: …* в конце ответа. | 0 |
filterстрока | нет | Регулярное выражение без учёта регистра. Сужает вывод: оставляет строки ответа, в которых есть совпадение (заголовки секций с совпадениями сохраняются). Применяется до окна чтения. | — |
Таблица собрана из схемы инструмента, которую получает агент при подключении.
Адреса
Адрес fqn не используется: на вход — текст запроса в query и проект.
Пример вызова и ответа
{
"operation": "query",
"project": "УТ2020",
"query": "ВЫБРАТЬ ПЕРВЫЕ 5 Ссылка, Наименование, Код ИЗ Справочник.Валюты",
"rows": 5
}Пример ответа в подготовке Устройство ответа — на странице Формат ответов.
Отказы и ошибки
Инструмент выключен для проекта
По умолчанию запросы к живой базе запрещены. Проект нужно явно добавить в список разрешённых в настройках Кванты (параметр runtime.allowed.projects плагина).
Нет проекта обработки-исполнителя
Запрос выполняется маленькой внешней обработкой в базе. Если её проекта нет, ответ содержит готовый вызов project_write для его создания.
Запрос не начинается с ВЫБРАТЬ
Инструмент только читает: любой другой текст отклоняется.
failed · Unknown operation
Неизвестное значение operation. В ответе — fix_hint: supported: … со списком допустимых операций и секция Did you mean. Допустимо: query.
failed · лицензия
Без действующего ключа инструмент отвечает карточкой failed с сообщением лицензия: … и подсказкой, где ввести ключ; в секции Context — список инструментов, доступных без ключа. Подробнее — Лицензия и бесплатный доступ.
Ограничения
- Каждый вызов — отдельный сеанс клиента 1С через штатный запуск EDT: 10–30 секунд. Нужна свободная клиентская лицензия 1С.
- Данные базы попадают в контекст модели — выбирайте только нужные поля и строки.
- Ответы не кэшируются.