22.4.3 Documents and Collections — MySQL 9.2

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

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

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