MongoDB Atlas からデータを読み取る - 関数

データモデル

このページの例では、オンライン ストアで購入可能なさまざまなアイテムをモデル化した store.itemsという名前のコレクションを使用します。 各アイテムにはname 、在庫quantity 、カスタマーの配列reviewsがあります。

{
  "title": "Item",
  "required": ["_id", "name", "quantity", "reviews"],
  "properties": {
    "_id": { "bsonType": "objectId" },
    "name": { "bsonType": "string" },
    "quantity": { "bsonType": "int" },
    "reviews": {
      "bsonType": "array",
      "items": {
        "bsonType": "object",
        "required": ["username", "comment"],
        "properties": {
          "username": { "bsonType": "string" },
          "comment": { "bsonType": "string" }
        }
      }
    }
  }
}

スニペットのセットアップ

関数でコード スニペットを使用するには、まず MongoDB コレクション ハンドルをインスタンス化する必要があります。

exports = function() {
  const mongodb = context.services.get("mongodb-atlas");
  const itemsCollection = mongodb.db("store").collection("items");
  const purchasesCollection = mongodb.db("store").collection("purchases");
  // ... paste snippet here ...
}

単一ドキュメントの検索（findOne() ）

collection.findOne()メソッドを使用して単一のドキュメントを見つけることができます。

次の 関数 スニペットは、items コレクションから、quantity 25が 以上のドキュメントを 1 つ検索します。

const query = { "quantity": { "$gte": 25 } };
const projection = {
 "title": 1,
 "quantity": 1,
}
return itemsCollection.findOne(query, projection)
  .then(result => {
    if(result) {
      console.log(`Successfully found document: ${result}.`);
    } else {
      console.log("No document matches the provided query.");
    }
    return result;
  })
  .catch(err => console.error(`Failed to find document: ${err}`));

1 つ以上のドキュメントを検索する（find() ）

collection.find()メソッドを使用して複数のドキュメントを見つけることができます。

次の関数スニペットは、 itemsコレクション内で少なくとも 1 件のレビューがあるすべてのドキュメントを検索し、 _idフィールドを省略してnameでソートされて返します。

const query = { "reviews.0": { "$exists": true } };
const projection = { "_id": 0 };
return itemsCollection.find(query, projection)
  .sort({ name: 1 })
  .toArray()
  .then(items => {
    console.log(`Successfully found ${items.length} documents.`)
    items.forEach(console.log)
    return items
  })
  .catch(err => console.error(`Failed to find documents: ${err}`))

コレクション内のドキュメントをカウントする（count() ）

collection.count()メソッドを使用してコレクション内のドキュメントをカウントできます。 どのドキュメントをカウントするかを制御するクエリを指定できます。 クエリを指定しない場合、 メソッドはコレクション内のすべてのドキュメントをカウントします。

次の関数スニペットは、 itemsコレクション内の少なくとも 1 件のレビューがあるドキュメントの数をカウントします。

return itemsCollection.count({ "reviews.0": { "$exists": true } })
  .then(numDocs => console.log(`${numDocs} items have a review.`))
  .catch(err => console.error("Failed to count documents: ", err))

ドキュメント ID による検索

コレクションをクエリして、指定された ID を持つドキュメントを検索できます。 MongoDB は、各ドキュメントの ID をドキュメントの_idフィールドにObjectId値として自動的に保存します。

{ "_id": <ObjectId> }

{ "_id": BSON.ObjectId("5ad84b81b8b998278f773c1b") }

日付で検索

コレクションをクエリして、特定の日付値を持つフィールドを持つドキュメントを検索したり、日付の範囲内のドキュメントをクエリしたりできます。

{ "<Date Field Name>": <Date | Expression> }

{ "createdAt": new Date("2019-01-23T05:00:00.000Z") }

{
  "createdAt": {
    "$gte": new Date("2019-01-01T00:00:00.000Z"),
    "$lt": new Date("2020-01-01T00:00:00.000Z"),
  }
}

ルート レベル フィールドの一致

各ドキュメントのルートレベル フィールドの値に基づいて、コレクションをクエリできます。 MongoDB が各ドキュメントに対して評価する特定の値またはネストされた式のいずれかを指定できます。

詳細については、MongoDB Server マニュアルの「クエリ ドキュメント 」チュートリアルを参照してください。

{ "<Field Name>": <Value | Expression> }

{ "name": "Basketball" }

複数のフィールドに一致

1 つのクエリ ドキュメントに複数のクエリ条件を指定できます。 クエリ ドキュメントの各ルート レベル フィールドは、 コレクション内のフィールドにマップされます。 MongoDB は、すべてのクエリ条件を満たすドキュメントのみを返します。

詳細については、 マニュアルの 「 埋め込み/ネストされたドキュメントへのクエリMongoDB Server 」 チュートリアルを参照してください。

{
  "<Field Name 1>": <Value | Expression>,
  "<Field Name 2>": <Value | Expression>
}

{
  "name": "Basketball",
  "quantity": { "$gt": 0 }
}

埋め込みドキュメント フィールドへの一致

埋め込みドキュメント フィールドの値に基づいてコレクションをクエリできます。 埋め込みドキュメントフィールドを指定するには、複数のネストされたクエリ式または標準ドキュメントドット表記 を使用します。

詳細については、 マニュアルの 「 埋め込み/ネストされたドキュメントへのクエリMongoDB Server 」 チュートリアルを参照してください。

{ "<Field Name>": { "<Nested Field Name>": <Value | Expression> } }

{ "<Field Name>.<Nested Field Name>": <Value | Expression> }

{
  "reviews.0.username": "JoeMango"
}

値の配列の一致

配列フィールドに含まれるすべての要素に基づいてコレクションをクエリできます。

配列フィールドで特定の値の配列をクエリすると、MongoDB は、配列フィールドが指定された値の配列と完全に一致するドキュメントを返します。 MongoDB が配列フィールド に指定された値の配列内のすべての要素を含むドキュメントを返す場合は、 $all演算子を使用します。

詳細については、 マニュアルの「 配列のクエリMongoDB Server 」チュートリアルを参照してください。

{ "<Array Field Name>": [<Value>, ...] }

{
  "reviews": [{ username: "JoeMango", comment: "This rocks!" }]
}

{
  "reviews": {
    "$all": [{ username: "JoeMango", comment: "This rocks!" }]
  }
}

配列要素の一致

配列フィールド内の 1 つ以上の要素の値に基づいて、コレクションをクエリできます。

複数の条件を持つクエリ式で配列フィールドをクエリすると、MongoDB は配列の要素の任意の組み合わせが式を満たすドキュメントを返します。 1 つの配列要素がすべての式条件を満たすドキュメントを MongoDB が返す場合は、 $elemMatch演算子を使用します。

詳細については、 マニュアルの「 配列のクエリMongoDB Server 」チュートリアルを参照してください。

{ "<Array Field Name>": <Value | Expression> }

{
  "reviews": {
    "username": "JoeMango",
    "comment": "This is a great product!"
  }
}

{
  "reviews": {
    "$elemMatch": {
      "username": "JoeMango",
      "comment": "This is a great product!"
    }
  }
}

Compare Values

比較演算子を使用して、ドキュメント フィールドの値を別の値と比較できます。

{ "<Field Name>": { "<Comparison Operator>": <Comparison Value> } }

次の比較演算子が利用できます。

{
  "quantity": { "$gt": 0, "$lte": 10 }
}

論理式の評価

論理演算子を使用して、単一のフィールドの複数の式を評価できます。

{
  "<Field Name>": {
    "<Logical Operator>": [<Expression>, ...]
  }
}

次の論理演算子が使用できます。

{
  "$or": [
    { "quantity": { "$gt": 0 } },
    { "reviews": { "$size": { "$lte": 5 } } }
  ]
}

正規式を評価する

$regex クエリ演算子を使用すると、 正規表現 に一致するフィールドを含むドキュメントを返すことができます 。$regex EJSON 型のあいまいさを避けるには、 BSON.BSONRegExpオブジェクトを使用する必要があります。

{
  "<Field Name>": {
    "$regex": BSON.BSONRegExp(<RegEx String>, <RegEx Options>)
  }
}

{
  "name": { "$regex": BSON.BSONRegExp(".+ball", "i") }
}