--- name: onec-performance-and-cluster description: "Диагностирует и оптимизирует производительность 1С: замеры времени с учётом RLS и СУБД, тяжёлые запросы, обращение через точку в циклах, длительные операции с временным хранилищем и диагностика кластера серверов (сеансы, соединения, ragent, rmngr, rphost). Используй при тормозах форм, отчётов, проведения и фоновых заданий." --- # Производительность, оптимизация кода и кластер серверов 1С Используй навык, когда операция 1С выполняется медленно, нагружает СУБД или сервер приложений, требует выноса расчёта в фоновое задание (`ДлительныеОперации`) либо расследования зависших сеансов и процессов кластера 1С. Синтаксис и прикладную логику самих запросов сверяй с навыком [`onec-query-composition`](../onec-query-composition/SKILL.md), а инструменты профилирования EDT — с [`edt-mcp-project-profiling`](../edt-mcp-project-profiling/SKILL.md). ## Достоверный замер до и после оптимизации - **Никогда не оценивай скорость запроса и формы только под «Полными правами»** и на пустой демо-базе: у реального пользователя к каждому запросу с `РАЗРЕШЕННЫЕ` платформа присоединяет подзапросы RLS, которые меняют план выполнения СУБД на порядки. Замер проводи под целевым профилем прав и на сопоставимом объёме данных. - Различай в профилировщике и замере **чистое собственное время строки** и **суммарное время с вложенными вызовами**, а также количество вызовов строки (`КоличествоВызовов`): быстрый запрос на `5 мс`, вызванный `4 000` раз внутри цикла по строкам документа, даёт `20 с` задержки. - Отличай холодный и прогретый кэш СУБД/платформы при сравнении вариантов «до / после». ## Главные антипаттерны запросов и обхода коллекций в BSL 1. **Разыменование ссылок через точку в цикле (`Строка.Номенклатура.ВидНоменклатуры.СтавкаНДС`)** и вызовы запросов внутри цикла: каждое обращение через точку к объекту вне кэша порождает отдельный запрос чтения всего объекта из СУБД (`N+1`). Выгрузи массив ссылок через `Таблица.ВыгрузитьКолонку("Номенклатура")` и прочитай все нужные реквизиты одним пакетным запросом в `Соответствие`. 2. **Опасная механическая замена `ИЛИ` на `ОБЪЕДИНИТЬ ВСЕ`**: `ИЛИ` в условии соединения или `ГДЕ` часто мешает использованию индекса СУБД, но разбиение на ветви `ОБЪЕДИНИТЬ ВСЕ` допустимо только при **непересекающихся условиях ветвей** (или с явным исключением пересечения `И НЕ (...)`), иначе строки, удовлетворяющие обоим условиям, удвоятся и исказят суммы! 3. **Сужение составного типа ссылки**: условие вида `Таблица.Регистратор ССЫЛКА Документ.РеализацияТоваровУслуг` или обращение к реквизиту составного поля без предварительного отбора типа заставляет платформу соединять десятки таблиц всех возможных типов регистраторов (`LEFT JOIN` ко всем документам). Сужай тип или передавай типизированные параметры на самом раннем шаге пакета. 4. **Параметры виртуальных таблиц регистров**: условия отбора по измерениям и срез периода передавай **внутрь параметров виртуальной таблицы** `Остатки(&Момент, Номенклатура В (&СписокНоменклатуры))`, а не в секцию `ГДЕ` внешнего запроса (в `ГДЕ` платформа сначала рассчитает остатки по всей базе, а затем отфильтрует их). 5. **Временные таблицы и индексы**: помещай промежуточные выборки во временные таблицы (`ПОМЕСТИТЬ ВТ_...`) с `ИНДЕКСИРОВАТЬ ПО` по полям последующих соединений, а после последнего использования освобождай большие таблицы через `УНИЧТОЖИТЬ ВТ_...`, чтобы не раздувать `tempdb` / временное табличное пространство СУБД. ## Длительные операции и временное хранилище Для операций дольше нескольких секунд в управляемой форме используй штатную подсистему `ДлительныеОперации` БСП (не блокируй клиент синхронным серверным вызовом): - Передавай тяжёлые данные и итоговый результат (сформированный `ТабличныйДокумент`, файл, таблицу ошибок) между фоновым заданием и формой через **`ПоместитьВоВременноеХранилище(..., ИдентификаторФормы)`**, а после чтения результата очищай временное хранилище (`УдалитьИзВременногоХранилища`), чтобы не допускать утечки памяти рабочего процесса. - **Таймаут ожидания на клиенте не отменяет серверное фоновое задание автоматически**: если пользователь закрыл окно ожидания или истёк клиентский таймер, явно предусмотренная команда отмены должна вызывать штатную отмену задания, а обработчик завершения `ОписаниеОповещения` обязан проверять актуальность открытой формы и идентификатора запущенной операции. ## Сеансы, соединения и процессы кластера серверов 1С При расследовании зависаний, утечек памяти и блокировок на сервере не смешивай сущности кластера: | Сущность | Роль и диагностический смысл | |---|---| | **`ragent`** | Агент сервера 1С на хосте — запускает и контролирует менеджеры и рабочие процессы узла | | **`rmngr`** | Менеджер кластера — хранит реестр кластера, управляет сеансами, лицензиями, управляемыми блокировками (`TLOCK`) и балансировкой | | **`rphost`** | Рабочий процесс — непосредственно исполняет код BSL, строит запросы к СУБД и держит память контекстов вызовов | | **Сеанс (Session)** | Логическое состояние работы пользователя или фонового задания в кластере (может сохраняться в гибернации без активного соединения) | | **Соединение (Connection)** | Активный сетевой канал клиента/фонового потока с конкретным `rphost` или СУБД в данный момент | Не перезапускай весь `ragent` и не убивай `rphost` по имени образа вслепую ради одного зависшего отчёта: это оборвёт транзакции и несохранённую работу всех сеансов на этом рабочем процессе. Сначала сопоставь номер сеанса, активный серверный вызов, блокирующего владельца и запрос СУБД. ## Парный инструментальный навык EDT-MCP - Для проведения контролируемого замера производительности через профилировщик EDT-MCP применяй в паре [`edt-mcp-project-profiling`](../edt-mcp-project-profiling/SKILL.md).