Інсталяція та керування базою даних MongoDB у ServBay

MongoDB — це провідна документ-орієнтована NoSQL база даних, відома своєю гнучкістю, потужними можливостями запитів і горизонтальною масштабованістю. Саме тому вона є популярною серед сучасних розробників. ServBay пропонує розробникам на macOS унікально інтегроване середовище, що надзвичайно спрощує інсталяцію, налаштування та керування кількома версіями MongoDB, а також надає повний набір ключових командних інструментів для створення цілісної та ефективної локальної розробної станції.

Огляд: Чому використовувати MongoDB у ServBay?

ServBay — це не просто запускатор, це повноцінний менеджер середовища розробки. Для MongoDB це означає:

Співіснування й перемикання версій: Ви можете встановлювати та запускати кілька різних версій MongoDB (наприклад, 5.0, 6.0, 7.0) у один клік, легко перемикатися між ними відповідно до вимог проєкту, не турбуючись про конфлікти середовища.
Графічне налаштування: Більше жодного редагування конфігураційних файлів вручну. У графічному інтерфейсі ServBay ви інтуїтивно задаєте порт, IP, директорію даних та інші ключові налаштування MongoDB.
Інтегрований комплект інструментів: ServBay автоматично встановлює офіційні MongoDB Shell (mongosh) та MongoDB Database Tools. Ви одразу маєте доступ до таких важливих утиліт, як mongostat, mongotop, mongodump та mongorestore.

Цей гід проведе вас від основ до експертного рівня: від інсталяції, налаштування, інтерактивного керування, моніторингу продуктивності до резервного копіювання та відновлення даних.

1. Інсталяція й налаштування сервісу MongoDB

Крок 1: Встановлення пакету MongoDB

Перше, що потрібно зробити — це інсталювати MongoDB через ServBay:

Відкрийте додаток ServBay.
У лівому меню оберіть Пакети (Packages).
У списку пакетів перегорніть до розділу Databases і знайдіть частину MongoDB.
Оберіть необхідну версію MongoDB для свого проєкту (наприклад, MongoDB 7.0) і натисніть кнопку встановлення справа. ServBay автоматично завантажить і встановить вибрану версію.

Крок 2: Детальне налаштування сервісу MongoDB

Після інсталяції ви можете гнучко налаштувати сервіс MongoDB:

У лівому меню виберіть Databases → MongoDB → вашу щойно встановлену версію (наприклад, MongoDB 7.0).
У цьому вікні можна змінити такі ключові параметри:
- Bind IP (прив’язка IP): Вказує IP-адресу, на якій MongoDB слухає підключення. Значення за замовчуванням — 127.0.0.1, ::1 — це найбезпечніше для локальної розробки, оскільки дозволяє підключення тільки з вашого комп’ютера.
- Bind Port (прив’язка порту): Порт для підключення до бази даних. Стандартний порт для MongoDB — 27017. Рекомендується залишити це значення без змін, якщо немає особливих причин.
- Socket: Шлях до Unix-сокет-файлу. Для локальних підключень використання сокета ефективніше, оскільки оминає мережевий стек.
- Data dir (директорія даних): Локальний шлях, де MongoDB збереже всі файли бази даних (колекції, індекси тощо). ServBay встановить оптимальне значення за замовчуванням, але ви можете самостійно вказати директорію через іконку папки, щоб швидко відкрити її у Finder.
- Additional Parameters (додаткові параметри): Просунута зона налаштувань. Можна додавати інші параметри запуску MongoDB, наприклад, для активації авторизації додайте --auth.

Крок 3: Запуск сервісу MongoDB

Після завершення налаштувань обов’язково натисніть кнопку Save (Зберегти) у правому нижньому куті.
Поверніться на сторінку Пакети (Packages), знайдіть потрібну версію MongoDB і натисніть сірий перемикач, щоб запустити сервіс.
Коли він позеленіє і статусний індикатор засвітиться — ваша інстанція MongoDB успішно запущена та готова до підключення.

2. Інтерактивне керування: майстерність у MongoDB Shell (`mongosh`)

mongosh — це нова офіційна командна оболонка MongoDB з підсвіткою синтаксису, автодоповненням, історією команд і можливістю розширення скриптами. Це ідеальний інструмент для взаємодії з базою.

Встановлення MongoDB Shell

У ServBay mongosh представлено як окремий пакет — встановіть його за потреби:

На сторінці Пакети (Packages) знайдіть MongoDB Shell.
Натисніть кнопку інсталяції справа. Після встановлення команда mongosh буде доступна у керованому термінальному середовищі ServBay.

Як користуватись `mongosh`

Використовуйте mongosh з будь-якого терміналу, що працює у середовищі ServBay (наприклад, стандартний термінал macOS або iTerm2).

Базове підключення: Відкрийте термінал і просто введіть команду для з’єднання з локальною інстанцією MongoDB на порту 27017:
bash
```
mongosh
```
1
Альтернативно можна явно вказати рядок підключення:
bash
```
mongosh "mongodb://127.0.0.1:27017"
```
1

Видовищне інтерактивне керування (CRUD-практика): Після успішного підключення ви потрапите у потужний інтерактивний JavaScript-режим. Розглянемо це на практичному прикладі.

Крок 1: Вибір або створення бази даних

javascript

// Ця команда перемикає на базу servbay-demo. Якщо вона ще не існує — буде створена при першому записі.
use servbay-demo

Крок 2: Створення колекції та вставка даних (Create)

javascript

// Вставити одного користувача
db.users.insertOne({
  _id: 1,
  name: "Alice",
  email: "alice@servbay.demo",
  age: 30,
  tags: ["developer", "php", "backend"],
  joined_date: new Date("2023-01-15")
})

// Вставити одразу кілька користувачів для більш різноманітних запитів
db.users.insertMany([
  { _id: 2, name: "Bob", email: "bob@servbay.demo", age: 25, tags: ["designer", "ui", "frontend"] },
  { _id: 3, name: "Charlie", email: "charlie@servbay.demo", age: 35, tags: ["developer", "python", "data"] },
  { _id: 4, name: "Diana", email: "diana@servbay.demo", age: 29, tags: ["developer", "nodejs", "backend"] }
])

Крок 3: Читання даних (Read)

javascript

// Вивести всі документи колекції у зручному форматі через .pretty()
db.users.find().pretty()

// Умовний запит: знайти всіх розробників віком понад 28 років
db.users.find({ age: { $gt: 28 }, tags: "developer" })

// Повернути лише певні поля: лише ім’я й email
db.users.find({}, { name: 1, email: 1, _id: 0 })

Крок 4: Оновлення даних (Update)

javascript

// Оновити один документ: додати Alice тег 'lead' і оновити вік
db.users.updateOne(
  { name: "Alice" },
  { $set: { age: 31 }, $addToSet: { tags: "lead" } } // $addToSet гарантує відсутність дублікатів тегів
)

// Оновити декілька документів: усім розробникам 'backend' додати статус 'active'
db.users.updateMany(
  { tags: "backend" },
  { $set: { status: "active" } }
)

Крок 5: Видалення даних (Delete)

javascript

// Видалити одного користувача
db.users.deleteOne({ name: "Bob" })

// Перевірити результат видалення
db.users.find({ name: "Bob" }).count() // Має повернути 0

3. Моніторинг та керування в реальному часі: освоюємо інструменти MongoDB

ServBay також інтегрує пакет MongoDB Database Tools, котрий містить mongostat, mongotop, mongodump та mongorestore для розширеного адміністрування й підтримки.

Встановлення MongoDB Database Tools

Відкрийте сторінку Пакети (Packages) та знайдіть MongoDB Database Tools.
Натисніть кнопку встановлення.

3.1 Використання `mongostat` для моніторингу статусу в реальному часі

mongostat — це як “електрокардіограма” для MongoDB: він з частою частотою показує ключові метрики роботи серверу. Це ідеальний інструмент для виявлення вузьких місць та моніторингу навантаження.

Основне використання: Відкрийте новий термінал і запустіть:
bash
```
mongostat
```
1
Ви побачите подібний приклад виводу, де кожен рядок — знімок у часі:
```
insert query update delete getmore command dirty  used flushes vsize   res qrw arw net_in net_out conn                time
   *0    *0     *0     *0       0     1|0  0.0% 23.2%       0 1.29G 84.0M 0|0 1|0   103b    501b    4 Nov 26 15:30:00.001
   *0    *0     *0     *0       0     1|0  0.0% 23.2%       0 1.29G 84.0M 0|0 1|0    71b    501b    4 Nov 26 15:30:01.001
```
1
2
3
Пояснення ключових колонок:
- insert, query, update, delete: Кількість відповідних операцій за секунду.
- dirty: Відсоток "брудних" даних у кеші (змінені, але ще не записані на диск).
- used: Відсоток використання кешу рушієм зберігання.
- vsize, res: Використання віртуальної та резидентної пам’яті.
- qrw, arw: К-сть клієнтів, що чекають на читання/запис у черзі.
- net_in, net_out: Об’єм вхідного/вихідного мережевого трафіку.
- conn: Кількість поточних підключень.
Практичний кейс: як відслідкувати високе навантаження на запис
1. У першому терміналі (Термінал A), підключіться через mongosh і запустіть скрипт для симуляції інтенсивного запису логів:
  javascript
```
// Запускати у mongosh
use log_system
print("Starting high-frequency log insertion...")
while (true) {
  db.app_logs.insertOne({ level: "INFO", message: "User activity detected.", timestamp: new Date() });
  sleep(50); // Писати новий лог кожні 50 мс (20 разів на секунду)
}
```
  1
  2
  3
  4
  5
  6
  7
2. У другому терміналі (Термінал B) запустіть mongostat з інтервалом 2 секунди для агрегованих даних:
  bash
```
mongostat 2
```
  1
3. Слідкуйте за виводом Терміналу B: у колонці insert ви побачите число приблизно *40 (20 вставок × 2 секунди), що одразу підкаже про характер навантаження.

3.2 Використання `mongotop` для відстеження часу читання/запису по колекціях

Якщо mongostat показує, що "база перевантажена", то mongotop допоможе дізнатись, "яка колекція створює це навантаження". Він показує, скільки часу витрачається на операції читання/запису в кожну колекцію.

Основне використання: Просто запустіть у терміналі:
bash
```
mongotop
```
1
Приклад виводу:
```
ns						total		read		write			time
local.oplog.rs   		1101ms		155ms		946ms			Nov 26 15:35:00.000
servbay-app.sessions	210ms		1ms			209ms			Nov 26 15:35:00.000
servbay-app.articles	15ms		15ms		0ms				Nov 26 15:35:00.000
```
1
2
3
4
Колонки:
- ns: Простір імен (ім'я_бази.колекція).
- total: Загальний час, витрачений на читання та запис.
- read: Час операцій читання.
- write: Час операцій запису.
Практичний кейс: визначаємо гарячі колекції додатка
1. У терміналі A (mongosh) змоделюйте часте оновлення сесій користувачів і періодичне читання статей:
  javascript
```
// Запускати у mongosh
use servbay_app
print("Simulating application load...")
// Часта зміна сесій
setInterval(() => {
  db.sessions.updateOne({ sid: "session_abc" }, { $set: { data: Math.random() } }, { upsert: true });
}, 50); // Кожні 50 мс

// Зрідка читати статті
setInterval(() => {
  db.articles.find({ tags: "featured" }).limit(5).toArray();
}, 500); // Кожні 500 мс
```
  1
  2
  3
  4
  5
  6
  7
  8
  9
  10
  11
  12
2. У терміналі B запустіть mongotop з 5-секундним інтервалом:
  bash
```
mongotop 5
```
  1
3. Уважно слідкуйте за виводом: servbay_app.sessions буде мати високий write та total, а servbay_app.articles — низький read. Це вкаже, що "гарячою" є колекція сесій, можливо потрібно оптимізувати її використання.

3.3 Використання `mongodump` для резервного копіювання

mongodump — надійний інструмент для створення бінарних (BSON) бекапів MongoDB.

Бекап однієї бази:

bash

mongodump --db servbay-demo --out /Applications/ServBay/backup/mongodb/servbay-demo-backup-$(date +%F)

Бекап однієї колекції:

bash

mongodump --db servbay-demo --collection users --out /Applications/ServBay/backup/mongodb/users-backup

Повний бекап всієї інстанції MongoDB:

bash

mongodump --out /Applications/ServBay/backup/mongodb/full-instance-backup

3.4 Використання `mongorestore` для відновлення даних

mongorestore імпортує дані з резервних копій, створених через mongodump.

Відновлення окремої бази:

bash

# Параметр --drop очистить колекції перед відновленням, щоб уникнути дублювання
mongorestore --drop --db servbay-demo /Applications/ServBay/backup/mongodb/servbay-demo-backup-2023-11-26/servbay-demo/

Відновлення колекції у нову колекцію:

bash

mongorestore --db servbay-demo --collection users_restored /Applications/ServBay/backup/mongodb/users-backup/users.bson

4. Підключення графічних інструментів (GUI)

Окрім командного рядка, ви можете підключати та керувати MongoDB у ServBay через будь-який популярний графічний клієнт. Це зручно для візуального перегляду даних та побудови агрегаційних запитів. Рекомендуємо такі рішення: MongoDB Compass, TablePlus чи Studio 3T.

Для підключення вказуйте такі налаштування у вашому GUI:

Host (Хост): 127.0.0.1
Port (Порт): 27017
Authentication (Автентифікація): Якщо ви не активували авторизацію (--auth) й не створювали користувачів — залишіть порожнім.

Висновок

ServBay ідеально поєднує потужність MongoDB з елегантністю macOS, надаючи розробникам неймовірно зручне локальне середовище. Оволодівши цим гідом, ви навчилися не лише запускати MongoDB за лічені хвилини, а й глибоко керувати нею через mongosh, отримувати професійний моніторинг за допомогою mongostat та mongotop, а також забезпечувати надійне резервне копіювання й відновлення через mongodump та mongorestore. Тепер ви повністю готові впевнено використовувати MongoDB у вашому наступному проєкті!

Інсталяція та керування базою даних MongoDB у ServBay ​

Огляд: Чому використовувати MongoDB у ServBay? ​

1. Інсталяція й налаштування сервісу MongoDB ​

Крок 1: Встановлення пакету MongoDB ​

Крок 2: Детальне налаштування сервісу MongoDB ​

Крок 3: Запуск сервісу MongoDB ​

2. Інтерактивне керування: майстерність у MongoDB Shell (mongosh) ​

Встановлення MongoDB Shell ​

Як користуватись mongosh ​

3. Моніторинг та керування в реальному часі: освоюємо інструменти MongoDB ​

Встановлення MongoDB Database Tools ​

3.1 Використання mongostat для моніторингу статусу в реальному часі ​

3.2 Використання mongotop для відстеження часу читання/запису по колекціях ​

3.3 Використання mongodump для резервного копіювання ​

3.4 Використання mongorestore для відновлення даних ​

4. Підключення графічних інструментів (GUI) ​

Висновок ​

Інсталяція та керування базою даних MongoDB у ServBay

Огляд: Чому використовувати MongoDB у ServBay?

1. Інсталяція й налаштування сервісу MongoDB

Крок 1: Встановлення пакету MongoDB

Крок 2: Детальне налаштування сервісу MongoDB

Крок 3: Запуск сервісу MongoDB

2. Інтерактивне керування: майстерність у MongoDB Shell (`mongosh`)

Встановлення MongoDB Shell

Як користуватись `mongosh`

3. Моніторинг та керування в реальному часі: освоюємо інструменти MongoDB

Встановлення MongoDB Database Tools

3.1 Використання `mongostat` для моніторингу статусу в реальному часі

3.2 Використання `mongotop` для відстеження часу читання/запису по колекціях

3.3 Використання `mongodump` для резервного копіювання

3.4 Використання `mongorestore` для відновлення даних

4. Підключення графічних інструментів (GUI)

Висновок