MongoDB: документ,
BSON и первая коллекция
hh.resumesнажмите любую клавишу, чтобы начать ▸
Справка · типы, которые встретятся сегодня
| Тип | № | Где в нашей коллекции |
|---|---|---|
| String | 2 | fio, city, position — текст в двойных кавычках |
| Object | 3 | education, contacts — вложенный документ |
| Array | 4 | skills, experience — список значений или объектов |
| ObjectId | 7 | _id — идентификатор, который база ставит сама |
| Boolean | 8 | ready_to_move — true или false |
| Date | 9 | updated — момент времени, а не строка с датой |
| Null | 10 | поле есть, но значения нет — это не то же, что поля нет вовсе |
| 32-bit integer | 16 | salary, year, months — целые числа |
Тип важен не сам по себе, а потому что от него зависит сравнение. Запрос { salary: { $gt: 100000 } } найдёт числа и пропустит строку "120000", даже если она выглядит как число. Это самая частая причина «запрос ничего не вернул, хотя данные есть».
Шаг 1 из 5 · скачивание
macOS arm64, обычный ноутбук на Windows — Windows 64-bit.Шаг 2 из 5 · подключение
mongodb://localhost:27017
Строка подключения разбирается на четыре части, и каждая отвечает за своё.
mongodb://Схема: по ней клиент понимает, каким протоколом говорить. У облачного Atlas схема другая — mongodb+srv://.localhostАдрес сервера. Контейнер пробросил порт на нашу же машину, поэтому адрес локальный.27017Порт MongoDB по умолчанию. Если сервер занятия слушает другой порт, пишем в строке его — остальное в ней не меняется.Логина и пароля в строке нет: сервер поднят без проверки подлинности. Для учебного стенда на своей машине это допустимо, и мы к этому вернёмся в разделе о защите — там пустой пароль станет отдельной темой разговора.
Отказ · читаем сообщение целиком
ECONNREFUSED — и это хорошая новость
Соединение отклонено на уровне операционной системы: по адресу 127.0.0.1:27017 никто не отвечает. То есть Compass дошёл до нужной машины, но программы на порту нет.
Строка подключения тут ни при чём: её Compass разобрал и дошёл до адреса. Проверяем, работает ли сам сервер, и подключаемся заново. У нас на паре так и вышло: сервер остановился, пока мы читали теорию.
ECONNREFUSED — сервер не запущен. Server selection timed out — адрес недоступен, чаще всего опечатка в имени хоста. Authentication failed — сервер есть, но не пускает: неверные логин или пароль.
Шаг 3 из 5 · подключились
adminСлужебная база сервера: пользователи, роли, административные команды. Своих данных мы туда не кладём.configНастройки самого сервера. Нужна, когда база разложена по нескольким узлам.localДанные, которые не уезжают на другие узлы: журнал операций и внутренние отметки.Шаг 4 из 5 · база и коллекция
hh и коллекция resumes создаются одним окном
Compass не даёт создать базу без коллекции — и это не каприз интерфейса, а свойство сервера.
«If a collection does not exist, MongoDB creates the collection when you first store data for that collection.»
MongoDB Manual · Databases and CollectionsТо есть база живёт ровно до тех пор, пока в ней что-то лежит. Пустая база, из которой удалили последнюю коллекцию, исчезает из списка сама.
Как называем. Имя базы — по системе, а не по студенту: hh, а не test2. Имя коллекции — во множественном числе и латиницей: resumes. Это соглашение, а не требование сервера, но именно оно потом бережёт время на review.
Разбор интерфейса · пустая коллекция
1
2
3
4
5
Шаг 5 из 5 · первый документ
{} — редактор JSONНачинаем с маленького документа: пять полей, ни одного вложенного объекта. Так проще увидеть, что происходит после вставки.
{
"fio": "Анна Белова",
"position": "Junior Python-разработчик",
"city": "Ярославль",
"salary": 65000,
"skills": ["Python", "Git"]
}
Обратите внимание на 65000 без кавычек: мы кладём число, а не строку. Через десять минут именно от этого будет зависеть, найдёт ли резюме запрос со сравнением.
Результат · документ в коллекции
_id база поставила сама
_id: ObjectId('6a9e467a…')Мы его не писали. Раз поле не передали — сервер подставил ObjectId, и по нему теперь можно узнать время вставки.skills: Array (2)Compass не разворачивает массив сразу, а показывает тип и длину. Треугольник слева раскрывает содержимое.65000 зелёным, вы сразу поймёте, что число сохранилось строкой.skills и убедитесь, что элементы нумеруются с нуля — 0: "Python", 1: "Git". Индекс элемента понадобится нам в запросах.Готовые данные · загрузка файла
stend/seed/resumes.json из репозитория занятия. Внутри — массив из восьми документов.{"$date": "2026-09-03T14:40:00Z"}, поэтому они попадут в базу типом Date, а не строкой.1 – 9 of 9: наш документ плюс восемь загруженных.Файл лежит в репозитории неспроста: у всей группы одинаковые данные, поэтому и результаты запросов у всех совпадут. Если счётчик показал не девять — импорт прошёл дважды, и коллекцию нужно очистить и повторить.
Что видно на девяти документах
_id ObjectId, fio String, salary Int32education и updated
Мы вставили её первой, с пятью полями. Сервер не возразил: коллекция ничего не требует.
portfolio, которого нет у остальных
Поле появилось только там, где оно осмысленно. В таблице для этого понадобился бы столбец со значением NULL у всех прочих.
experience — пустой массив, зато есть courses
Опыта нет, но есть курсы. Форма документа отражает жизнь человека, а не общий шаблон.
У этой свободы есть обратная сторона: пока форму никто не проверяет, в коллекцию так же спокойно ляжет резюме с полем salaryy или зарплатой строкой. Проверки мы включим на занятии 3, когда разберём schema validation.
Граница агрегата · один документ целиком
Здесь видно, ради чего всё затевалось. Одним обращением база отдала то, что в реляционной схеме лежало в шести таблицах.
education — объектУровень, учебное заведение и год лежат внутри резюме. Отдельно от человека они не нужны.experience — массив объектовДва места работы, у каждого свой stack — массив внутри объекта внутри массива.updated — ISODateCompass показывает и машинное значение, и человеческое: «September 3, 2026 at 2:40:00 PM UTC».Запрос 1 из 5 · точное совпадение
{ city: "Ярославль" } — 5 документов из 9
Самая частая форма запроса и самая частая причина пустого результата.
$regex, и он работает медленнее.{ salary: 65000 } не найдёт документ, где зарплата сохранена строкой "65000". Число и строка — разные значения.Запросы 2 и 3 из 5 · вглубь документа
{ "education.level": "СПО" } → 4 документа
{ skills: "MongoDB" } → 2 документаЗапись "education.level" означает «поле level внутри объекта education». Кавычки нужны, потому что точка внутри имени иначе читается как обращение к свойству. Глубина не ограничена: "experience.0.stack" добирается до стека первого места работы.
{ skills: "MongoDB" } читается не как «массив равен строке», а как «среди элементов массива есть такой». Ни $in, ни индекс элемента для этого не нужны — и это, пожалуй, самое неожиданное правило для того, кто пришёл из SQL.
Запрос 4 из 5 · сравнение, сортировка, проекция
{ salary: { $gt: 100000 } }Оператор $gt — строго больше. Есть и $gte, $lt, $lte, $ne.{ fio: 1, salary: 1, _id: 0 }Единица — «показать поле», ноль — «убрать». Поле _id возвращается всегда, если его не выключить явно.{ salary: -1 }Минус единица — по убыванию, единица — по возрастанию. Самойлов со 150 000 оказывается первым.Проекция — это не украшение. Она уменьшает то, что сервер собирает и передаёт по сети, и на больших документах разница заметна. Когда мы дойдём до производительности, это будет первым, что мы проверяем в медленном запросе.
Запрос 5 из 5 · есть ли поле
{ portfolio: { $exists: true } } — вопрос, которого нет в SQL
portfolioВ таблице столбец есть у всех строк, вопрос стоит иначе: пустое значение или нет. В коллекции поле может просто отсутствовать, и это третье состояние.
{ portfolio: { $exists: false } }
Семь резюме, где ссылки на портфолио никто не заполнял.
{ portfolio: null }
Осторожно: этот фильтр находит и документы, где поля нет вовсе. Чтобы разделить два случая, условия придётся соединить.
$exists — рабочий инструмент, когда коллекция копилась годами и форма документов менялась. Он же первым показывает, что схема в коде и схема в базе разошлись.
Отказ · разбор ошибки
{ city: Ярославль } — рамка красная, Find недоступнаCompass разбирает фильтр у себя, и Ярославль без кавычек для него — имя переменной, а не строка. Разбор не удался, поэтому кнопка отключилась, а список документов остался прежним.
Если фильтр разобрался, но ничего не нашёл, счётчик покажет 0 – 0 of 0, а рамка останется обычной. Красная рамка означает ошибку записи, пустой список — ошибку в данных или в условии.
Строка 1 – 5 of 5 — единственное честное подтверждение, что запрос выполнен и вернул именно столько. Скриншот со счётчиком мы и просим приложить к работе.
Две вкладки, которые пригодятся дальше
_id_, его создал серверCompass берёт выборку документов и показывает, какие поля встречаются, каких типов и как распределены значения. У city сразу видно, что Ярославль занимает большую часть, а у courses — что поле есть далеко не везде. Это отчёт по факту, а не описание схемы: сервер такой схемы не хранит.
Индекс _id_ сервер создаёт вместе с коллекцией, и удалить его нельзя. Все наши сегодняшние запросы шли без индексов — на девяти документах это незаметно. На занятии 4 мы посмотрим тот же запрос на выборке побольше и научимся читать план его выполнения.
Итог занятия
За 90 минут мы прошли путь от пустого Compass до коллекции с данными и запросами: поставили клиент, подключились к серверу, создали базу, положили документ, нашли его пятью способами и посмотрели, что бывает, когда фильтр записан неверно.
Дальше по разделу: занятие 2 — вложение против ссылки и первое ADR; занятие 3 — проверка формы документа средствами базы; занятие 4 — индексы и план запроса; занятие 5 — агрегация и повторяемая миграция документов.
Домашнее задание · к следующему занятию
Возьмите не резюме, а что-то из своего проекта: карточку заказа, тикет, объявление. Спроектируйте документ и положите в новую коллекцию пять таких документов. Хотя бы у двух форма должна отличаться — лишнее поле или отсутствующее.
К своей коллекции соберите те же пять видов фильтров: точное совпадение, вложенное поле, элемент массива, сравнение и $exists. Шестым запишите намеренно неверный и объясните, ошибка это разбора или пустой результат.
Опишите, что в вашем документе продублировано и во что обойдётся изменение этого значения. Без формулировок из документации: своими словами и на своих данных.
МДК.04.01 · Технология разработки и защиты баз данных · 4 курс
Занятие 1 — MongoDB: документ, BSON и первая коллекция
Максим Николаевич не хочет задавать вам домашнее задание. Но очень хочет.
$exists. Для каждого запишите сам фильтр и число найденных документов.Числа в queries.md сверяются с вашей коллекцией на приёмке. Скриншот без живой коллекции не принимается: со следующего занятия мы дописываем в эту же базу.
| Что сдаём | Папка lesson-01/: README.md, queries.md, файл данных seed.json и скриншот коллекции со счётчиком найденных документов. |
|---|---|
| Ветка и PR | Ветка hw-01, коммит с содержательным сообщением, затем Pull Request в свою main с коротким описанием: какая предметная область и чем отличаются формы документов. Merge делаете сами после проверки. |
| Срок | До начала занятия 2. После срока работа принимается, но разбирается в чате, а не на паре. |
| Про ИИ | Модель можно просить причесать формулировки и оформить .md — я сам так делаю всегда, поэтому и вам запрещать не буду. Запросы при этом должны быть выполнены в вашей коллекции. |
Файлы занятия — в папке lessons/02-mongodb-pervyy-dokument/stend/. Разбор запросов — в презентации занятия, экран 29. Вопросы по заданию — на паре или в чате группы.