4.3.1 Collection.add()

Функция Collection.add() предназначена для хранения документов в коллекции, аналогично инструкции для базы данных SQL. Она принимает в качестве аргумента один документ или список документов и выполняется функцией execute().

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

Следующий пример демонстрирует использование функции Collection.add(). Пример предполагает, что схема test существует, и что коллекция 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 для синтаксиса add() в EBNF.