Проекции, сортировка, лимиты

coll.Find(ctx, filter, opts...) принимает вариадик опций, а собираются они конструктором options.Find(): каждый Set-метод возвращает тот же билдер, поэтому настройки пишутся цепочкой в один вызов. Поля билдера — прямое отражение серверных опций команды find, и типы в них честные: SetLimit и SetSkip принимают int64, SetBatchSize — int32, SetProjection и SetSort — any, потому что там уезжают документы. Рядом живут и настройки реже: SetCollation задаёт правила сравнения строк — с ней сортировка по имени идёт по правилам языка, а не по кодам символов; SetComment помечает запрос в логах и профайлере сервера — та же метка, что у delete-вызовов одиннадцатого урока. Пустой билдер равен отсутствию опций: сервер вернёт все совпавшие документы целиком в естественном порядке. Опции работают поверх фильтра из восьмого и четырнадцатого уроков: сначала база отбирает совпавшие документы, потом сортирует их, отсекает skip, отдаёт limit и проецирует поля — читать эти этапы полезно именно в таком порядке, потому что так их исполняет сервер. Опции Find и FindOne — разные семейства (FindOptions и FindOneOptions), но базовые настройки у них общие: у FindOne есть свои SetSort, SetProjection и SetSkip, поэтому «самый дорогой товар» берётся FindOne с SetSort по цене убывания. Чего у FindOne нет — SetLimit и SetBatchSize: одиночному документу лимит не нужен, сервер и так вернёт максимум один.

SetSort принимает документ вида {поле: направление}, где 1 — по возрастанию, -1 — по убыванию. Составная сортировка пишется списком пар: цена по возрастанию, внутри равных цен — новизна сверху: bson.D{{Key: "price", Value: 1}, {Key: "created_at", Value: -1}}. Здесь и живёт главное правило урока: Sort — упорядоченный аргумент, и мультиключевую bson.M в него передать нельзя. Драйвер проверяет это до отправки: SetSort(bson.M{"price": 1, "name": -1}) вернёт ErrMapForOrderedArgument с текстом multi-key map passed in for ordered parameter sort. Причина в природе карт: обход map в Go не упорядочен, и «price до name» или наоборот драйвер выбрать не может — а от порядка полей зависит результат сортировки равных значений. Проверка стоит в collection.go рядом с marshal аргумента, и это одна из тех клиентских ошибок, которые экономят час отладки. Всё, что упорядочено по смыслу — сортировки, подсказки индексов, конвейеры, — пишите через bson.D; карты остаются для фильтров, где порядок не играет роли. Проверка стоит не только в Find: FindOne с картой-сортировкой вернёт *SingleResult с той же готовой ошибкой до похода в сеть — добраться до неё можно уже методом Err, без Decode. Зато карта с одним ключом легальна: ограничение срабатывает только на две и более пары — драйвер не может упорядочить то, что сам не упорядочивает.

Проекция — документ, который говорит серверу, какие поля включить в ответ: bson.M{"name": 1, "price": 1} вернёт только эти два поля. Проекции в mongo из Go живут в SetProjection, и у них два режима. Режим включения: перечисляете поля с 1 — сервер отдаст их и _id, который добавляется по умолчанию; отключить его можно отдельно — bson.M{"name": 1, "_id": 0}. Режим исключения: перечисляете поля с 0 — вернутся все остальные; так отрезают тяжёлое описание от карточки: bson.M{"description": 0}. Смешивать включения и исключения нельзя — сервер вернёт ошибку, единственное исключение из правила и есть _id. Путь заходит и во вложенные документы: {"specs.color": 1} достанет цвет из specs, не трогая остальные характеристики. Для массивов есть отдельный оператор $slice: {"comments": {"$slice": 3}} отдаст максимум три первых элемента массива в каждом документе — проекция умеет не только брать и бросать, но и резать объём. Практическая выгода двойная: меньше сетевого трафика и меньше работы декодера — непроектированные поля даже не распаковываются. Но есть и цена: структура при декодировании получит нули там, где поля нет, — и это следующий коллаут.

SetLimit(10) обрезает выдачу до десяти документов, SetSkip(20) пропускает первые двадцать совпавших — вместе это привычная пагинация: страница N начинается с skip = (N-1) * размер, размер задаёт лимит. Пара тонкостей делает пару честной. Первая: без SetSort лимит отдаст «какие-то десять» — сервер не обещает порядок без сортировки, и на разных запросах состав страницы может отличаться; лимит всегда ходит в паре с сортировкой. Типы аргументов напоминают о себе на переменных: SetLimit и SetSkip принимают int64 — литерал 20 компилятор приведёт сам, а переменную int придётся конвертировать явным int64(page); нормальная плата за честные типы в опциях. Вторая: по докам драйвера отрицательный лимит означает «вернуть документы в одном батче» — экзотика для отладки, в обычном коде не встречается. Третья — цена skip: серверу нужно пройтись и отбросить все пропускаемые документы, поэтому страница 500 по 20 позиций стоит заметно дороже первой; для глубоких листаний лучше диапазон по _id из двенадцатого урока. А ещё лимит — инструмент стоимости: «топ-10 по цене» — это сортировка плюс SetLimit(10), и десять документов сервер и не будет отправлять.

Декодирование в структуру уже фильтрует результат: поля документа, которых нет в структуре, просто игнорируются — эта механика была в пятом уроке. Возникает законный вопрос: зачем проекция, если структура и так отрежет лишнее. Ответ — в том, где происходит работа. Без проекции сервер отправляет полные документы по сети, и только декодер выбрасывает поля: трафик потрачен, батчи курсора распухли, а тяжёлое описание распаковалось, чтобы умереть в мусоре. С проекцией отбрасывание происходит до отправки: меньше байт, быстрее батчи, ниже нагрузка на декодер. Узкая структура — зеркало того же приёма в обратную сторону: отдельный тип с пятью полями для ленты и полный тип для карточки делают код честнее, чем один жирный Product на все случаи. В паре они дают максимум: узкая структура описывает форму выдачи, проекция обещает серверу, что остальное можно не отправлять. Узкая структура ещё и тестируется дешевле: функция ленты принимает и возвращает пять полей, и тестовый литерал не тащит двадцать. Что выбирать при bson.M-результатах — проекция единственная защита от перекачки данных.