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() 的語法。