4.2.2 Working with Existing Collections — MySQL Connectors 1.0

4.2.2 Работа с существующими коллекциями

Для получения объекта Collection для существующей коллекции, хранящейся в базе данных, вызовите функцию getCollection() из объекта Schema.

Если коллекция еще не существует в базе данных, любой последующий вызов функции объекта Collection вызывает ошибку; для некоторых подключений вы можете предотвратить это и перехватить ошибку прямо при получении Collection, установив поле validateExistence в значение true и передав его в качестве второго параметра функции db.getCollection().

Код JavaScript MySQL Shell

// Get a collection object for 'my_collection'
var myColl = db.getCollection('my_collection');

Код Python MySQL Shell

# Get a collection object for 'my_collection'
myColl = db.get_collection('my_collection')

Код JavaScript Node.js

// Get a collection object for 'my_collection'
var collection = db.getCollection('my_collection');

Код C#

// Get a collection object for "my_collection"
var myColl = db.GetCollection("my_collection");

// Get a collection object but also ensure it exists in the database
var myColl2 = db.GetCollection("my_collection", ValidateExistence: true);

Код Python

# Get a collection object for 'my_collection'
my_coll = my_schema.get_collection('my_collection')
# Get a collection object but also ensure it exists in the database
my_coll = my_schema.get_collection('my_collection', True)

Код Java

// Get a collection object for 'my_collection'
Collection myColl = db.getCollection("my_collection");

// Get a collection object but also ensure it exists in the database
// Second parameter is: boolean requireExists
Collection myColl = db.getCollection("my_collection", true);

Код C++

// Get a collection object for 'my_collection'
Collection myColl = db.getCollection("my_collection");

// Get a collection object but also ensure it exists in the database
Collection myColl = db.getCollection("my_collection", true);

Поле createCollection(), вместе с полем ReuseExistingObject, установленным в значение true, можно использовать для создания новой коллекции или повторного использования существующей коллекции с заданным именем. Подробности см. в разделе 4.2.1 «Создание коллекции».

Примечание

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