文档首页
X DevAPI 用户指南
下载本手册
PDF (US Ltr) - 1.4Mb
PDF (A4) - 1.4Mb


X DevAPI 用户指南  /  ...  /  使用现有集合

4.2.2 使用现有集合

要为数据库中存储的现有集合检索集合对象,请从 Schema 对象调用 getCollection() 函数。

如果该集合在数据库中尚不存在,则对集合对象函数的任何后续调用都将引发错误;对于某些连接器,您可以通过将 validateExistence 字段设置为 true 并将其作为第二个参数传递给 db.getCollection(),以防止这种情况并在集合检索时捕获错误。

MySQL Shell JavaScript 代码

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

MySQL Shell Python 代码

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

Node.js JavaScript 代码

// 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() 与设置为 true 的 ReuseExistingObject 字段一起使用,可以创建新集合或重用具有给定名称的现有集合。有关详细信息,请参阅第 4.2.1 节“创建集合”

注意

在大多数情况下,最佳做法是在开发期间创建数据库对象,并避免在数据库项目的生产阶段动态创建它们。因此,最好将数据库中创建集合的代码与实际的用户应用程序代码分开。