22.3.3 Documents and Collections — MySQL 9.2

22.3.3 Документы и коллекции

При использовании MySQL в качестве хранилища документов, коллекции являются контейнерами в схеме, которые можно создавать, выводить и удалять. Коллекции содержат JSON-документы, которые можно добавлять, искать, обновлять и удалять.

Примеры в этом разделе используют коллекцию countryinfo в схеме world_x. Инструкции по настройке схемы world_x см. в разделе 22.3.2, «Загрузка и импорт базы данных world_x».

Документы

В MySQL документы представлены как JSON-объекты. Внутренне они хранятся в эффективном двоичном формате, что позволяет быстро выполнять поиск и обновления.

Простой формат документа для JavaScript:
```
{field1: "value", field2 : 10, "field 3": null}
```

Массив документов состоит из набора документов, разделенных запятыми и заключенных в символы [ и ].

Простой массив документов для JavaScript:

[{"Name": "Aruba", "Code:": "ABW"}, {"Name": "Angola", "Code:": "AGO"}]

MySQL поддерживает следующие типы значений JavaScript в JSON-документах:

числа (целые и с плавающей точкой)
строки
булевы значения (False и True)
null
массивы других JSON-значений
вложенные (или встроенные) объекты других JSON-значений

Коллекции

Коллекции являются контейнерами для документов, которые имеют общую цель и, возможно, один или несколько индексов. Каждая коллекция имеет уникальное имя и существует в пределах одной схемы.

Термин «схема» эквивалентен базе данных, то есть группе объектов базы данных, в отличие от реляционной схемы, используемой для принудительного соблюдения структуры и ограничений данных. Схема не навязывает соответствие документов в коллекции.

В данном руководстве:

Основные объекты включают:

Форма объекта	Описание
`db`	`db` — это глобальная переменная, назначенная текущей активной схеме. Если требуется выполнить операции со схемой, например, для получения коллекции, используются методы, доступные для переменной `db`.
`db.getCollections()`	db.getCollections() возвращает список коллекций в схеме. Используйте список для получения ссылок на объекты коллекций, перебора их и т. д.

Основные операции, ограниченные коллекциями, включают:

Форма операции	Описание
`db.name.add()`	Метод add() вставляет один документ или список документов в указанную коллекцию.
`db.name.find()`	Метод find() возвращает некоторые или все документы в указанной коллекции.
`db.name.modify()`	Метод modify() обновляет документы в указанной коллекции.
`db.name.remove()`	Метод remove() удаляет один документ или список документов из указанной коллекции.

Связанная информация

См. для общего обзора.
предоставляет полный список операций.