1C-Code → Основы 1С → Язык запросов: читать данные пачками

Язык запросов: читать данные пачками

Как получать данные из базы одним обращением вместо перебора.

Глава 13 из 36 · чтение примерно 28 минут

Данные в 1С лежат в базе, и достать их можно двумя способами. Первый — перебирать объекты в коде. Второй — написать запрос и получить сразу нужное.

Разница не в стиле, а в количестве обращений к базе. Перебор тысячи товаров означает тысячу обращений, запрос — одно. На этом и строится вся оптимизация в 1С.

Простейший запрос

Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
|	Тов.Наименование КАК Товар,
|	Тов.Артикул КАК Артикул
|ИЗ
|	Справочник.Номенклатура КАК Тов
|ГДЕ
|	НЕ Тов.ЭтоГруппа
|УПОРЯДОЧИТЬ ПО
|	Товар";

Выборка = Запрос.Выполнить().Выгрузить();

Параметры

Значения не вставляют в текст запроса — их передают параметрами через &:

Запрос.Текст = "… ГДЕ Номенклатура.ГруппаТоваров = &Группа";
Запрос.УстановитьПараметр("Группа", "Метизы");

Так безопаснее и быстрее: база запоминает разобранный запрос и переиспользует его с разными значениями.

Сколько строк брать: ПЕРВЫЕ и УПОРЯДОЧИТЬ ПО

Две части запроса, которые почти всегда ходят парой, и именно поэтому их путают.

УПОРЯДОЧИТЬ ПО ставят в самом конце. Оно сортирует то, что получилось: УПОРЯДОЧИТЬ ПО Дата УБЫВ — сначала свежие. Без него порядок строк не определён: база вернёт их так, как ей удобнее, и сегодня это одно, а завтра другое.

ВЫБРАТЬ ПЕРВЫЕ 10 оставляет десять строк. Слово «первые» здесь означает «первые в том порядке, который вы задали». Никакого своего порядка у него нет.

РАЗЛИЧНЫЕ: откуда берутся дубли

ВЫБРАТЬ РАЗЛИЧНЫЕ убирает полностью одинаковые строки результата. Выглядит как удобная мелочь, а на деле это чаще всего признак, что в запросе что-то не так.

Настоящая причина дублей почти всегда одна — соединение, которое размножило строки. Спрятать их под РАЗЛИЧНЫЕ можно, но если рядом есть СУММА, она уже сложила лишнее, и итог завышен независимо от РАЗЛИЧНЫЕ.

Поэтому порядок такой: сначала понять, откуда взялась вторая строка, и только потом решать, нужны ли РАЗЛИЧНЫЕ. Законный случай тоже бывает — «список контрагентов, у которых были продажи»: там дубли по смыслу, и убрать их правильно.

Соединения

Данные обычно лежат в разных таблицах: товары в одной, продажи в другой. Соединение связывает их по общему полю.

Три вида соединений

// левое соединение превратилось во внутреннее
ЛЕВОЕ СОЕДИНЕНИЕ Продажи КАК Продажи
	ПО Продажи.Товар = Номенклатура.Ссылка
ГДЕ Продажи.Сумма > 1000        // ← товары без продаж исчезнут

// правильно: условие к присоединяемой таблице — в ПО
ЛЕВОЕ СОЕДИНЕНИЕ Продажи КАК Продажи
	ПО Продажи.Товар = Номенклатура.Ссылка
		И Продажи.Сумма > 1000

Группировка и агрегаты

Когда нужны итоги, а не отдельные строки, применяют группировку. Все поля, не попавшие под агрегатную функцию, обязаны быть в СГРУППИРОВАТЬ ПО.

ВЫБРАТЬ
	Продажи.Товар КАК Товар,
	СУММА(Продажи.Сумма) КАК Выручка,
	КОЛИЧЕСТВО(*) КАК Продаж
ИЗ
	Продажи КАК Продажи
СГРУППИРОВАТЬ ПО
	Продажи.Товар

Агрегаты: СУММА, КОЛИЧЕСТВО, МАКСИМУМ, МИНИМУМ, СРЕДНЕЕ. Все они игнорируют NULL — это иногда используют намеренно.

ГДЕ Продажи.Дата >= &Начало        // отбор строк до группировки
СГРУППИРОВАТЬ ПО Продажи.Товар
ИМЕЮЩИЕ СУММА(Продажи.Сумма) > 1000  // отбор групп после

ВЫБОР: условие прямо в запросе

Иногда значение колонки зависит от других значений: пометить документ крупным или обычным, подставить ноль вместо отрицательного, выбрать цену по типу.

Делать это в цикле после запроса можно, но незачем: у языка запросов есть ВЫБОР. Он читается вслух почти как предложение — «выбор: когда так, тогда это, иначе то, конец».

Выбор внутри запроса

ВЫБРАТЬ
	Номер,
	ВЫБОР
		КОГДА СуммаДокумента > 100000 ТОГДА "крупный"
		КОГДА СуммаДокумента > 50000 ТОГДА "средний"
		ИНАЧЕ "обычный"
	КОНЕЦ КАК Размер
ИЗ
	Документ.РеализацияТоваров

ОБЪЕДИНИТЬ и ОБЪЕДИНИТЬ ВСЕ

Соединение приставляет колонки сбоку. Объединение ставит строки друг под друга: продажи и возвраты одним списком, приход и расход одной лентой.

Требование к частям одно: одинаковое число колонок и совместимые типы. Имена колонок берутся из первой части — псевдонимы в остальных ни на что не влияют.

И вот различие, на котором ловят: ОБЪЕДИНИТЬ убирает одинаковые строки, ОБЪЕДИНИТЬ ВСЕ — оставляет все. Разница в цене тоже есть: чтобы убрать дубли, базе надо отсортировать весь результат.

Поэтому по умолчанию пишут ОБЪЕДИНИТЬ ВСЕ, а простое ОБЪЕДИНИТЬ — только когда дубли действительно надо убрать. Иначе две одинаковые по сумме продажи схлопнутся в одну, и отчёт недосчитается денег.

Виртуальные таблицы

У регистров есть таблицы, которых физически нет — платформа строит их из предрассчитанных итогов. Обращение к ним на порядки быстрее, чем подсчёт по движениям.

Основные виртуальные таблицы

Составные типы и ВЫРАЗИТЬ

Некоторые поля в 1С могут хранить ссылку разных видов. Самый частый — Регистратор в регистре: это документ, но какой именно — заранее неизвестно, там может быть и поступление, и реализация, и корректировка.

Через точку у такого поля доступны только те реквизиты, которые есть у всех возможных видов. Поэтому Регистратор.Контрагент обычно не работает: у части документов контрагента нет.

Решение — ВЫРАЗИТЬ: сказать запросу, какой именно вид вас интересует.

ВЫРАЗИТЬ(Регистратор КАК Документ.РеализацияТоваров).Контрагент — теперь поле доступно. У записей с другими документами там окажется NULL, и это правильно: у них такого реквизита и правда нет.

Второе применение — производительность. Обращение через точку к полю составного типа заставляет базу соединиться со всеми таблицами, которые туда помещаются. ВЫРАЗИТЬ оставляет одну.

Функции запроса, без которых не обойтись

// в запросе — дёшево
ВЫБРАТЬ Продажи.Товар.Артикул КАК Артикул

// в коде — обращение на каждой итерации
Для Каждого СтрокаФайла Из Строки Цикл
	Артикул = СтрокаФайла.Товар.Артикул;   // ← дорого
КонецЦикла;

Что делать с результатом

Результат = Запрос.Выполнить();

// таблицей значений — когда нужны все строки сразу
Таблица = Результат.Выгрузить();

// выборкой — когда идём по строкам один раз
Выборка = Результат.Выбрать();
Пока Выборка.Следующий() Цикл
	Сообщить(Выборка.Товар);
КонецЦикла;

// пустой ли результат
Если Результат.Пустой() Тогда

Разницы в скорости почти нет. Выгрузка удобнее, когда с данными надо работать несколько раз или передавать их дальше.

Как закрепить

Читать про код и писать код — разные умения. В тренажёре к этой главе идут упражнения: вы пишете решение, оно запускается на настоящем интерпретаторе 1С и проверяется сразу, без установки платформы.

Открыть эту главу в тренажёре

← Формы: клиент, сервер и управление элементами
→ Запросы в работе: как писать, что ломается, чем ускорять