第八章 管理文档 - 映射谓词数组

映射谓词数组

要仅返回返回文档中的部分值，请使用projection。可选的投影谓词 ["prop1","prop2",...] 是一个列出希望返回相应值的键的数组。如果在投影数组中指定用户定义的键，则必须已为该键定义文档属性。

语法 ["property","value","operator"],["prop1","prop2",...] 从匹配文档返回指定的属性。

  SET result = db.%FindDocuments(["firstName","Bill","="],["%DocumentId","firstName"])
  WRITE result.%ToJSON()

可以指定带有或不带有限制谓词的投影。因此以下两者都是有效的语法：

• db.%FindDocuments(["property","value","operator"],[prop1,prop2,...]) 限制和投影。
• db.%FindDocuments(,[prop1,prop2,...]) 无限制，投影。

限制谓词

可以指定限制 key:value 谓词 {"limit":int}，最多仅返回指定数量的匹配文档。

语法 ["property","value","operator"],["prop1","prop2",...],{"limit":int}从指定限制数量的文档中返回指定属性。

  SET result = db.%FindDocuments(["firstName","Bill","="],["%DocumentID","firstName"],{"limit":5})
  WRITE result.%ToJSON()

这最多返回 5 个文档的数据。

可以使用或不使用限制谓词或投影谓词来指定限制。因此以下所有内容都是有效的语法：

• db.%FindDocuments(["property","value","operator"],,{"limit":int}) 限制，无投影，限制。
• db.%FindDocuments(,[prop1,prop2,...],{"limit":int}) 无限制、投影、限制。
• db.%FindDocuments(,,{"limit":int}) 无限制，无投影，限制。

以下示例指定无限制、投影和限制：

  WRITE db.%FindDocuments(,["%DocumentId","lastName"],{"limit":3}).%ToJSON()