MongoDB¶

MongoDB - документоориентированная (NoSQL) СУБД, хранящая все данные в виде объектов JSON. Отличительная особенность таких баз данных - отсутствие реляционных связей и заранее описанных схем таблиц.

Прежде, чем начать, необходимо установить саму MongoDB. Для этого зайдите на официальный сайт MongoDB и следуйте всем указанным на нем инструкциям по установке.

Для работы с MongoDB и Node.js имеется специальный официальный драйвер, который устанавливается через npm.

npm install mongodb --save

Подключение¶

Теперь подключимся к базе.

connection.js

const mongo = require('mongodb').MongoClient

mongo.connect('mongodb://localhost:27017', (err, client) => {
  if (err) {
    console.log('Connection error: ', err)
    throw err
  }

  console.log('Connected')

  client.close()
})

Подключение осуществляется с помощью метода connect() экземпляра MongoClient, который принимает URL, по которому доступна MongoDB (по умолчанию http://127.0.0.1:27017), и callback-функцию, которой передается два параметра:

ошибка подключения (null, если подключение прошло успешно);
экземпляр объекта подключения к MongoDB, через API которого создаются новые БД и осуществляется доступ к уже существующим.

После окончания работы с сервером MongoDB не забывайте закрывать соединение с сервером базы данных.

client.close()

Создание базы данных¶

Для создания/подключения к базе данных используется метод db() экземпляра объекта подключения, который принимает название БД и возвращает объект для выполнения . Если указанная база не существует, то она будет создана.

const db = client.db('db_name')

Физически база данных начинает свое существование только после создания в ней хотя бы одной коллекции (тоже самое, что и таблица в SQL).

Коллекции¶

Коллекции создаются вызовом метода createCollection(), принимающего название коллекции и callback-функцию с ошибкой и результатом в качестве параметров.

const db = client.db('db_name')
const users = db.createCollection('users')

Для удаления коллекции используйте применительно к ней метод drop(), который в качестве аргумента принимает callback-функцию с двумя параметрами:

ошибка (если удаление прошло успешно - null);
объект с успешным результатом.

users.drop((err, result) => {
  if (err) {
    console.log('Unable drop collection: ', err)
    throw err
  }
})

В отличии от базы данных создание и подключение к коллекции осуществляется двумя разными методами.

Создание записи¶

Теперь создадим в коллекции users первую запись.

users.insertOne({ id: 1, login: 'login1', name: 'name1', gender: 'male' }, (err, result) => {
  if (err) {
    console.log('Unable insert user: ', err)
    throw err
  }
})

Чтобы вставить сразу несколько записей имеется метод insertMany().

users.insertMany([{ id: 2, login: 'login2', name: 'name2', gender: 'male' }, { id: 3, login: 'login3', name: 'name3', gender: 'female' }], (err, result) => {
  if (err) {
    console.log('Unable insert user: ', err)
    throw err
  }
})

Получение записи¶

Для получения всех записей в коллекции используйте метод find() экземпляра коллекции.

users.find()

Методу find() в качестве параметра можно передать объект, выполняющий роль фильтра для извлекаемых записей. Например, в следующем примере возвращаются все записи, у которых поле gender равно male.

users.find({ gender: 'male' })

Чтобы получить только первую запись выборки, используйте метод findOne().

users.findOne()
users.findOne({ gender: 'male' })

Для получения n-первых записей имеется метод limit(), принимающий количество возвращаемых записей.

users.find().limit(5)

Сортировка полученного результата осуществляется с помощью метода sort(), который принимает объект, в котором ключ - сортирующее поле, а значение - порядок сортировки (1 - по возрастанию, а -1 - по убыванию).

users.find().sort(1)

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

users.find(
  {},
  {
    limit: 5,
    sort: 1
  }
)

С полным списком параметров можно ознакомиться в официальной документации.

Объединение коллекций¶

Ранее уже упоминалось, что в MongoDB отсутствуют реляционность, тем не менее в ней возможно объединений коллекций по принципу LEFT JOIN в SQL с помощью метода aggregate().

users
  .aggregate([
    {
      $lookup: {
        from: 'rooms',
        localField: 'room_id',
        foreignField: 'id',
        as: 'room_details'
      }
    }
  ])
  .toArray((err, res) => {
    if (err) {
      console.log('Aggregate error: ', err)
      throw err
    }

    console.log(res)
  })

Метод aggregate() принимает массив с описанием объединений с другими коллекциями. Объединение определяется объектом с ключом $lookup, значением для которого служит объект конфигурации со следующими свойствами:

from - название коллекции, с которой происходит слияние;
localField - наименование поля, по которому будет осуществляться объединение с внешней коллекцией;
foreignField - наименование объединяющего поля из внешней коллекции;
as - название поля в текущей коллекции, которое будет содержать данные, полученные в результате слияния.

Обновление записи¶

Обновление записи происходит с помощью метода updateOne(), который принимает условие для записей, которые необходимо обновить, и объект со свойством $set, в значении которого указываются, какие именно поля нужно изменить.

users.updateOne({ id: 1 }, { $set: { gender: 'female' } }, (err, result) => {
  if (err) {
    console.log('Unable update user: ', err)
    throw err
  }
})

Удаление записи¶

За удаление записей отвечают методы deleteOne() и deleteMany().

users.deleteOne({ id: 3 }, (err, result) => {
  if (err) {
    console.log('Unable delete user: ', err)
    throw err
  }
})

Более подробную информацию о возможностях драйвера для Node.js MongoDB можно получить на официальном сайте.