22.3.3 Documents and Collections — MySQL 8.4

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() удаляет один документ или список документов из заданной коллекции.

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

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