2dsphere 指标_MonogDB 中文网

参考 > 指标 > 2dsphere 指标

在本页面

总览
版本号
注意事项
创建2dsphere索引

概述¶

一个2dsphere指数支持在查询一个类似地球的球体上计算的几何形状。2dsphere索引支持所有MongoDB地理空间查询：包含，相交和邻近度查询。有关地理空间查询的更多信息，请参见地理空间查询。

所述2dsphere索引支持数据存储为以GeoJSON对象和遗留坐标对（也参见2dsphere索引字段限制）。对于旧式坐标对，索引会将数据转换为GeoJSON Point。

版本¶

`2dsphere` 索引版本	描述
版本3	MongoDB 3.2引入了`2dsphere`索引的第3版。版本3是`2dsphere`在MongoDB 3.2和更高版本中创建的索引的默认版本。
版本2	MongoDB 2.6引入了`2dsphere`索引的版本2 。版本2是`2dsphere`在MongoDB 2.6和3.0系列中创建的索引的默认版本。

要覆盖默认版本并指定其他版本，请在创建索引时包括该选项。{ "2dsphereIndexVersion": <version> }

`sparse`属性¶

版本2和更高版本的2dsphere索引始终是稀疏的，并且忽略稀疏选项。如果文档缺少2dsphere索引字段（或者该字段是null或为空数组），则MongoDB不会将文档条目添加到索引中。对于插入，MongoDB插入文档但不添加到2dsphere索引中。

对于包含2dsphere索引键和其他类型的键的复合索引，只有2dsphere索引字段才能确定索引是否引用文档。

MongoDB的早期版本仅支持索引。索引默认情况下不稀疏，并且将拒绝带有位置字段的文档。2dsphere (Version 1)2dsphere (Version 1)null

其他GeoJSON对象¶

版本2和更高版本的2dsphere索引包括对其他GeoJSON对象的支持：MultiPoint，MultiLineString， MultiPolygon和GeometryCollection。有关所有受支持的GeoJSON对象的详细信息，请参见GeoJSON对象。

注意事项¶

`geoNear`和`$geoNear`限制¶

从MongoDB 4.0开始，您可以key在$geoNear管道阶段指定一个选项以指示要使用的索引字段路径。这允许将$geoNear舞台用于具有多个2dsphere索引和/或多个 2d索引的集合：

如果您的集合具有多个2dsphere索引和/或多个 2d索引，则必须使用该key选项来指定要使用的索引字段路径。
如果不指定key，则不能有多个 2dsphere索引和/或多个2d索引，因为如果没有使用key，则在多个2d索引或 2dsphere索引中选择的索引是不明确的。

注意

如果您未指定key，并且最多只有一个 2dsphere索引索引和/或只有一个2dsphere索引索引，则MongoDB首先会寻找2d要使用的索引。如果2d索引不存在，则MongoDB查找2dsphere要使用的索引。

分片键限制¶

分片集合时，不能将2dsphere索引用作分片键。但是，可以通过使用其他字段作为分片键在分片集合上创建地理空间索引。

`2dsphere`索引字段限制¶

具有2dsphere索引的字段必须以坐标对或GeoJSON数据的形式保存几何数据。如果您尝试在2dsphere索引字段中插入包含非几何数据的文档，或者 2dsphere在索引字段包含非几何数据的集合上建立索引，则该操作将失败。

创建`2dsphere`索引¶

要创建2dsphere索引，请使用 db.collection.createIndex()方法并指定字符串文字"2dsphere"作为索引类型：

复制

db.collection.createIndex( { <location field> : "2dsphere" } )

其中，是一个字段，其值可以是 GeoJSON对象或旧式坐标对。<location field>

与可以引用一个位置字段和另一个位置字段的复合2d索引不同，复合 2dsphere索引可以引用多个位置字段和非位置字段。

对于以下示例，请考虑一个places包含文档的集合，该文档将位置数据作为GeoJSON Point存储在名为的字段中loc：

复制

db.places.insert(
   {
      loc : { type: "Point", coordinates: [ -73.97, 40.77 ] },
      name: "Central Park",
      category : "Parks"
   }
)

db.places.insert(
   {
      loc : { type: "Point", coordinates: [ -73.88, 40.78 ] },
      name: "La Guardia Airport",
      category : "Airport"
   }
)

创建`2dsphere`索引¶

以下操作在location字段上创建2dsphere索引loc：

复制

db.places.createIndex( { loc : "2dsphere" } )

创建一个复合索引`2dsphere`索引键¶

阿化合物索引可包括 2dsphere与非地理空间索引键组合索引键。例如，以下操作将创建一个复合索引，其中第一个键loc是2dsphere索引键，其余键category和names是非地理空间索引键，分别是降序（-1）和升序（1）。

复制

db.places.createIndex( { loc : "2dsphere" , category : -1, name: 1 } )

与2d索引不同，复合2dsphere索引不需要将location字段作为第一个索引字段。例如：

复制

db.places.createIndex( { category : 1 , loc : "2dsphere" } )

MongoDB 中文手册

2dsphere 指标

概述¶

版本¶

sparse属性¶

其他GeoJSON对象¶

注意事项¶

geoNear和$geoNear限制¶

分片键限制¶

2dsphere索引字段限制¶

创建2dsphere索引¶

创建2dsphere索引¶

创建一个复合索引2dsphere索引键¶

`sparse`属性¶

`geoNear`和`$geoNear`限制¶

`2dsphere`索引字段限制¶

创建`2dsphere`索引¶

创建`2dsphere`索引¶

创建一个复合索引`2dsphere`索引键¶