$类型_MonogDB 中文网

MongoDB 中文手册

参考 > 参考 > 经营者 > 查询和投影运算符 > 元素查询运算符 > $类型

在本页面

定义
行为
例子
按数组类型查询
附加信息

定义¶

$type¶

$type选择的文件，其中值的 field是指定的一个实例BSON类型。在处理数据类型不可预测的高度非结构化数据时，按数据类型查询很有用。

甲$type单个表达BSON类型的语法如下：

在版本3.2中更改。

复制

{ field: { $type: <BSON type> } }

您可以为BSON类型指定数字或别名

该$type表达式还可以接受BSON 类型的数组，并具有以下语法：

复制

{ field: { $type: [ <BSON type1> , <BSON type2>, ... ] } }

上面的查询将匹配field值是任何列出的类型的文档。数组中指定的类型可以是数字或字符串别名。

有关示例，请参见按多种数据类型查询。

可用类型描述BSON类型及其对应的数字和字符串别名。

也可以看看

如果要获取运算符表达式返回的BSON类型，而不是按文档的BSON类型过滤文档，请使用聚合运算符。$type

行为¶

$type返回BSON类型field 与传递给的BSON类型匹配的文档$type。

阵列¶

对于文档field为数组的$type文档，返回文档，其中至少一个数组元素与传递给的类型匹配 $type。

查询数组BSON类型¶

在MongoDB 3.6和更高版本中，查询返回的文档中字段本身是数组。在MongoDB 3.6之前的版本中，返回的文档中的字段是一个包含至少一个type类型元素的数组。例如，给定以下文件：$type: "array"$type: "array"array

复制

{ "data" : [ "values", [ "values" ] ] }
{ "data" : [ "values" ] }

在MongoDB 3.6和更高版本中，查询将返回两个文档。在MongoDB 3.6之前，查询仅返回第一个文档。find( {"data" : { $type : "array" } } )

可用类型¶

从MongoDB 3.2开始，$type操作员除了接受与BSON类型相对应的数字外，还接受BSON类型的字符串别名。以前的版本仅接受与BSON类型相对应的数字。[1]

类型	数	别名	笔记
双	1个	“双”
串	2	“串”
宾语	3	“宾语”
数组	4	“数组”
二进制数据	5	“ binData”
未定义	6	“未定义”	不推荐使用。
对象编号	7	“ objectId”
布尔型	8	“布尔”
日期	9	“日期”
空值	10	“空值”
正则表达式	11	“正则表达式”
DBPointer	12	“ dbPointer”	不推荐使用。
的JavaScript	13	“ javascript”
符号	14	“符号”	不推荐使用。
JavaScript（带作用域）	15	“ javascriptWithScope”
32位整数	16	“ int”
时间戳记	17	“时间戳”
64位整数	18岁	“长”
小数128	19	“十进制”	3.4版的新功能。
最小键	-1	“ minKey”
最大键	127	“ maxKey”

$type支持number别名，它将与以下BSON类型匹配：

双
32位整数
64位整数
小数

有关示例，请参见示例。

[1]	从MongoDB 4.2开始，用户不再可以将查询过滤器用作的同义词。要查询空字段或缺少字段，请参阅查询空字段或缺少字段。`$type: 0$exists:false`

MinKey和MaxKey ¶

MinKey和 MaxKey 用于比较操作，主要用于内部使用。对于所有可能的 BSON元素值，MinKey将始终为最小值，而MaxKey始终为最大值。

查询 minKey或maxKey使用$type 只会返回与特殊MinKey或MaxKey值匹配的字段。

假设该data集合有两个文档，MinKey并且具有和MaxKey：

复制

{ "_id" : 1, x : { "$minKey" : 1 } }
{ "_id" : 2, y : { "$maxKey" : 1 } }

以下查询将返回带有以下内容的文档：_id: 1

复制

db.data.find( { x: { $type: "minKey" } } )

以下查询将返回带有以下内容的文档：_id: 2

复制

db.data.find( { y: { $type: "maxKey" } } )

例子¶

按数据类型查询¶

在addressBook包含地址和邮编，在那里 zipCode有string，int，double，和long 值：

复制

db.addressBook.insertMany(
   [
      { "_id" : 1, address : "2030 Martian Way", zipCode : "90698345" },
      { "_id" : 2, address: "156 Lunar Place", zipCode : 43339374 },
      { "_id" : 3, address : "2324 Pluto Place", zipCode: NumberLong(3921412) },
      { "_id" : 4, address : "55 Saturn Ring" , zipCode : NumberInt(88602117) },
      { "_id" : 5, address : "104 Venus Drive", zipCode : ["834847278", "1893289032"]}
   ]
)

以下查询返回的所有文件，其中zipCode是 BSON类型string 或为含有指定的类型的元素的数组：

复制

db.addressBook.find( { "zipCode" : { $type : 2 } } );
db.addressBook.find( { "zipCode" : { $type : "string" } } );

这些查询返回：

复制

{ "_id" : 1, "address" : "2030 Martian Way", "zipCode" : "90698345" }
{ "_id" : 5, address : "104 Venus Drive", zipCOde : ["834847278", "1893289032"]}

以下查询返回的所有文件，其中zipCode是 BSON类型double 或为含有指定的类型的元素的数组：

复制

db.addressBook.find( { "zipCode" : { $type : 1 } } )
db.addressBook.find( { "zipCode" : { $type : "double" } } )

这些查询返回：

复制

{ "_id" : 2, "address" : "156 Lunar Place", "zip" : 43339374 }

以下查询使用的number别名返回文档，其中 zipCode是BSON类型double，int或long 或者是包含指定类型的元素的数组：

复制

db.addressBook.find( { "zipCode" : { $type : "number" } } )

这些查询返回：

复制

{ "_id" : 2, address : "156 Lunar Place", zipCode : 43339374 }
{ "_id" : 3, address : "2324 Pluto Place", zipCode: NumberLong(3921412) }
{ "_id" : 4, address : "55 Saturn Ring" , zipCode : 88602117 }

通过多数据类型查询¶

该grades集合包含名称和平均数，其中 classAverage有string，int和double值：

复制

db.grades.insertMany(
   [
      { "_id" : 1, name : "Alice King" , classAverage : 87.333333333333333 },
      { "_id" : 2, name : "Bob Jenkins", classAverage : "83.52" },
      { "_id" : 3, name : "Cathy Hart", classAverage: "94.06" },
      { "_id" : 4, name : "Drew Williams" , classAverage : 93 }
   ]
)

以下查询返回的所有文件，其中classAverage是 BSON类型string或double 或为含有指定类型的元件的阵列。第一个查询使用数字别名，而第二个查询使用字符串别名。

复制

db.grades.find( { "classAverage" : { $type : [ 2 , 1 ] } } );
db.grades.find( { "classAverage" : { $type : [ "string" , "double" ] } } );

这些查询返回以下文档：

复制

{ "_id" : 1, name : "Alice King" , classAverage : 87.333333333333333 }
{ "_id" : 2, name : "Bob Jenkins", classAverage : "83.52" }
{ "_id" : 3, name : "Cathy Hart", classAverage: "94.06" }

通过MinKey和MaxKey进行查询¶

该restaurants集合使用minKey任何等级是不及格：

复制

{
   "_id": 1,
   "address": {
      "building": "230",
      "coord": [ -73.996089, 40.675018 ],
      "street": "Huntington St",
      "zipcode": "11231"
   },
   "borough": "Brooklyn",
   "cuisine": "Bakery",
   "grades": [
      { "date": new Date(1393804800000), "grade": "C", "score": 15 },
      { "date": new Date(1378857600000), "grade": "C", "score": 16 },
      { "date": new Date(1358985600000), "grade": MinKey(), "score": 30 },
      { "date": new Date(1322006400000), "grade": "C", "score": 15 }
   ],
   "name": "Dirty Dan's Donuts",
   "restaurant_id": "30075445"
}

而maxKey对于任何级别是最高的及格分数：

复制

{
   "_id": 2,
   "address": {
      "building": "1166",
      "coord": [ -73.955184, 40.738589 ],
      "street": "Manhattan Ave",
      "zipcode": "11222"
   },
   "borough": "Brooklyn",
   "cuisine": "Bakery",
   "grades": [
      { "date": new Date(1393804800000), "grade": MaxKey(), "score": 2 },
      { "date": new Date(1378857600000), "grade": "B", "score": 6 },
      { "date": new Date(1358985600000), "grade": MaxKey(), "score": 3 },
      { "date": new Date(1322006400000), "grade": "B", "score": 5 }
   ],
   "name": "Dainty Daisey's Donuts",
   "restaurant_id": "30075449"
}

以下查询返回其grades.grade字段包含minKey 或为包含指定类型的元素的数组的任何餐厅：

复制

db.restaurants.find(
   { "grades.grade" : { $type : "minKey" } }
)

这返回

复制

{
   "_id" : 1,
   "address" : {
      "building" : "230",
      "coord" : [ -73.996089, 40.675018 ],
      "street" : "Huntington St",
      "zipcode" : "11231"
   },
   "borough" : "Brooklyn",
   "cuisine" : "Bakery",
   "grades" : [
      { "date" : ISODate("2014-03-03T00:00:00Z"), "grade" : "C", "score" : 15 },
      { "date" : ISODate("2013-09-11T00:00:00Z"), "grade" : "C", "score" : 16 },
      { "date" : ISODate("2013-01-24T00:00:00Z"), "grade" : { "$minKey" : 1 }, "score" : 30 },
      { "date" : ISODate("2011-11-23T00:00:00Z"), "grade" : "C", "score" : 15 }
   ],
   "name" : "Dirty Dan's Donuts",
   "restaurant_id" : "30075445"
}

以下查询返回其grades.grade字段包含maxKey 或为包含指定类型的元素的数组的任何餐厅：

复制

db.restaurants.find(
   { "grades.grade" : { $type : "maxKey" } }
)

这返回

复制

{
   "_id" : 2,
   "address" : {
      "building" : "1166",
      "coord" : [ -73.955184, 40.738589 ],
      "street" : "Manhattan Ave",
      "zipcode" : "11222"
   },
   "borough" : "Brooklyn",
   "cuisine" : "Bakery",
   "grades" : [
      { "date" : ISODate("2014-03-03T00:00:00Z"), "grade" : { "$maxKey" : 1 }, "score" : 2 },
      { "date" : ISODate("2013-09-11T00:00:00Z"), "grade" : "B", "score" : 6 },
      { "date" : ISODate("2013-01-24T00:00:00Z"), "grade" : { "$maxKey" : 1 }, "score" : 3 },
      { "date" : ISODate("2011-11-23T00:00:00Z"), "grade" : "B", "score" : 5 }
   ],
   "name" : "Dainty Daisey's Donuts",
   "restaurant_id" : "30075449"
}

由数组类型查询¶

名为的集合SensorReading包含以下文档：

复制

{
   "_id": 1,
   "readings": [
      25,
      23,
      [ "Warn: High Temp!", 55 ],
      [ "ERROR: SYSTEM SHUTDOWN!", 66 ]
   ]
},
{
   "_id": 2,
   "readings": [
      25,
      25,
      24,
      23
   ]
},
{
   "_id": 3,
   "readings": [
      22,
      24,
      []
   ]
},
{
   "_id": 4,
   "readings": []
},
{
   "_id": 5,
   "readings": 24
}

以下查询返回readings 字段为空或非空数组的任何文档。

复制

db.SensorReading.find( { "readings" : { $type: "array" } } )

上面的查询返回以下文档：

复制

{
   "_id": 1,
   "readings": [
      25,
      23,
      [ "Warn: High Temp!", 55 ],
      [ "ERROR: SYSTEM SHUTDOWN!", 66 ]
   ]
},
{
   "_id": 2,
   "readings": [
      25,
      25,
      24,
      23
   ]
},
{
   "_id": 3,
   "readings": [
      22,
      24,
      []
   ]
},
{
   "_id": 4,
   "readings": []
}

与文件，，，和，该字段是一个数组。_id : 1_id : 2_id : 3_id : 4readings

MongoDB 中文手册

$类型

定义¶

行为¶

阵列¶

查询数组BSON类型¶

可用类型¶

MinKey和MaxKey ¶

例子¶

按数据类型查询¶

通过多数据类型查询¶

通过MinKey和MaxKey进行查询¶

由数组类型查询¶

其他信息¶