22.4.3 Documents and Collections — MySQL 8.4

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

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

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

Документы

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

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

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

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

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

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

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

Коллекции

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

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

В данном руководстве по быстрому началу:

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

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

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

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

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

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