Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

部分索引

部分索引对符合指定筛选条件的集合中的文档编制索引。基于实例的 Amazon DocumentDB 5.0 集群支持部分索引功能。

创建部分索引

要创建部分索引，请使用带partialFilterExpression选项createIndex()的方法。例如，以下操作在 orders 集合中创建一个唯一的复合索引，该索引为字段为 true OrderID 且该isDelivered字段为 true 的文档编制索引：

db.orders.createIndex(
  {"category": 1, "CustomerId": 1, "OrderId": 1}, 
  {"unique": true, "partialFilterExpression": 
    {"$and": [
      {"OrderId": {"$exists": true}}, 
      {"isDelivered": {"$eq": false}}
    ]}
  }
)

支持的运算符

使用部分索引进行查询

使用部分索引可以采用以下查询模式：

部分索引功能

列出部分索引

partialFilterExpression 使用getIndex操作列出部分索引。例如，中发出的getIndex操作列出了带有键、名称和 partialFilterExpressions 字段的部分索引：

db.orders.getIndexes()

此示例返回以下输出：

[
  {
    "v" : 4,
    "key" : {
      "_id" : 1
    },
    "name" : "_id_",
    "ns" : "ecommerceApp.orders"
  },
  {
    "v" : 4,
    "unique" : true,
    "key" : {
      "category" : 1,
      "" : 1,
      "CustomerId" : 1,
      "OrderId" : 1
    },
    "name" : "category_1_CustID_1_OrderId_1",
    "ns" : "ecommerceApp.orders",
    "partialFilterExpression" : {
      "$and" : [
        {"OrderId": {"$exists": true}}, 
        {"isDelivered": {"$eq": false}}
      ]
    }
  }
]

同一个键上的多个部分过滤器表达式:order

可以为相同的字段组合（key: order）创建不同的部分索引。这些索引必须使用不同的名称。

db.orders.createIndex(
  {"OrderId":1},
  {
    name:"firstPartialIndex",
    partialFilterExpression:{"OrderId":{"$exists": true}}
  }
)

db.orders.createIndex(
  {"OrderId":1},
  {
    name:"secondPartialIndex",
    partialFilterExpression:{"OrderId":{"$gt": 1000}}
  }
)

运行getIndexes操作列出集合中的所有索引：

db.orders.getIndexes()

这些示例返回以下输出：

[
  {
    "v" : 4,
    "key" : {
      "_id" : 1
    },
    "name" : "_id_",
    "ns" : "ecommerceApp.orders"
  },
  {
    "v" : 4,
    "key" : {
      "OrderId" : 1
    },
    "name" : "firstPartialIndex",
    "ns" : "ecommerceApp.orders",
    "partialFilterExpression" : {"OrderId":{"$exists": true}}
  },
  {
    "v" : 4,
    "key" : {
      "OrderId" : 1
    },
    "name" : "secondPartialIndex",
    "ns" : "ecommerceApp.orders",
    "partialFilterExpression" : {"OrderId":{"$gt": 1000}}
  }
]

具有部分和 TTL 属性的索引

您还可以通过在索引创建过程中同时指定和expireAfterSeconds选项来创建具有部分partialFilterExpression和 TTL 属性的索引。这使您可以更好地控制现在要从集合中删除哪些文档。

例如，您可能有一个 TTL 索引，用于标识要在特定时间段后删除的文档。现在，您可以使用部分索引选项提供有关何时删除文档的额外条件：

db.orders.createIndex(
    { "OrderTimestamp": 1 },
    {
        expireAfterSeconds: 3600 , 
        partialFilterExpression: { "isDelivered": { $eq: true } } 
    }
)

此示例返回以下输出：

{
        "createdCollectionAutomatically" : false,
        "numIndexesBefore" : 1,
        "numIndexesAfter" : 2,
        "ok" : 1,
        "operationTime" : Timestamp(1234567890, 1)
}

运行getIndexes操作以列出集合中存在的索引：

db.orders.getIndexes()
[
    {
        "v" : 4,
        "key" : {
            "_id" : 1
        },
        "name" : "_id_",
        "ns" : "test.orders"
    }

此示例返回以下输出：

[
    {
        "v": 4,
        "key": {
            "_id": 1
        },
        "name": "_id_",
        "ns": "ecommerceApp.orders"
    },
    {
        "v": 4,
        "key": {
            "OrderTimestamp": 1
        },
        "name": "OrderTimestamp_1",
        "ns": "ecommerceApp.orders",
        "partialFilterExpression": {
            "isDelivered": {
                "$eq": true
            }
        },
        "expireAfterSeconds": 3600
    }
]

部分索引限制

以下限制适用于部分索引功能：