Docs 主页 → 开发应用程序 → MongoDB Manual
$type
定义
兼容性
可以使用 $type 查找托管在以下环境中的部署：
MongoDB Atlas ：用于在云中部署 MongoDB 的完全托管服务
MongoDB Enterprise：基于订阅、自我管理的 MongoDB 版本
MongoDB Community：源代码可用、免费使用且可自行管理的 MongoDB 版本
语法
{ field: { $type: <BSON type> } }
您可以指定BSON 类型的编号或别名。
{ field: { $type: [ <BSON type1> , <BSON type2>, ... ] } }
上述查询匹配field值为所列任何类型的文档。数组中指定的类型可以是数字别名，也可以是字符串别名。
有关示例，请参阅按多种数据类型进行查询。
可用类型描述了 BSON 类型及其相应的数字和字符串别名。
提示
另请参阅：
$isNumber— 检查参数是否为数字。$type (Aggregation)— 返回参数的 BSON 类型。
行为
$type会返回field的 BSON 类型与传递给$type的 BSON 类型匹配的文档。
数组
对于field为数组的文档， $type返回其中至少一个数组元素与传递给$type的类型匹配的文档。
对 $type: "array" 的查询会返回字段本身为数组的文档。
可用类型
$type操作符除了接受与 BSON 类型对应的数字之外，还接受 BSON 类型的字符串别名。 [ 1 ]
类型 | 数值 | 别名 | 注意 |
|---|---|---|---|
双精度 | 1 | "double" | |
字符串 | 2 | "string" | |
对象 | 3 | "object" | |
阵列 | 4 | "array" | |
二进制数据 | 5 | "binData" | |
未定义 | 6 | "undefined" | 已弃用。 |
ObjectId | 7 | "objectId" | |
布尔 | 8 | "bool" | |
Date | 9 | "date" | |
null | 10 | "null" | |
正则表达式 | 11 | "regex" | |
数据库指针 | 12 | "dbPointer" | 已弃用。 |
JavaScript | 13 | "javascript" | |
符号 | 14 | "symbol" | 已弃用。 |
32 位整数 | 16 | "int" | |
时间戳 | 17 | "timestamp" | |
64 位整型 | 18 | "long" | |
Decimal128 | 19 | "decimal" | |
最小键值 | -1 | "minKey" | |
Max key | 127 | "maxKey" |
$type支持number别名，该别名与以下BSON类型匹配：
有关示例，请参阅示例。
| [1] | 从 MongoDB 4.2 开始，用户不能再使用查询筛选器 $type: 0 作为 $exists:false 的同义词。要查询空值字段或缺失字段，请参阅《查询空值字段或缺失字段》。 |
提示
另请参阅：
Minkey 和 MaxKey
MinKey和MaxKey用于比较操作，主要供内部使用。对于所有可能的BSON元素值， MinKey始终是最小值，而MaxKey始终是最大值。
使用minKey maxKey$type查询 或 仅返回与特殊MinKey 或MaxKey 值匹配的字段。
假设 data 集合有两个带 MinKey 和 MaxKey 的文档：
db.data.insertMany( [ { _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", zipCode : 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 : NumberInt("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.33333333333333 } { _id : 2, name : "Bob Jenkins", classAverage : "83.52" } { _id : 3, name : "Cathy Hart", classAverage : "94.06" }
按 MinKey 和 MaxKey 进行查询
restaurants 集合使用 minKey 来表示任何不及格的等级：
db.restaurants.insertOne( [ { _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 适用于达到最高及格分数的任一成绩：
db.restaurants.insertOne( [ { _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 的集合包含以下文档：
db.sensorReading.insertMany( [ { _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 : 4的文档中，readings 字段是一个数组。