$elemMatch

语法

  1. { <字段名1>: { $elemMatch: <表达式1> }, <字段名2>: { $elemMatch: <表达式2> }, ... }

描述

返回数组内满足条件的元素的集合，或者嵌套对象中满足条件的子对象。

其中“<表达式>”可以是值，也可以是带有匹配符的表达式，“$elemMatch”匹配符支持多层嵌套。

示例

在集合 foo.bar 插入 3 条记录，两条是数组类型，一条是嵌套对象类型

  1. > db.foo.bar.insert( { "_id": 1, "class": 1, "students": [ { "name": "ZhangSan", "age": 18 }, { "name": "LiSi", "age": 19 }, { "name": "WangErmazi", "age": 18 } ] } )
  2. > db.foo.bar.insert( { "_id": 2, "class": 2, "students": { "name": "LinWu", "age": 18 } } )
  3. > db.foo.bar.insert( { "_id": 3, "class": 3, "students": [ { "name": "ZhangSan", "age": 18, course: [ { math: 1 }, { english: 0 } ] }, { "name": "LiSi", "age": 19, course: [ { math: 1 }, { english: 1 } ] }, { "name": "WangErmazi", "age": 18, course: [ { math: 0 }, { english: 0 } ] } ] } )
  4. > db.foo.bar.find()
  5. {
  6.   "_id": 1,
  7.   "class": 1,
  8.   "students": [
  9.     {
  10.       "name": "ZhangSan",
  11.       "age": 18
  12.     },
  13.     {
  14.       "name": "LiSi",
  15.       "age": 19
  16.     },
  17.     {
  18.       "name": "WangErmazi",
  19.       "age": 18
  20.     }
  21.   ]
  22. }
  23. {
  24.   "_id": 2,
  25.   "class": 2,
  26.   "students": {
  27.     "name": "LinWu",
  28.     "age": 18
  29.   }
  30. }
  31. {
  32.   "_id": 3,
  33.   "class": 3,
  34.   "students": [
  35.     {
  36.       "name": "ZhangSan",
  37.       "age": 18,
  38.       "course": [
  39.         {
  40.           "math": 1
  41.         },
  42.         {
  43.           "english": 0
  44.         }
  45.       ]
  46.     },
  47.     {
  48.       "name": "LiSi",
  49.       "age": 19,
  50.       "course": [
  51.         {
  52.           "math": 1
  53.         },
  54.         {
  55.           "english": 1
  56.         }
  57.       ]
  58.     },
  59.     {
  60.       "name": "WangErmazi",
  61.       "age": 18,
  62.       "course": [
  63.         {
  64.           "math": 0
  65.         },
  66.         {
  67.           "english": 0
  68.         }
  69.       ]
  70.     }
  71.   ]
  72. }
  73. Return 3 row(s).

SequoiaDB shell 运行如下：

  • 指定返回“age”等于 18 的元素：

    1. > db.foo.bar.find( {}, { "students": { "$elemMatch": { "age": 18 } } } )
    2. {
    3.   "_id": 1,
    4.   "class": 1,
    5.   "students": [
    6.     {
    7.       "name": "ZhangSan",
    8.       "age": 18
    9.     },
    10.     {
    11.       "name": "WangErmazi",
    12.       "age": 18
    13.     }
    14.   ]
    15. }
    16. {
    17.   "_id": 2,
    18.   "class": 2,
    19.   "students": {
    20.     "name": "LinWu",
    21.     "age": 18
    22.   }
    23. }
    24. {
    25.   "_id": 3,
    26.   "class": 3,
    27.   "students": [
    28.     {
    29.       "name": "ZhangSan",
    30.       "age": 18,
    31.       "course": [
    32.         {
    33.           "math": 1
    34.         },
    35.         {
    36.           "english": 0
    37.         }
    38.       ]
    39.     },
    40.     {
    41.       "name": "WangErmazi",
    42.       "age": 18,
    43.       "course": [
    44.         {
    45.           "math": 0
    46.         },
    47.         {
    48.           "english": 0
    49.         }
    50.       ]
    51.     }
    52.   ]
    53. }
    54. Return 3 row(s).

  • 指定返回“age”大于 18 的元素，使用“$gt”表达式：

    1. > db.foo.bar.find( { "class": 1 }, { "students": { "$elemMatch": { "age": { $gt: 18 } } } } )
    2. {
    3.   "_id": 1,
    4.   "class": 1,
    5.   "students": [
    6.     {
    7.       "name": "LiSi",
    8.       "age": 19
    9.     }
    10.   ]
    11. }
    12. Return 1 row(s).

  • 指定返回姓“Wang”的元素，使用“$regex”表达式：

    1. > db.foo.bar.find( { "class": 1 }, { "students": { "$elemMatch": { "name": { $regex: "^Wang.*" } } } } )
    2. {
    3.   "_id": 1,
    4.   "class": 1,
    5.   "students": [
    6.     {
    7.       "name": "WangErmazi",
    8.       "age": 18
    9.     }
    10.   ]
    11. }
    12. Return 1 row(s).

  • 指定返回 3 班学生数组中选择了数学的元素，使用嵌套的“$elemMatch”表达式：

    1. > db.foo.bar.find( { class: 3 }, { students: { $elemMatch: { course: { $elemMatch: { math: 1 } } } } } )
    2. {
    3. "_id": 3,
    4. "class": 3,
    5. "students": [
    6. {
    7.   "name": "ZhangSan",
    8.   "age": 18,
    9.   "course": [
    10.     {
    11.       "math": 1
    12.     },
    13.     {
    14.       "english": 0
    15.     }
    16.   ]
    17. },
    18. {
    19.   "name": "LiSi",
    20.   "age": 19,
    21.   "course": [
    22.     {
    23.       "math": 1
    24.     },
    25.     {
    26.       "english": 1
    27.     }
    28.   ]
    29. }
    30. ]
    31. }
    32. Return 1 row(s).