Collection.add() 函数用于在集合中存储文档，类似于 SQL 数据库的 INSERT 语句。它接受单个文档或文档列表作为其参数，并由 execute() 函数执行。

在插入文档之前，需要使用 Schema.createCollection() 函数创建集合。要将文档插入现有集合，请使用 Schema.getCollection() 函数检索集合对象。

以下示例显示了如何使用 Collection.add() 函数。该示例假设测试模式存在，并且集合 my_collection 不存在。

MySQL Shell JavaScript 代码

// Create a new collection
var myColl = db.createCollection('my_collection');

// Insert a document
myColl.add({ name: 'Laurie', age: 19 }).execute();

// Insert several documents at once
myColl.add([
{ name: 'Nadya', age: 54 },
{ name: 'Lukas', age: 32 } ]).execute();

MySQL Shell Python 代码

# Create a new collection
myColl = db.create_collection('my_collection')

# Insert a document
myColl.add({ 'name': 'Laurie', 'age': 19 }).execute()

# Insert several documents at once
myColl.add([
{ 'name': 'Nadya', 'age': 54 },
{ 'name': 'Lukas', 'age': 32 } ]).execute()

Node.js JavaScript 代码

// Create a new collection
db.createCollection('myCollection').then(function (myColl) {
  return Promise.all([
    // Insert a document
    myColl
      .add({ name: 'Laurie', age: 19 })
      .execute(),
    // Insert several documents at once
    myColl
      .add([
        { name: 'Nadya', age: 54 },
        { name: 'Lukas', age: 32 }
      ])
      .execute()
  ])
});

C# 代码

// Assumptions: test schema assigned to db, my_collection collection not exists

// Create a new collection
var myColl = db.CreateCollection("my_collection");

// Insert a document
myColl.Add(new { name = "Laurie", age = 19 }).Execute();

// Insert several documents at once
myColl.Add(new[] {
new { name = "Nadya", age = 54 },
new { name = "Lukas", age = 32 } }).Execute();

Python 代码

# Create a new collection
my_coll = my_schema.create_collection('my_collection')

# Insert a document
my_coll.add({ 'name': 'Laurie', 'age': 19 }).execute()

# Insert several documents at once
my_coll.add([
    { 'name': 'Nadya', 'age': 54 },
    { 'name': 'Lukas', 'age': 32 }
]).execute()

Java 代码

// Create a new collection
Collection coll = db.createCollection("payments");

// Insert a document
coll.add("{ \"name\":\"Laurie\", \"age\":19 }").execute();

// Insert several documents at once
coll.add("{ \"name\":\"Nadya\", \"age\":54 }",
        "{ \"name\":\"Lukas\", \"age\":32 }").execute();

C++ 代码

// Create a new collection
Collection coll = db.createCollection("payments");

// Insert a document
coll.add(R"({ "name":"Laurie", "age":19 })").execute();

// Insert several documents at once
std::list<DbDoc> docs = {
  DbDoc(R"({ "name":"Nadya", "age":54 })"),
  DbDoc(R"({ "name":"Lukas", "age":32 })")
};
coll.add(docs).execute();

另请参阅 CollectionAddFunction，了解 EBNF 中 add() 的语法。