Базы курса:
скачать и загрузить

Категория

Подготовка рабочего места

Уровень

Начальный

Связанные темы

1.1 Сервер, база, коллекция · 1.1а Стенд в Docker

Зачем это знать

Чтобы примеры из глав давали у вас те же числа, что в книге

github.com/MaximBytecamp/mongodb-practice → stend/seed

§1Какие базы нужны

На сервере должно оказаться пять баз и двенадцать коллекций. Четыре базы — эталонные: на них построены все примеры, и менять их нельзя. Пятая, sandbox, — песочница: в ней делают упражнения, вставляют, обновляют и удаляют.

Числа в третьей колонке пригодятся в §8: по ним проверяют, что загрузка прошла целиком.

§2Файлы с данными

Данные лежат в папке stend/seed репозитория практик: по одному JSON-файлу на коллекцию. Там же скрипт generate.py, который эти файлы собирает. Запускать его не нужно: файлы уже готовы, и у всех они одинаковые.

Имя каждого файла говорит, куда его загружать:

Внутри файла — массив документов в квадратных скобках. Так начинается shop.products.json:

[
 {
  "_id": "p-001",
  "sku": "SKU-NB-001",
  "title": "Ноутбук Lenovo IdeaPad 3",
  "brand": "Lenovo",
  "category": "ноутбуки",
  "price": 42990,
  "specs": ["15.6\"", "8 ГБ", "SSD 512 ГБ"],
  "stock": [{ "warehouse": "Санкт-Петербург", "qty": 5 }],
  "rating": 4.2,
  "reviews": 57,
  "added": { "$date": "2026-02-05T00:00:00.000Z" }
 },
 …

Дата в этих файлах записана особым образом. В обычном JSON нет типа «дата», поэтому она записана особым объектом { "$date": "…" } — это формат Extended JSON. И mongoimport, и Compass понимают его и сохраняют поле как настоящую дату, а не как вложенный документ. Если открыть файл и «поправить» такую запись руками, в базе окажется уже не дата, и запросы по времени из следующих глав перестанут работать.

§3Скачать репозиторий

Скачивается весь репозиторий: кроме данных, в нём скрипты загрузки, стенд для Docker и практические работы. Если установлен Git — одной командой:

git clone https://github.com/MaximBytecamp/mongodb-practice.git
cd mongodb-practice

Без Git — архивом. На странице репозитория нажмите зелёную кнопку Code и в конце меню — Download ZIP:

Архив называется mongodb-practice-main.zip. Распакуйте его и перейдите в папку:

cd $HOME\Downloads\mongodb-practice-main\mongodb-practice-main
ls stend\seed               # двенадцать .json и generate.py

cd ~/Downloads/mongodb-practice-main
ls stend/seed               # двенадцать .json и generate.py

cd ~/Downloads
unzip mongodb-practice-main.zip
cd mongodb-practice-main
ls stend/seed               # двенадцать .json и generate.py

Дальше все команды выполняются из этой папки — корня репозитория.

§4Какой способ загрузки выбрать

Результат у всех трёх одинаковый. Скрипт и Docker удобнее ещё и тем, что их можно повторить в любой момент — когда данные в песочнице разъедутся после упражнений.

§5Способ 1. Docker

Если стенд запускается в Docker, отдельно загружать ничего не нужно. При первом docker compose up -d сервис seed видит пустой сервер и сам заливает все файлы из stend/seed:

docker compose up -d
docker compose logs seed

hh.companies           <- hh.companies.json
hh.interviews          <- hh.interviews.json
hh.resumes             <- hh.resumes.json
hh.vacancies           <- hh.vacancies.json
logs.events            <- logs.events.json
org.categories         <- org.categories.json
org.employees          <- org.employees.json
sandbox.products       <- sandbox.products.json
sandbox.warehouse      <- sandbox.warehouse.json
shop.customers         <- shop.customers.json
shop.orders            <- shop.orders.json
shop.products          <- shop.products.json
Готово: базы курса загружены

Вернуть базы в исходное состояние — docker compose run --rm reset. Как поставить Docker и что делать при ошибках, разобрано в главе 1.1а.

§6Способ 2. Скрипт с mongoimport

mongoimport — консольная утилита MongoDB: читает JSON-файл и записывает документы в указанную коллекцию. Она входит в набор MongoDB Command Line Database Tools и ставится отдельно от сервера:

Загружать двенадцать файлов по одному не нужно: в папке stend лежат скрипты, которые проходят по всем файлам и берут имена базы и коллекции из имени файла.

powershell -ExecutionPolicy Bypass -File stend\load.ps1
# другой адрес сервера:
powershell -ExecutionPolicy Bypass -File stend\load.ps1 -Uri mongodb://localhost:27018

hh.companies           <- hh.companies.json
hh.interviews          <- hh.interviews.json
hh.resumes             <- hh.resumes.json
hh.vacancies           <- hh.vacancies.json
logs.events            <- logs.events.json
org.categories         <- org.categories.json
org.employees          <- org.employees.json
sandbox.products       <- sandbox.products.json
sandbox.warehouse      <- sandbox.warehouse.json
shop.customers         <- shop.customers.json
shop.orders            <- shop.orders.json
shop.products          <- shop.products.json

Готово. Проверка в Compass: база shop, коллекция orders — 120 документов.

Флаг -ExecutionPolicy Bypass разрешает запустить этот скрипт один раз, не меняя настроек Windows: без него PowerShell по умолчанию отказывается выполнять файлы .ps1.

bash stend/load.sh
# другой адрес сервера:
MONGO_URI=mongodb://localhost:27018 bash stend/load.sh

mongoimport не найден локально — работаем через контейнер course-mongo
hh.companies           ← hh.companies.json
hh.interviews          ← hh.interviews.json
hh.resumes             ← hh.resumes.json
hh.vacancies           ← hh.vacancies.json
logs.events            ← logs.events.json
org.categories         ← org.categories.json
org.employees          ← org.employees.json
sandbox.products       ← sandbox.products.json
sandbox.warehouse      ← sandbox.warehouse.json
shop.customers         ← shop.customers.json
shop.orders            ← shop.orders.json
shop.products          ← shop.products.json

Готово. Проверка:
  mongosh "mongodb://localhost:27017" --quiet --eval 'db.getSiblingDB("shop").orders.countDocuments()'   # 120

Первая строка появилась потому, что кадр снят на компьютере без mongoimport: load.sh в таком случае сам берёт утилиту из запущенного контейнера со стендом. Если mongoimport установлен, этой строки не будет, а остальной вывод совпадёт.

Внутри скрипта для каждого файла выполняется одна и та же команда. Этой же командой перезагружают одну коллекцию:

mongoimport --db shop --collection orders --file stend\seed\shop.orders.json --jsonArray --drop

mongoimport --db shop --collection orders --file stend/seed/shop.orders.json --jsonArray --drop

Адрес сервера не указан — mongoimport по умолчанию подключается к mongodb://localhost:27017. Другой задаётся флагом --uri.

§7Способ 3. Вручную через Compass

Если нет ни Docker, ни mongoimport, но сервер и Compass работают, файлы загружаются мышью. На кадрах ниже — пустой сервер, на который загружаем первую коллекцию, shop.products.

1. Подключитесь к серверуОткройте подключение к mongodb://localhost:27017. Если баз курса ещё нет, в списке только три служебные: admin, config, local.

2. Создайте базу и первую коллекциюКнопка Create database справа вверху. В поле Database Name — имя базы из файла, в Collection Name — имя коллекции. Для shop.products.json это shop и products. Compass не создаёт пустую базу без коллекции, поэтому оба поля обязательны. Галочку Time-Series не ставьте.

3. Откройте импортОткройте новую коллекцию: щёлкните по products под базой shop в левой панели. Коллекция пустая — нажмите Add data → Import JSON or CSV file или кнопку Import data посередине.

4. Выберите файлОткроется окно выбора файла вашей системы. Найдите в папке репозитория stend/seed/shop.products.json. Проверьте строку To collection: коллекция должна совпадать с именем файла. Stop on errors можно не отмечать.

5. Нажмите ImportВнизу слева появится сообщение Import completed. 21 documents imported., а в коллекции — 21 документ.

Посмотрите на поле added на кадре: Compass показывает его свёрнутым, и внутри уже дата, а не объект с $date. Это и есть работа Extended JSON из §2.

Остальные одиннадцать файлов загружаются так же. Если база уже есть, создавать её заново не нужно: наведите на неё в левой панели, нажмите + и создайте только коллекцию.

§8Проверить, что всё загрузилось

После любого способа нажмите в Compass Refresh в списке баз. Должно быть восемь строк: пять баз курса и три служебные.

Надёжнее сверить число документов в каждой коллекции с таблицей из §1. Для этого не нужен установленный mongosh: в Compass есть встроенная оболочка — кнопка Open MongoDB shell над списком баз. Вставьте туда одну строку:

for (const d of ['shop','hh','logs','org','sandbox']) for (const c of db.getSiblingDB(d).getCollectionNames().sort()) print(d + '.' + c + ' ' + db.getSiblingDB(d)[c].countDocuments())

shop.customers 20
shop.orders 120
shop.products 21
hh.companies 8
hh.interviews 60
hh.resumes 9
hh.vacancies 8
logs.events 1200
org.categories 10
org.employees 15
sandbox.products 21
sandbox.warehouse 21

Текст склеивается в одну строку внутри print потому, что встроенная оболочка Compass печатает каждый аргумент print с новой строки, и вызов print(имя, число) там выдал бы двадцать четыре строки вместо двенадцати.

Двенадцать строк, и числа совпадают с таблицей — данные на месте, можно переходить к главе 1.1. Не хватает строки — коллекцию забыли или назвали иначе. Если вы уже проходили главы 1.6–1.7, в sandbox будут ещё bench, orders и product_stats — их создают заготовки этих глав, это нормально. Число больше ожидаемого — файл загрузили дважды, коллекцию нужно удалить и загрузить снова.

§9Рабочее место: драйвер и первый запуск

Данные на месте. Осталось подготовить то, чем вы будете к ним обращаться: драйвер своего языка и папку, где лежат заготовки примеров. Язык выбирается кнопкой «драйвер» вверху страницы, система — кнопкой «система»: команды ниже меняются вместе с ними.

В скачанном репозитории всё уже разложено по папкам:

Шаг 1. Поставить драйвер

Команды выполняются в терминале из корня репозитория — из папки mongodb-practice.

python -m pip install pymongo

Если PowerShell отвечает, что python не найден, поставьте Python с python.org и отметьте в установщике Add python.exe to PATH, затем откройте новый терминал.

python3 -m venv .venv
source .venv/bin/activate
pip install pymongo

Виртуальное окружение .venv — отдельная папка с Python и драйвером только для этого репозитория: системный Python на macOS и в свежих Linux не даёт ставить пакеты напрямую. В каждом новом терминале окружение включается снова: source .venv/bin/activate. Если venv не найден — sudo apt install python3-venv.

gem install mongo

Ruby ставится с rubyinstaller.org — сборка with Devkit: драйверу нужен компилятор для расширения bson.

gem install --user-install mongo

sudo apt install ruby-full build-essential
gem install --user-install mongo

cd lessons
go mod download

Go ставится с go.dev/dl. Отдельно драйвер ставить не нужно: в папке lessons уже лежит go.mod, и go mod download скачивает всё, что в нём перечислено.

brew install mongo-cxx-driver

docker compose run --rm cpp hello/hello.cpp

Драйвер C++ на Windows и Linux собирается из исходников долго и с зависимостями. Проще запускать код в готовом контейнере стенда — глава 1.1а: первая сборка образа занимает несколько минут, дальше запуск занимает несколько секунд.

Шаг 2. Проверить подключение

В папке hello лежит программа, которая подключается к серверу и печатает, что на нём есть. Если она отработала — драйвер стоит и данные на месте.

python hello/hello.py

python3 hello/hello.py

ruby hello/hello.rb

cd hello
go run hello.go

g++ -std=c++17 hello/hello.cpp -o hello/hello $(pkg-config --cflags --libs libmongocxx1)
./hello/hello

docker compose run --rm cpp hello/hello.cpp

Адрес: mongodb://localhost:27017/
Сервер: 7.0.40
Базы данных: ['admin', 'config', 'hh', 'local', 'logs', 'org', 'sandbox', 'shop']
Коллекции shop: ['customers', 'orders', 'products']
Товаров: 21
Заказов: 120

Адрес: mongodb://localhost:27017
Сервер: 7.0.40
Базы данных: admin config hh local logs org sandbox shop
Коллекции shop: customers orders products
Товаров: 21
Заказов: 120

Адрес: mongodb://localhost:27017
Сервер: 7.0.40
Базы данных: [admin config hh local logs org sandbox shop]
Коллекции shop: [customers orders products]
Товаров: 21
Заказов: 120

Адрес: mongodb://localhost:27017/
Сервер: 7.0.40
Базы данных: ["admin", "config", "hh", "local", "logs", "org", "sandbox", "shop"]
Коллекции shop: ["customers", "orders", "products"]
Товаров: 21
Заказов: 120

Не ставится ничего — запускайте в Docker: docker compose run --rm python hello/hello.py (вместо python — ruby, go или cpp и файл с тем же расширением).

Числа в двух последних строках — те же, что в таблице из §1. Ошибка вместо вывода разобрана в §11.

§10Как запускать примеры из глав

Для каждой главы с кодом в папке lessons есть файл-заготовка: ch1_4.py для главы 1.4 на Python, ch1_4.go — на Go и так далее. В заготовке уже есть подключение и переменные, которыми пользуются примеры главы: client, db, products, orders и box — песочница. Пример из главы вставляется в отмеченное место:

Пример, который начинается с func или type, ставится выше main — у отметки «функции и типы из примеров главы». Всё остальное — внутрь фигурных скобок в конце main, вместо проверочных строк.

Пример, который объявляет функцию, ставится выше main — у отметки «функции из примеров главы». Всё остальное — внутрь фигурных скобок в конце main, вместо проверочных строк.

Под отметкой стоят проверочные строки: пока пример не вставлен, заготовка только проверяет связь с сервером. Её можно запустить сразу — командой из шага 3 ниже — и убедиться, что всё работает:

Заготовка главы 1.4 подключилась к серверу. Замените проверочные строки примером из главы.

Если вместо этой строки — ошибка, связи с сервером нет: разбор в §11.

1. Проверьте состояние базВ начале каждой главы написано, меняет ли она данные. Если меняет — перед главой верните базы в исходное состояние, как в §8: docker compose run --rm reset или скрипт из §6.
2. Вставьте примерСкопируйте пример из главы в отмеченное место заготовки вместо проверочных строк. Следующий пример вставляйте вместо предыдущего, а не под ним: иначе при повторном запуске предыдущий выполнится ещё раз.
3. Запустите из папки lessonsКаждый пример — один раз и по порядку. Так получены все выводы в справочнике, поэтому ваш вывод совпадёт с книгой. Отличаться будут только _id, которые выдаёт сервер, текущее время и последняя цифра версии сервера: образ mongo:7 обновляется, в книге — 7.0.40. В Ruby 3.4 и новее хэш печатается с пробелами вокруг стрелки: {"price" => 42990}, в книге — формат Ruby 3.3, {"price"=>42990}. Необработанное исключение C++ на macOS выглядит иначе, чем в книге: libc++abi: terminating due to uncaught exception of type std::runtime_error: … вместо двух строк terminate called … и what(): ….

cd lessons
python ch1_4.py

cd lessons
python3 ch1_4.py

cd lessons
ruby ch1_4.rb

cd lessons
go run ch1_4.go

cd lessons
g++ -std=c++17 ch1_4.cpp -o ch1_4 $(pkg-config --cflags --libs libmongocxx1)
./ch1_4

docker compose run --rm cpp lessons/ch1_4.cpp

В Docker пример запускается той же командой, что hello: docker compose run --rm python lessons/ch1_4.py. Контейнер сам переходит в папку файла, поэтому пути вида ../stend/seed/… в примерах работают одинаково.

Так выглядит первый пример главы 1.4 — «один документ», вставленный в заготовку и запущенный:

Смартфон Xiaomi Redmi Note 13 18990

Смартфон Xiaomi Redmi Note 13

Смартфон Xiaomi Redmi Note 13 18990

Смартфон Xiaomi Redmi Note 13 18990

Так это выглядит в редакторе: заготовка, пример на своём месте и запуск в терминале из папки lessons.

§11Частые ошибки

§12Проверьте себя

§13Шпаргалка

Итог главы

Данные курса — двенадцать JSON-файлов в stend/seed репозитория практик; имя файла задаёт базу и коллекцию. Загрузить их можно Docker-стендом, скриптом с mongoimport или вручную через Compass — результат одинаковый, и проверяется он числом документов в каждой коллекции. Когда числа сошлись, переходим к главе 1.1: что такое сервер, база и коллекция и как до них дойти из кода.