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

単一ドキュメントの検索（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 }
}

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

You can query a collection based on the value of embedded document fields. To specify an embedded document field, use multiple nested query expressions or standard document dot notation.

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

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

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

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

値の配列の一致

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

If you query an array field for a specific array of values, MongoDB returns documents where the array field exactly matches the specified array of values. If you want MongoDB to return documents where the array field contains all elements in the specified array of values, use the $all operator.

For more information, see the Query an Array tutorial in the MongoDB Server Manual.

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

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

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

配列要素の一致

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

If you query an array field with a query expression that has multiple conditions, MongoDB returns documents where any combination of the array's elements satisfy the expression. If you want MongoDB to return documents where a single array element satisfies all of the expression conditions, use the $elemMatch operator.

For more information, see the Query an Array tutorial in the MongoDB Server Manual.

{ "<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 型のあいまいさを避けるには、atlas- BSON.BSONRegExpオブジェクト を使用する必要があります。

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

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